Démarrer gratuitement →

Intégrations

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.
  • 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).