Web и API

Принять webhook с проверкой подписи

Локальный приёмник webhook проверяет HMAC-подпись и пишет события в JSONL.

Python Windows macOS Linux Средний
Скачать webhook_receiver.py
Описание

Что делает скрипт

Скрипт поднимает HTTP-сервер только на localhost, принимает POST на заданный путь и проверяет заголовок X-Signature-256 по секрету из WEBHOOK_SECRET. Корректные события дописываются в JSONL-файл, ответ возвращается сразу. Секрет по умолчанию демонстрационный и подходит только для локальной проверки.

Перед запуском
  • Слушайте только localhost и используйте тестовый секрет.
Запуск

Быстрый старт

python webhook_receiver.py --port 8088

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python webhook_receiver.py --port 8088 --path /hooks/demo
  • WEBHOOK_SECRET=demo-secret python webhook_receiver.py --log events.jsonl
Зависимости

Что понадобится

Python 3.10+ Интерпретатор Python
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

webhook_receiver.py

#!/usr/bin/env python3
"""Локальный приёмник webhook с HMAC-подписью."""
from __future__ import annotations

import argparse
import hashlib
import hmac
import json
import os
import time
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from pathlib import Path


class Handler(BaseHTTPRequestHandler):
    server_version = "ScriptDockWebhook/1.0"

    def log_message(self, format: str, *args) -> None:
        return

    def do_POST(self) -> None:
        if self.path != self.server.webhook_path:
            self.send_error(404, "Not found")
            return
        length = int(self.headers.get("Content-Length", "0"))
        if length <= 0 or length > 1_000_000:
            self.send_error(413, "Payload too large")
            return
        body = self.rfile.read(length)
        signature = self.headers.get("X-Signature-256", "")
        expected = "sha256=" + hmac.new(self.server.secret.encode("utf-8"), body, hashlib.sha256).hexdigest()
        if not hmac.compare_digest(signature, expected):
            self.send_response(401)
            self.send_header("Content-Type", "application/json")
            self.end_headers()
            self.wfile.write(b'{"error":"bad signature"}')
            return

        event = {
            "time": time.strftime("%Y-%m-%dT%H:%M:%S%z"),
            "path": self.path,
            "event": self.headers.get("X-Event", ""),
            "body": body.decode("utf-8", errors="replace"),
        }
        with self.server.log_path.open("a", encoding="utf-8") as handle:
            handle.write(json.dumps(event, ensure_ascii=False) + "\n")
        self.send_response(202)
        self.send_header("Content-Type", "application/json")
        self.end_headers()
        self.wfile.write(b'{"ok":true}')

    def do_GET(self) -> None:
        self.send_error(405, "Method not allowed")


def main() -> int:
    parser = argparse.ArgumentParser(description="Принять webhook")
    parser.add_argument("--host", default="127.0.0.1")
    parser.add_argument("--port", type=int, default=8088)
    parser.add_argument("--path", default="/webhook")
    parser.add_argument("--log", type=Path, default=Path("webhooks.jsonl"))
    args = parser.parse_args()

    secret = os.environ.get("WEBHOOK_SECRET", "demo-secret")
    server = ThreadingHTTPServer((args.host, args.port), Handler)
    server.secret = secret
    server.webhook_path = args.path
    server.log_path = args.log
    print(f"Слушаю http://{args.host}:{args.port}{args.path}")
    print(f"Секрет: {'из окружения' if os.environ.get('WEBHOOK_SECRET') else 'demo-secret'}")
    print(f"Журнал: {args.log}")
    try:
        server.serve_forever()
    except KeyboardInterrupt:
        print("Остановлено")
    finally:
        server.server_close()
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get web-webhook-receiver
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Web и API

HTTP, API, сайты, заголовки, SSL и проверка веб-сервисов.

Теги