Integraciones lleva los eventos de CloudSignLab a las herramientas que ya usa tu equipo y permite que tus sistemas lean tus registros. Es para propietarios y administradores y está incluido desde el paquete Professional.
Mensajes y webhooks
- Abre Integraciones en el menú de la organización.
- En Mensajes y webhooks, elige Dónde:
- Escribe un Nombre y pega la Dirección (https).
- Marca los Eventos: Incidente comunicado, Riesgo añadido, Política publicada, Hallazgo de auditoría registrado, Tarea creada, Evaluación de proveedor respondida, Evaluación de proveedor decidida.
- Haz clic en Añadir y luego en Enviar prueba para comprobar que llega.
Las direcciones se guardan cifradas. Solo se aceptan direcciones https del servicio elegido, sin direcciones IP ni puertos. Puedes activar o desactivar cada integración. Tras 20 envíos fallidos seguidos se detiene hasta que la vuelvas a activar.
Comprobar las firmas de los webhooks
Cada webhook va firmado. El secreto de firma se muestra una sola vez, justo después de guardar. Cada petición lleva las cabeceras X-CloudSignLab-Timestamp y X-CloudSignLab-Signature: un HMAC sha256 de «timestamp.body» con tu secreto. El cuerpo contiene identificadores y un enlace, sin datos personales.
Claves de API
- En Claves de API, escribe un nombre, por ejemplo Power BI, y haz clic en Crear clave.
- Copia la clave ahora. Solo se muestra una vez; después solo ves cuándo se usó por última vez.
- Haz clic en Revocar cuando ya no necesites una clave.
Las claves son de solo lectura y pertenecen a la organización. Puedes tener hasta 10 claves activas y hacer hasta 300 peticiones cada 10 minutos. La API lee la organización, los riesgos, los controles, los incidentes, los proveedores (sin datos de contacto) y las políticas publicadas. La documentación completa está en la página pública /developers.
Consejos
- Da a cada sistema su propia clave, así puedes revocar una sin afectar a las demás.
Los eventos incluyen también Comprobación automática fallida. En Dónde también puedes elegir Jira o ServiceNow. Una organización puede tener como máximo 10 integraciones.