webhooks
Настройка секрета
Создание секрета вебхука, его ограничение по области и сохранение IP-разрешённого списка.
Секрет вебхука Spectra — это то, что соединяет внешнюю систему алертов — ваш собственный сервер, скринер, скрипт или любой источник алертов с поддержкой HTTP — со счётом Spectra. Каждый секрет ограничен одним соединением с брокером и дневным лимитом убытка.
Создание секрета
Профиль → Webhooks → Add. Каждый секрет несёт:
Name → human label, e.g. "TV BTC alerts"
Broker connection → which broker auto-orders route to
Daily-loss cap → per-secret USD ceiling (mandatory)
IP allowlist → CIDR ranges allowed to POST
Active → toggle off to disable without deleting
После сохранения значение секрета показывается один раз. Скопируйте его сразу же — Spectra хранит только запечатанную через AES-GCM копию и не покажет его снова. Потеряли — ротируйте.
Дневной лимит убытка
Лимит применяется на облачном воркере до того, как любой ордер будет направлен брокеру. Если реализованный + открытый P&L за день пробивает лимит, секрет приостанавливается до конца дня и срабатывает алерт.
Вы задаёте лимит при создании секрета; меняйте его в любой момент. Отключить его невозможно — поле обязательное, а минимум составляет $100 (достаточно мало, чтобы не мешать тестированию, достаточно велико, чтобы быть заметным, если кто-то попытается задать 0).
IP-разрешённый список
Диапазоны CIDR, которым разрешено отправлять POST на вебхук. По умолчанию POST может отправлять любой IP, но в сочетании с проверкой HMAC это редко представляет реальную поверхность атаки. Ограничьте его опубликованными IP вашего источника алертов для более строгой изоляции.
Ротация
Webhooks → секрет → Rotate. Старый секрет немедленно отзывается; показывается новый. Обновите ваш отправитель в течение 5 минут — защита от повторов (см. Replay) привязана к метке времени, так что старые сообщения всё равно не воспроизведутся.