Лидпульт
Трекеры и постбэки

Безопасность ключей API: где хранить apikey и что делать при утечке

Секретный ключ даёт право отправлять лиды от вашего имени. Если он попал в чужие руки, вы рискуете репутацией, лимитами и выплатами. Разбираем правила хранения и порядок действий при утечке.

· 5 мин чтения

Два ключа и их роль

В кабинете вебмастера два ключа. wmkey — публичный, он идентифицирует вас и не даёт права на отправку без второго. apikey — секретный, он подтверждает, что запрос действительно от вас. Для приёма лида нужны оба. Публичный ключ можно увидеть в разделе «Интеграция» в любой момент. Секретный показывается один раз при выпуске, и если вы его не сохранили, придётся выпустить новый.

Это правило сделано намеренно: сеть не хранит секрет в открытом виде и не может показать его повторно. Относитесь к нему как к паролю.

Чем грозит утечка

Человек с вашими wmkey и apikey может отправлять заявки от вашего имени по любому офферу, на который у вас есть доступ. Последствия: лимиты оффера уходят на чужие заявки, клиника получает мусор и недовольна, статистика искажается, а вы можете оказаться под подозрением в фейковых заявках. При заблокированном аккаунте вы потеряете возможность работать с трафиком, пока ситуация не разрешится. Поэтому обращайтесь с ключом осторожно с первого дня.

Где ключ хранить нельзя

  • В коде страницы лендинга или в скриптах, которые видны посетителям.
  • В публичных репозиториях, даже на короткое время: боты сканируют их автоматически.
  • В общих чатах, почте и документах, к которым есть доступ у многих людей.
  • В адресах запросов, которые попадают в журналы серверов, истории браузера и аналитику.
  • В скриншотах, которые вы отправляете коллегам и в поддержку.
Отправка лида из браузера пользователя неизбежно раскрывает ключ. Всегда вызывайте API с вашего сервера.

Где ключ хранить правильно

На сервере: в переменных окружения или в хранилище секретов вашей платформы. В трекере, если он позволяет скрывать значения параметров. В менеджере паролей для резервной копии. Ограничьте круг людей, у которых есть доступ: чем меньше, тем лучше. Если над проектом работают несколько человек, выдавайте доступ к серверу, а не передавайте сам ключ. В репозитории храните файл-образец с пустыми значениями, а реальные значения подставляйте при развёртывании.

POST вместо GET

API допускает и GET, и POST. Но GET помещает все параметры, включая apikey, в адрес. Адрес попадает в журналы веб-серверов, прокси, балансировщиков и аналитики. Для рабочей отправки используйте POST: тело запроса не пишется в журналы по умолчанию. Для ручных проверок GET допустим, но после такой проверки лучше перевыпустить ключ, если адрес мог где-то сохраниться.

curl -X POST "https://<домен-сети>/api/lead" \
  --data-urlencode "wmkey=$WMKEY" \
  --data-urlencode "apikey=$APIKEY" \
  --data-urlencode "offer_id=1" ...

Как перевыпустить ключ

  1. Откройте кабинет и найдите раздел интеграции.
  2. Выпустите новый apikey. Он отобразится один раз: сразу сохраните его.
  3. Обновите значение во всех местах, где ключ используется: на сервере, в трекере, в скриптах.
  4. Проверьте работу тестовым запросом.
  5. Убедитесь, что старый ключ больше не принимается: он перестаёт работать сразу после выпуска нового.

Имейте в виду, что до обновления всех мест отправка будет возвращать bad_key. Поэтому делайте замену в тихое время и сразу, одним действием.

План действий при подозрении на утечку

  1. Немедленно перевыпустите apikey.
  2. Проверьте в кабинете статистику за последние дни: нет ли необычных всплесков заявок, неизвестных меток, незнакомых городов.
  3. Если видите чужие заявки, сообщите менеджеру через контакты с номерами лидов.
  4. Найдите источник утечки и устраните, иначе новый ключ повторит судьбу старого.
  5. Пересмотрите, у кого есть доступ к серверам и репозиториям.

Защита самого кабинета

Ключи защищены настолько, насколько защищён вход в кабинет. Пароли в сети хранятся в виде хеша, вход ограничен по числу попыток, сессия живёт в защищённой cookie. Со своей стороны используйте длинный уникальный пароль, не повторяйте его на других сайтах и не входите в кабинет с чужих устройств. Постбэки и вебхуки уходят только на публичные адреса, без редиректов и с таймаутом, поэтому защищайте и свой приёмный адрес: например, токеном в параметре. Об общих правилах работы читайте на странице правил трафика.

Пример безопасной конфигурации сервера

Допустим, ваш обработчик формы написан на любом серверном языке. Ключи не вписываются в исходный код, а читаются из переменных окружения при запуске. Файл с реальными значениями лежит вне папки сайта, права доступа к нему ограничены пользователем, от имени которого запущен сервис, а в репозитории хранится только образец с пустыми значениями. Журналы сервера настроены так, чтобы не записывать тело запросов к API и значения секретных параметров.

Так утечка через случайно открытую папку, публичный репозиторий или журнал становится гораздо менее вероятной. Дополнительно имеет смысл настроить оповещение при внезапном росте числа заявок: необычный всплеск часто первым показывает, что ключом пользуется кто-то посторонний.

Разграничение доступа в команде

Если с интеграцией работает несколько человек, разделите роли. Одному человеку (владельцу аккаунта) доступен кабинет, где выпускается ключ. Разработчикам достаточно доступа к серверу или хранилищу секретов, а аналитикам и баерам ключ вообще не нужен: им нужны отчёты трекера. Когда сотрудник уходит из команды, пересмотрите доступы и перевыпустите ключ, если он имел к нему отношение. Записывайте, кто и когда получал доступ: через полгода вы уже не вспомните этого по памяти.

Любые подозрения на утечку лучше проверять перевыпуском ключа. Это занимает минуту и не требует доказательств.

Короткий чек-лист

  • apikey сохранён при выпуске и лежит только на сервере.
  • Запросы идут методом POST по защищённому соединению.
  • В журналах нет значений секретных параметров.
  • Доступ к ключу ограничен минимальным кругом людей.
  • Известно, где ключ используется, чтобы быстро заменить его.

Вопросы и ответы

Можно ли посмотреть apikey повторно?

Нет, он показывается один раз при выпуске. Если потеряли, выпустите новый, старый сразу перестанет работать.

Нужно ли скрывать wmkey?

Он публичный и сам по себе не позволяет отправлять лиды, но выкладывать его без необходимости тоже не стоит.

Как часто менять ключ?

Плановой смены в документации нет. Меняйте при подозрении на утечку, при уходе сотрудника с доступом и после случайной публикации.

Можно ли использовать один ключ на несколько проектов?

Можно, но тогда утечка в одном проекте затронет все. Ограничивайте доступ и храните ключ только там, где он нужен.