Аудит-webhooks

Подписанные потоки событий

Потребители webhooks получают подписанные события. Подпись позволяет вашему потребителю убедиться, что событие исходит из mesh и не было подменено в пути, — рассматривайте неподписанные или несоответствующие события как подозрительный ввод и отбрасывайте их. Настройте выделенный приёмник только по HTTPS на окружение и ротируйте ключ подписи по тому же графику, что и другие учётные данные.

  POST https://sink.example.com/rizoma/events
  Content-Type: application/json
  X-Rizoma-Signature: <signature>

  {
    "id": "evt_...",
    "type": "mesh.enrollment.created",
    "actor": { "kind": "setup-key", "id": "first-wave" },
    "target": { "kind": "node", "id": "node-03" },
    "timestamp": "2026-08-18T10:02:11Z"
  }

Что покрывают события

Каталог событий охватывает поверхности, значимые для разбора и соответствия требованиям:

• Изменения подключений — узлы присоединяются к mesh, покидают его или меняют ключи.
• Обновления политик доступа — изменения ACL, команд, групп и правил межсетевого экрана.
• Предоставление продуктов — создание или удаление рабочих нагрузок, хранилищ и сервисов.
• Активность Git — изменения кода, запуски CI, публикации пакетов и события доступа.
• Изменения конфигурации маршрутизаторов — правки шлюзов, NAT и зональных политик.
• Операции резервного копирования и восстановления — создание снапшотов, попытки восстановления и их исходы.

Рекомендации потребителям

Потоки событий — это именно потоки, а не транзакции. Стройте потребителей соответственно:

• Идемпотентность — события могут доставляться повторно; дедуплицируйте по идентификатору события.
• Повторные попытки — рассматривайте сбои доставки как условия для оповещения, а не как тихие потери.
• Упорядоченность — не предполагайте глобальной упорядоченности между типами событий; коррелируйте по субъекту, цели и метке времени.
• Верификация — отклоняйте неподписанные события и ротируйте секреты приёмника как любые учётные данные.