Публичный слушатель вебхука — самая мягкая поверхность самодельного шлюза OpenClaw на native macOS: любой, кто дотягивается до порта, сможет завалить вызовы инструментов, пока вы не требуете HMAC по сырому телу, не отсекаете устаревшие timestamp и не дедуплицируете delivery / event ID. В материале — две таблицы (крипто и дизайн кэша повторов), семь шагов, совпадающих с блоком HowTo в JSON-LD, развёрнутый FAQ в тексте, плюс перекрёстные ссылки на вебхуки Slack/Discord и идемпотентность в штормах — отдельно: страница цен, справка, VNC для внеплановых сессий операторов, регионы размещения: HK·JP·KR·SG·US.
Риски сразу после «проброса порта наружу»
- Replay после сниффа: атакующий копит легитимный signed payload и шлёт его, пока не сгорят квоты tool API.
- Абуз skew: расширительное «окно часов» ради плохого NTP — это тот же расширенный replay.
- Разнобой JSON: верификация на уже нормализованном (pretty-print) теле ломает
crypto.subtleиsignature, хотя пакет «честно» идентичен смыслу — класс дифференциальных атак к парсеру и прокси.
Сначала прочтите сборку вебхуков под капризы каналов, затем как удерживать idempotency, иначе даже валидная подпись не остановит double-spend в тикетах или в биллинге.
Матрица A — стоимость проверки и гарантия
| Подход | Безопасность | CPU на M4 | Заметка |
|---|---|---|---|
| HMAC-SHA256 по сырому телу | Сильная | Принебрежима на Apple Silicon | Совпадает с типичной Slack-совместимой схемой |
| Секрет в query-строке | Слабая | N/A | Утекает в access-log — запрет в прод |
| Ed25519 (нестандартно) | Сильная | Низко, зато выше риск кода | Только если поставщик вменяемо оформил публичный ключ и вектор |
Матрица B — кэш повторов: что переживёт рестарт (✓/✗)
| Вариант | Рестарты | Память ограничена | Компромисс |
|---|---|---|---|
| In-memory LRU id событий | ✗ | ✓ | Просто; повторы возможны после рестарта, если не ужесточить skew |
| SQLite на APFS с TTL | ✓ | ✓ | Сложнее код; лучше для compliance и long-lived шлюзов |
| Без кэша | ✗ | ✓ | Недопустимо, если инструменты мутируют прод |
HowTo: семь шагов (macOS-шлюз)
1. Синхронизируйтесь с секретами в Keychain: HMAC-материал в репо с 0644 — сразу путь к инциденту, не к фиче. 2. Читайте сырое тело из reverse proxy: если middleware сначала парсит JSON, подписи ломаются — это не «слабая атака», а порядок пайплайна. 3. NTP и clock skew: кривой шлюз превращает легальные ретраи Slack в ложноположительные alert.
4. Поставьте TTL кэша id примерно в 2× от максимума сетевых ретраев, которые документировал поставщик, и визуализируйте duplicate rate в неделю, не «когда-нибудь в Grafana». 5. На уровне Workspace ведите ключи, чтобы даже 409 / duplicate в HTTP не оставлял полу-применённого состояния. 6. Redaction в syslog: пишем счётчики, не X-Hub-Signature-256 целиком. 7. openclaw doctor после TLS, SNI, bind — до того как сканер из интернета найдёт открытый порт.
SSH на выделенном Mac mini M4 — для launchd, sudo и рестартов; VNC — единовременно открыть System Settings, если TLS-цепочку надо визуально сверить с keychain, не превращайте его в «основной вход».
Числа, которые нормализуют в одном config
- Skew window: 300 с как старт; сужайте, когда 30 суток без сюрпризов в метриках дрейфа.
- Replay TTL: ≥ 2× к самому плотному интервалу retry у провайдера.
- Алерт: > 1%
signaturemismatch за 10 минут — сначала ротация секрета, потом DDoS.
Важно: не отключайте цепочку HMAC на демо «на час» — ротируйте токен и чините клиентов, иначе поставщик запомнит, а аудит — нет.
FAQ
mTLS вместо HMAC?
Клиентские сертификаты подтверждают транспорт, а не пакет вебхука. HMAC остаётся, пока провайдер явно не описал только mTLS end-to-end как контракт аутентификации тела.
Cloudflare или nginx впереди — что передавать дальше?
Завершаем TLS на границе, проксируем сырые октеты (или буфер целиком до HMAC) и оставляем ожидаемые заголовки подписи — X-Forwarded-Proto не равен «ломаем Host в canonical URL» — проверяйте матрицу совпадения с поставщиком.
Почему важен регион (HK, JP, KR, SG, US) для self-hosted OpenClaw?
Узел ближе к выходу чат-провайдера снижает RTT — меньше «ложных» ретраев из-за 500 с вашей стороны; это не ускоряет crypto и не заменяет HMAC+replay, но снижает шум в алертах.
Гигиена вебхука — часть картины «шлюз как бытовой прибор на macOS» — крипто дёшев на M4, срез угла непозволителен. Идемпотентный слой и bounded replay вместе дают предсказуемый blast radius при компрометации одного пути доставки. Ссылки на коммерческий онбординг и кнопки смотрите после статьи, не в лид-абзаце.