Integraciones
Webhooks e integraciones
Envía eventos de gobernanza a tus propias herramientas y actúa sobre Azoth desde Slack o Microsoft Teams.
Webhooks de gobernanza
Añade un endpoint HTTPS — una herramienta GRC o ITSM, un SIEM — en Ajustes › Integraciones y alertas › Webhooks y marca los eventos que recibe:
decision.blockedderogationproof.brokenSolo ids, códigos y hashes: ni contenido, ni nombres, ni texto libre. Un receptor que necesite más consulta la API con su propia clave (GET /api/v1/journal).
{
"id": "<delivery uuid>",
"event": "decision.blocked",
"workspace_id": "<workspace>",
"created_at": "<iso date>",
"data": { "seq": 1042, "entryHash": "<sha256>", "decision": "blocked_by_policy", "traceId": "…" }
}Comprobar la firma
Cada entrega lleva X-Azoth-Event, X-Azoth-Delivery — estable entre reintentos; deduplica con él —, X-Azoth-Timestamp y X-Azoth-Signature: t=<timestamp>,v1=<hex>, un HMAC-SHA256 con el secreto de firma del endpoint sobre <timestamp>.<raw body>.
import { createHmac, timingSafeEqual } from 'node:crypto';
export function verifyAzothWebhook(rawBody, header, secret, toleranceSecs = 300) {
const parts = Object.fromEntries(header.split(',').map(p => p.split('=')));
const t = Number(parts.t);
if (!t || !parts.v1 || Math.floor(Date.now() / 1000) - t > toleranceSecs) return false;
const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex');
const a = Buffer.from(parts.v1, 'hex'), b = Buffer.from(expected, 'hex');
return a.length === b.length && timingSafeEqual(a, b);
}
// In a route handler: read the RAW body before parsing it.
export async function POST(req) {
const body = await req.text();
if (!verifyAzothWebhook(body, req.headers.get('x-azoth-signature') ?? '', process.env.AZOTH_WEBHOOK_SECRET)) {
return Response.json({ error: 'Invalid signature' }, { status: 401 });
}
const event = JSON.parse(body); // deduplicate on event.id (= X-Azoth-Delivery)
return Response.json({ ok: true });
}La decisión se sella primero. Una entrega fallida se reintenta con espera progresiva, cinco veces como máximo; un endpoint eliminado antes de la entrega descarta sus eventos pendientes.
Slack
- Pregunta a Azoth con
/azoth <question>o con un mensaje directo: el mismo motor que el asistente de la aplicación, con tu identidad y tu rol. La respuesta solo te llega a ti, nunca a un canal. - Los propietarios y administradores vinculados con MFA reciben las aprobaciones y dispensas que les esperan y deciden con un clic — el rol se lee en el momento del clic, los cuatro ojos se aplican y la decisión queda sellada. Un rol, un cambio de conservación o una exención de red teaming siempre se abren en Azoth.
- Vincula tu cuenta con
/azoth link.
El bot de Microsoft Teams
- Cada organización registra su propio bot de un solo inquilino. Su secreto se cifra y se comprueba con Microsoft antes de guardarse, y Azoth genera su paquete de aplicación.
- Las preguntas en tu chat individual con el bot se responden con tu identidad; las aprobaciones y dispensas llegan como tarjetas a los propietarios y administradores vinculados con MFA, y se deciden con las mismas reglas que en Slack.
PagerDuty y canales de alerta
Cada alerta del espacio de trabajo — aprobaciones pendientes, gobernanza, anomalías de inicio de sesión, caídas de proveedores, cambios de modelo, bucles de agente detenidos, cuota de decisiones selladas — va a sus rutas de alerta en Ajustes › Integraciones y alertas › Alertas: PagerDuty (deduplicado), webhooks de canales de Slack o Teams, o correo electrónico, cada una a partir de la gravedad mínima que indica. Los umbrales de presupuesto van a los destinos fijados con cada presupuesto.
Aplicación de GitHub
- Instala la aplicación de GitHub desde Ajustes › Integraciones y alertas y elige sus repositorios: cada pull request en un repositorio activado recibe un check run. Un repositorio vinculado a una suite de regresión recibe el resultado de cada caso; las suites se crean con la API (
POST /api/v1/regression/suites) y ninguna pantalla vincula una todavía — para probar las pull requests hoy, ejecuta una suite en tu CI con la CLI. - La misma aplicación lee la huella de IA de un repositorio en cuanto activas la lectura para ese repositorio (enriquecimientos).