Empezar gratis →

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.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.
  • La misma aplicación lee la huella de IA de un repositorio en cuanto activas la lectura para ese repositorio (enriquecimientos).