# 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.blocked` — Se selló una decisión con un resultado de bloqueo
- `derogation` — Se solicitó, concedió, denegó o revocó una dispensa de política, una exención de red teaming o una interpretación del derecho
- `proof.broken` — La verificación horaria encontró rota la cadena del espacio de trabajo

> Solo 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](https://www.azothos.ai/es/docs/cli#ci).
- La misma aplicación lee la huella de IA de un repositorio en cuanto activas la lectura para ese repositorio ([enriquecimientos](https://www.azothos.ai/es/docs/enrichments#footprint)).
