API de validación OSCAL

Envía mediante POST un documento OSCAL 1.2.2 JSON y obtén un informe de validación legible por máquina desde el mismo motor que utiliza el validador del navegador, diseñado para canalizaciones de CI, agentes e integraciones. No se necesita una cuenta.

Procesamiento temporal, sin almacenamiento. El documento se valida en memoria en servidores de la UE (Fráncfort) y se descarta con la respuesta. Secani no conserva, registra ni reutiliza su contenido; la telemetría solo contiene datos agregados.

curl -sS -X POST https://secani.com/api/oscal/v1/validate \
  -H "content-type: application/json" \
  --data-binary @system-security-plan.json

Los artefactos grandes se comprimen muy bien. Envíalos con gzip para mantenerte por debajo del límite de transferencia de 4 MB:

gzip -c catalog.json | curl -sS -X POST https://secani.com/api/oscal/v1/validate \
  -H "content-type: application/json" \
  -H "content-encoding: gzip" \
  --data-binary @-

Qué crean los equipos con ella

Controlar las fusiones en CI

Valida los SSP, perfiles y definiciones de componentes del repositorio en cada pull request. Bifurca el flujo según el campo valid y accede directamente a cada problema mediante su JSON Pointer RFC 6901.

Agentes de IA autocorrectivos

Los agentes que generan o editan OSCAL pueden validar en bucle: crear un documento, leer los problemas con punteros precisos, corregirlo y volver a validarlo, sin intervención humana en el ciclo de reparación.

Herramientas de navegador sin backend

CORS está abierto, por lo que las herramientas web internas pueden enviar documentos mediante POST directamente desde el navegador; por ejemplo, para comprobar la definición de componentes entregada por un socio antes de aceptarla.

Cómo funciona el contrato v1

El documento es la solicitud

Envía OSCAL 1.2.2 JSON sin envoltorio mediante POST y sin cuenta. Los ocho modelos se detectan a partir de la clave raíz. Una validación completada siempre devuelve HTTP 200; los documentos no válidos indican valid: false.

Admite documentos grandes

Hasta 4 MB sin comprimir en la transferencia y 24 MB descomprimidos con cuerpos de solicitud gzip. El catálogo completo NIST SP 800-53 se valida en bastante menos de 100 milisegundos.

Todo legible por máquina

Hasta 200 problemas con totales exactos, códigos de error RFC 9457 estables, cabeceras RateLimit y un contrato OpenAPI 3.1 para generar clientes.

Límites anónimos equitativos

10 solicitudes por minuto y 300 al día por cliente, indicadas mediante cabeceras de respuesta RateLimit. Con una clave de API, el límite sube a 120 por minuto y 10.000 al día; el nivel anónimo se mantiene.

De forma predeterminada, la API ejecuta una validación estricta con JSON Schema para OSCAL 1.2.2 y un parche de compatibilidad de perfiles documentado. Con level=full añade comprobaciones de restricciones y referencias, y cada respuesta indica el conjunto exacto de reglas aplicado, de modo que un informe guardado constituye una certificación reproducible.

Preguntas frecuentes sobre la API de validación OSCAL

Valida documentos OSCAL 1.2.2 JSON mediante HTTP. Envía el propio documento como cuerpo de una solicitud POST y recibe un informe legible por máquina del mismo motor que utiliza el validador del navegador, pensado para canalizaciones de CI, agentes e integraciones.

No. El uso anónimo es gratuito y no requiere cuenta. Las solicitudes anónimas están limitadas a 10 por minuto y 300 al día por cliente, indicadas en las cabeceras de respuesta RateLimit.

Para obtener límites más altos, un administrador de la organización crea una clave de API en la configuración de la organización. Envíala en la cabecera Authorization: Bearer para elevar los límites a 120 solicitudes por minuto y 10.000 al día. Una clave solo permite validar y no da acceso a espacios de trabajo ni evidencias; una clave desconocida o revocada devuelve 401 en lugar de recurrir al acceso anónimo.

OSCAL 1.2.2 JSON en los ocho modelos, detectados a partir de la clave raíz, con un documento por solicitud. El cuerpo puede ocupar hasta 4 MB sin comprimir o 24 MB descomprimidos si se envía con gzip. No se aceptan XML ni YAML.

No. Cada documento se valida en memoria en servidores de la UE en Fráncfort y se descarta con la respuesta. Secani no conserva, registra ni reutiliza su contenido; la telemetría solo contiene datos agregados.

La documentación de la API describe las solicitudes, las respuestas, los límites, las claves de API y todos los códigos de error. Además, hay un contrato OpenAPI 3.1 para generar clientes. Leer la documentación de la API

¿Prefieres validar manualmente?

El validador del navegador ejecuta las mismas comprobaciones de forma totalmente local; allí el documento nunca sale del navegador.