Безопасность ключей API: где хранить apikey и что делать при утечке
Секретный ключ даёт право отправлять лиды от вашего имени. Если он попал в чужие руки, вы рискуете репутацией, лимитами и выплатами. Разбираем правила хранения и порядок действий при утечке.
Два ключа и их роль
В кабинете вебмастера два ключа. wmkey — публичный, он идентифицирует вас и не даёт права на отправку без второго. apikey — секретный, он подтверждает, что запрос действительно от вас. Для приёма лида нужны оба. Публичный ключ можно увидеть в разделе «Интеграция» в любой момент. Секретный показывается один раз при выпуске, и если вы его не сохранили, придётся выпустить новый.
Это правило сделано намеренно: сеть не хранит секрет в открытом виде и не может показать его повторно. Относитесь к нему как к паролю.
Чем грозит утечка
Человек с вашими wmkey и apikey может отправлять заявки от вашего имени по любому офферу, на который у вас есть доступ. Последствия: лимиты оффера уходят на чужие заявки, клиника получает мусор и недовольна, статистика искажается, а вы можете оказаться под подозрением в фейковых заявках. При заблокированном аккаунте вы потеряете возможность работать с трафиком, пока ситуация не разрешится. Поэтому обращайтесь с ключом осторожно с первого дня.
Где ключ хранить нельзя
- В коде страницы лендинга или в скриптах, которые видны посетителям.
- В публичных репозиториях, даже на короткое время: боты сканируют их автоматически.
- В общих чатах, почте и документах, к которым есть доступ у многих людей.
- В адресах запросов, которые попадают в журналы серверов, истории браузера и аналитику.
- В скриншотах, которые вы отправляете коллегам и в поддержку.
Где ключ хранить правильно
На сервере: в переменных окружения или в хранилище секретов вашей платформы. В трекере, если он позволяет скрывать значения параметров. В менеджере паролей для резервной копии. Ограничьте круг людей, у которых есть доступ: чем меньше, тем лучше. Если над проектом работают несколько человек, выдавайте доступ к серверу, а не передавайте сам ключ. В репозитории храните файл-образец с пустыми значениями, а реальные значения подставляйте при развёртывании.
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" ...
Как перевыпустить ключ
- Откройте кабинет и найдите раздел интеграции.
- Выпустите новый apikey. Он отобразится один раз: сразу сохраните его.
- Обновите значение во всех местах, где ключ используется: на сервере, в трекере, в скриптах.
- Проверьте работу тестовым запросом.
- Убедитесь, что старый ключ больше не принимается: он перестаёт работать сразу после выпуска нового.
Имейте в виду, что до обновления всех мест отправка будет возвращать bad_key. Поэтому делайте замену в тихое время и сразу, одним действием.
План действий при подозрении на утечку
- Немедленно перевыпустите apikey.
- Проверьте в кабинете статистику за последние дни: нет ли необычных всплесков заявок, неизвестных меток, незнакомых городов.
- Если видите чужие заявки, сообщите менеджеру через контакты с номерами лидов.
- Найдите источник утечки и устраните, иначе новый ключ повторит судьбу старого.
- Пересмотрите, у кого есть доступ к серверам и репозиториям.
Защита самого кабинета
Ключи защищены настолько, насколько защищён вход в кабинет. Пароли в сети хранятся в виде хеша, вход ограничен по числу попыток, сессия живёт в защищённой cookie. Со своей стороны используйте длинный уникальный пароль, не повторяйте его на других сайтах и не входите в кабинет с чужих устройств. Постбэки и вебхуки уходят только на публичные адреса, без редиректов и с таймаутом, поэтому защищайте и свой приёмный адрес: например, токеном в параметре. Об общих правилах работы читайте на странице правил трафика.
Пример безопасной конфигурации сервера
Допустим, ваш обработчик формы написан на любом серверном языке. Ключи не вписываются в исходный код, а читаются из переменных окружения при запуске. Файл с реальными значениями лежит вне папки сайта, права доступа к нему ограничены пользователем, от имени которого запущен сервис, а в репозитории хранится только образец с пустыми значениями. Журналы сервера настроены так, чтобы не записывать тело запросов к API и значения секретных параметров.
Так утечка через случайно открытую папку, публичный репозиторий или журнал становится гораздо менее вероятной. Дополнительно имеет смысл настроить оповещение при внезапном росте числа заявок: необычный всплеск часто первым показывает, что ключом пользуется кто-то посторонний.
Разграничение доступа в команде
Если с интеграцией работает несколько человек, разделите роли. Одному человеку (владельцу аккаунта) доступен кабинет, где выпускается ключ. Разработчикам достаточно доступа к серверу или хранилищу секретов, а аналитикам и баерам ключ вообще не нужен: им нужны отчёты трекера. Когда сотрудник уходит из команды, пересмотрите доступы и перевыпустите ключ, если он имел к нему отношение. Записывайте, кто и когда получал доступ: через полгода вы уже не вспомните этого по памяти.
Короткий чек-лист
- apikey сохранён при выпуске и лежит только на сервере.
- Запросы идут методом POST по защищённому соединению.
- В журналах нет значений секретных параметров.
- Доступ к ключу ограничен минимальным кругом людей.
- Известно, где ключ используется, чтобы быстро заменить его.
Вопросы и ответы
Можно ли посмотреть apikey повторно?
Нет, он показывается один раз при выпуске. Если потеряли, выпустите новый, старый сразу перестанет работать.
Нужно ли скрывать wmkey?
Он публичный и сам по себе не позволяет отправлять лиды, но выкладывать его без необходимости тоже не стоит.
Как часто менять ключ?
Плановой смены в документации нет. Меняйте при подозрении на утечку, при уходе сотрудника с доступом и после случайной публикации.
Можно ли использовать один ключ на несколько проектов?
Можно, но тогда утечка в одном проекте затронет все. Ограничивайте доступ и храните ключ только там, где он нужен.