Інтеграція з GitHub

Перетворіть невдалі Actions і тривоги безпеки на дзвінки та ескалацію

Додайте підписаний webhook репозиторію або організації. Невдалий запуск Actions викликає чергового, а наступний успішний його закриває. Тривоги сканування коду, Dependabot і виявлення секретів ескалюють через голос, Telegram, SMS та e-mail.

Налаштування
Підписаний webhook
Автентифікація
X-Hub-Signature-256
Відновлення
Зелений закриває червоний

Будова тривоги GitHub

LIVE
GitHub → webhook
CI невдалий на main · запуск #42
WardenPoint
мапь результат · ескалюй · зелений закриває
Telegram
Voice call
Email

Налаштування

Три кроки в GitHub

GitHub підписує тіло webhook вашим секретом — жодного токена в адресі чи заголовка для налаштування.

  1. 1Крок 1

    Додайте webhook

    У репозиторії (або організації) перейдіть до Settings → Webhooks → Add webhook. Встановіть Payload URL на вашу кінцеву точку WardenPoint, а Content type — на application/json.

    $ Settings › Webhooks › Add webhook
  2. 2Крок 2

    Вставте секрет

    Впишіть свій секрет інтеграції WardenPoint у поле Secret. GitHub підписує ним кожну доставку, а WardenPoint перевіряє заголовок X-Hub-Signature-256 — доставку без підпису або з хибним секретом буде відхилено.

    $ Secret › <ваш секрет WardenPoint>
  3. 3Крок 3

    Виберіть події

    Позначте окремі події: Workflow runs для CI та Code scanning alerts, Dependabot alerts і Secret scanning alerts для безпеки. GitHub спершу надсилає ping — WardenPoint підтверджує його автоматично.

    $ Let me select individual events

Формат даних

Webhook workflow_run

GitHub надсилає подію з типом у заголовку X-GitHub-Event. WardenPoint мапить результат запуску на активний або розв’язаний стан і дедуплікує за репозиторієм + процесом + гілкою.

GitHub → WardenPoint
workflow-run.jsonJSON
// workflow_run webhook (X-GitHub-Event: workflow_run)
{
"action": "completed",
"workflow_run": {
"name": "CI",
"head_branch": "main",
"conclusion": "failure",
"run_number": 42,
"event": "push",
"html_url": "https://github.com/acme/api/actions/runs/123"
},
"repository": { "full_name": "acme/api" }
}
Розсилка WardenPoint
WardenPoint response202
{
"status": "queued",
"notification_uuid": "notif_8h2k7yQrxJp",
"channels_planned": [
"telegram_voice",
"voice_call",
"email"
],
"escalation_chain_id": "esc_4j2k9bMcvL"
}

Рецепти маршрутизації

Три сценарії для GitHub → WardenPoint

Проводьте збої CI та тривоги безпеки через окремі інтеграції WardenPoint, кожну підключену до власного ланцюга ескалації.

CI

Невдалий запуск на main → телефон

Запуск workflow_run, що завершується результатом failure на гілці релізу, мапиться на 'high' — спершу телефонний дзвінок, потім Telegram. Наступний успішний запуск того самого процесу й гілки закриває його автоматично.

match
conclusion = failure
→ route
пріоритет: high
Безпека

Критична тривога сканування коду → ескалація

Тривога сканування коду несе власний пріоритет (security_severity_level). Критична знахідка викликає негайно; тривоги Dependabot і виявлення секретів маршрутизуються так само.

match
security_severity_level = critical
→ route
→ ланцюг безпеки
Відновлення

Зелений запуск надсилає повідомлення про розв’язання

Оскільки тривоги CI дедуплікуються за репозиторієм + процесом + гілкою, успішний запуск позначає попередній збій як розв’язаний, надсилає в ланцюг повідомлення про розв’язання і скасовує активну ескалацію — без ручного закриття.

match
conclusion = success
→ route
→ повідомлення про розв’язання

FAQ GitHub

Поширені питання про інтеграцію з GitHub

GitHub не надсилає власних заголовків, але підписує тіло кожного webhook вашим секретом і передає його як X-Hub-Signature-256. Впишіть свій секрет інтеграції WardenPoint у поле Secret webhook; WardenPoint перераховує HMAC із сирого тіла й відхиляє будь-яку доставку, чий підпис не збігається. Секрет ніколи не потрапляє в адресу.
Безкоштовний план

Підключіть один репозиторій, перш ніж покладатися на нього

Додайте webhook, зламайте тестовий процес і прочитайте рядок у журналі аудиту. Без картки. Без ризику для продакшну.

  • Підписаний webhook, без секрета в адресі
  • Зелений запуск закриває червоний
  • Тривоги CI та безпеки