Принять webhook с проверкой подписи
Локальный приёмник webhook проверяет HMAC-подпись и пишет события в JSONL.
Что делает скрипт
Скрипт поднимает 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/demoWEBHOOK_SECRET=demo-secret python webhook_receiver.py --log events.jsonl
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.