Conectar
API de lectura, webhooks e inicio de sesión único
Que tus otros sistemas lean el estado de tu gobernanza de IA y tu equipo entre con las credenciales que ya usa.
Para qué sirve
Con una clave de solo lectura, otros sistemas de tu organización —un cuadro de mando, una herramienta de BI o de riesgos— leen tus registros de Alethexis sin exportarlos a mano.
Un webhook avisa a tu sistema en cuanto pasa algo en tu organización, sin que tenga que consultar la API. La API responde cuando le preguntan; el webhook avisa.
Con el inicio de sesión único, tu equipo entra en Alethexis con las credenciales que ya usa en Microsoft Entra ID o Google Workspace. Las tres piezas las gestiona el Owner y están disponibles en M2 y M3.
Cómo funciona
API de solo lectura
Ocho recursos con una clave de organización: sistemas de IA, clasificaciones, controles, índice de evidencias, secciones, aprobaciones, registro de auditoría y solicitudes de uso de IA. Listados paginados y filtro por fecha. Cada clave admite 120 peticiones por minuto y 10.000 al día, y puede haber hasta 10 claves activas a la vez.
Claves que no se vuelven a mostrar
La clave se muestra una sola vez: Alethexis guarda solo su huella SHA-256. Al revocarla deja de funcionar de inmediato. Su creación y su revocación quedan en el registro de auditoría, con el prefijo y nunca la clave.
Webhooks por evento
Registras una dirección https y eliges qué eventos recibir entre nueve: cierre y reapertura de secciones, alta y reclasificación de sistemas, riesgos altos, aprobaciones registradas, evidencias subidas, solicitudes decididas y medidas correctoras sobre un producto propio. Cada entrega se intenta hasta cinco veces, con esperas crecientes, y las fallidas se pueden reintentar a mano.
Cabecera de verificación HMAC
Cada entrega lleva la cabecera «Alethexis-Signature» con un HMAC-SHA256 de la marca de tiempo y del cuerpo, calculado con el secreto del endpoint; tu sistema lo recalcula y lo compara antes de aceptar la entrega. La documentación incluye un ejemplo en Node.js y otro en Python.
Inicio de sesión único
Por SAML, con Microsoft Entra ID o Google Workspace, sobre los dominios de correo de tu organización. Lo pruebas antes de activarlo y, cuando funcione, puedes forzar que los miembros entren solo por inicio de sesión único. Sin coste adicional.
Qué te llevas
Especificación OpenAPI
La documentación pública de la API trae las cabeceras, los filtros por recurso, los códigos de error, los campos de cada evento de webhook y la especificación OpenAPI de los recursos.
Preguntas frecuentes
- ¿La API devuelve datos de personas?
- No. Por diseño, no incluye campos destinados a datos personales (autores, correos, direcciones IP, valores de cambio) ni textos escritos a mano. Los nombres de sistemas y herramientas los pone tu organización: no incluyas en ellos datos de personas.
- ¿Puedo escribir en Alethexis desde la API?
- No. La API es de solo lectura: no crea, modifica ni borra nada en la plataforma.
- ¿Qué datos lleva un webhook?
- Las cargas llevan identificadores, estados y fechas: nunca nombres, textos ni datos de personas. El detalle se lee después con la API de lectura, usando los identificadores de la carga.
- ¿El inicio de sesión único crea usuarios o trae los roles?
- No crea usuarios por su cuenta: quien entra por SSO sin invitación previa no se une a ninguna organización. No sincroniza grupos ni roles desde tu proveedor: los roles se asignan en Alethexis.