# Webhooks et intégrations

Envoyez les événements de gouvernance vers vos propres outils, et agissez sur Azoth depuis Slack ou Microsoft Teams.

## Webhooks de gouvernance

Ajoutez un point de terminaison HTTPS — un outil GRC ou ITSM, un SIEM — dans **Réglages › Intégrations et alertes › Webhooks**, puis cochez les événements qu’il reçoit :

- `decision.blocked` — Une décision a été scellée avec une issue bloquante
- `derogation` — Une dérogation à une règle, une dispense de red-teaming ou une lecture du droit a été demandée, accordée, refusée ou révoquée
- `proof.broken` — La vérification horaire a trouvé la chaîne de l’espace de travail rompue

> Des identifiants, des codes et des empreintes seulement : aucun contenu, aucun nom, aucun texte libre. Un destinataire qui a besoin de plus interroge l’API avec sa propre clé (`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": "…" }
}
```

## Vérifier la signature

Chaque livraison porte `X-Azoth-Event`, `X-Azoth-Delivery` — stable d’une nouvelle tentative à l’autre : dédupliquez sur cette valeur —, `X-Azoth-Timestamp` et `X-Azoth-Signature: t=<timestamp>,v1=<hex>`, un HMAC-SHA256 calculé avec le secret de signature du point de terminaison sur `<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 décision est scellée d’abord. Une livraison échouée est retentée avec un délai croissant, cinq fois au plus ; un point de terminaison supprimé avant la livraison abandonne ses événements en attente.

## Slack

- Interrogez Azoth avec `/azoth <question>` ou un message direct : le même moteur que l’assistant de l’application, avec votre identité et votre rôle. La réponse ne va qu’à vous, jamais dans un canal.
- Les propriétaires et administrateurs liés avec MFA reçoivent les approbations et dérogations qui les attendent et décident d’un clic — rôle lu au moment du clic, quatre yeux appliqués, décision scellée. Un rôle, un changement de conservation ou une dispense de red-teaming s’ouvre toujours dans Azoth.
- Liez votre compte avec `/azoth link`.

## Le bot Microsoft Teams

- Chaque organisation enregistre son propre bot mono-tenant. Son secret est chiffré et vérifié auprès de Microsoft avant d’être enregistré, et Azoth construit son paquet d’application.
- Les questions posées dans votre conversation individuelle avec le bot reçoivent une réponse avec votre identité ; les approbations et dérogations arrivent sous forme de cartes pour les propriétaires et administrateurs liés avec MFA, décidées selon les mêmes règles que dans Slack.

## PagerDuty et canaux d’alerte

Chaque alerte de l’espace de travail — approbations en attente, gouvernance, anomalies de connexion, pannes de fournisseur, changements de modèle, boucles d’agent arrêtées, quota de décisions scellées — va à ses routes d’alerte dans **Réglages › Intégrations et alertes › Alertes** : PagerDuty (dédupliqué), webhooks de canaux Slack ou Teams, ou e-mail, chacune à partir de la gravité minimale qu’elle indique. Les seuils de budget vont aux destinations fixées avec chaque budget.

## App GitHub

- Installez l’App GitHub depuis **Réglages › Intégrations et alertes** et choisissez ses dépôts : chaque pull request sur un dépôt activé reçoit un check run. Un dépôt lié à une suite de régression reçoit le résultat de chaque cas ; les suites se créent par l’API (`POST /api/v1/regression/suites`) et aucun écran n’en lie encore une — pour tester les pull requests dès aujourd’hui, exécutez une suite dans votre CI avec la [CLI](https://www.azothos.ai/fr/docs/cli#ci).
- La même App lit l’empreinte IA d’un dépôt dès que vous activez la lecture pour ce dépôt ([enrichissements](https://www.azothos.ai/fr/docs/enrichments#footprint)).
