Как защитить ключ доступа к API
Где хранить токен и почему его нельзя размещать в открытом доступе.
Токен — это секретный ключ, по которому HostHub распознаёт вашу программу. Тот, у кого есть токен, может делать от вашего имени всё, что разрешено его правами. Поэтому относиться к нему нужно так же, как к паролю.
Где хранить токен
- в настройках сервера или переменных окружения, к которым нет доступа снаружи;
- в хранилище секретов, если оно используется в вашей компании;
- в менеджере паролей — для копии, которая нужна ответственному сотруднику.
Где токена быть не должно
- в коде страниц сайта и мобильного приложения: всё, что получает браузер посетителя, может прочитать любой;
- в репозитории с кодом, даже закрытом;
- в переписке, задачах и документах, которые видит широкий круг людей;
- на скриншотах и в записях экрана.
Давайте только нужные права
Если программа лишь показывает список доменов, ей не нужен доступ к изменению DNS и к заказам. Чем уже права ключа, тем меньше вреда при его утечке.
Ограничьте адреса
Если запросы всегда приходят с одних и тех же серверов, сообщите их адреса при запросе доступа. Ключ, привязанный к адресам, бесполезен для постороннего.
Разные ключи для разных систем
Отдельный ключ для каждой интеграции позволяет отключить одну из них, не останавливая остальные, и сразу понять, откуда пришёл запрос.
Что делать, если ключ мог попасть к посторонним
- Сразу напишите в поддержку HostHub и попросите отозвать ключ.
- Получите новый и замените его в своей системе.
- Проверьте в личном кабинете домены, DNS-записи и счета: нет ли изменений, которых вы не делали.
- Выясните, как произошла утечка, и закройте эту возможность.
Не отправляйте токен в обращениях в поддержку: для разбора достаточно request_id — номера запроса.