Spectra
Открыть документацию

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) привязана к метке времени, так что старые сообщения всё равно не воспроизведутся.