Ключи API на хостинге: где их хранить и что делать при утечке
ПечатьКоротко: ключ API, например для сервиса ИИ или для платежей, храните как пароль. Не вставляйте его в код, в GitHub или в файл в public_html. Для приложений Node.js и Python добавьте ключ как переменную окружения в cPanel. Для PHP и WordPress храните его в файле вне public_html. Если ключ утёк, сразу отзовите его у провайдера и установите новый.
Где хранить ключ
| Приложение | Где хранить ключ | Как его прочитать |
|---|---|---|
| Node.js | cPanel, Setup Node.js App, ваше приложение, Environment variables | process.env.KEY_NAME |
| Python | cPanel, Setup Python App, ваше приложение, Environment variables | os.environ["KEY_NAME"] |
| PHP и WordPress | Файл вне public_html, например /home/USERNAME/config/secrets.php | Подключается из wp-config.php или из приложения |
| Laravel | Файл .env в корне проекта, сайт обслуживается из папки public | env('KEY_NAME') |
| GitHub Actions | Settings, Secrets and variables, Actions | ${{ secrets.KEY_NAME }} |
После того как вы добавили или изменили переменную в приложении Node.js или Python, нажмите Save, затем Restart. Полные шаги описаны в Как запустить приложение Node.js в cPanel и Приложение на Python в cPanel: создание и управление.
Пример для WordPress
- В File Manager создайте папку
configрядом сpublic_html, а не внутри неё. - В этой папке создайте файл
secrets.php:<?php define('ANTHROPIC_API_KEY', 'ваш-ключ'); - Измените права файла на
600в File Manager через Permissions. - В
wp-config.phpперед строкой/* That's all, stop editing! */(или её переведённым вариантом) добавьте:require_once '/home/USERNAME/config/secrets.php';
Плагины, которые принимают ключ как константу, читают его отсюда. Точное имя константы уточните в документации плагина.
Чего делать нельзя
- Не вставляйте ключ в JavaScript сайта. Любой посетитель увидит его в коде страницы.
- Не оставляйте файл .env в public_html. Если сервер его не блокирует, его может скачать кто угодно.
- Не загружайте ключ в GitHub, даже в приватный репозиторий. Если позже удалить файл, ключ останется в истории.
- Не отправляйте ключ в тикетах, по e-mail, в чате или на скриншотах. Нашей команде ваши ключи API не нужны.
- Не вставляйте ключ в переписку с ИИ-ассистентами. Текст переписки попадает в сервис ИИ.
Как снизить риск
- Отдельный ключ для каждого сайта или приложения. Если один ключ утечёт, вы отключите только его.
- Лимит расходов и оповещение по e-mail в аккаунте у провайдера.
- Минимальные права. Некоторые провайдеры позволяют создавать ключи только для определённых функций или только для определённых IP-адресов. Используйте эту возможность.
- Двухфакторная аутентификация в личном кабинете клиента и в cPanel. Переменные окружения видны любому, кто входит в cPanel. См. Двухфакторная аутентификация для личного кабинета и cPanel.
Что делать, если ключ утёк
- Сразу отзовите ключ в аккаунте у провайдера и создайте новый. Удалить ключ из кода недостаточно.
- Установите новый ключ вместо старого и перезапустите приложение.
- Проверьте расход у провайдера: нет ли использования, которое вы не узнаёте.
- Выясните, как произошла утечка. Если ключ был в GitHub, проверьте остальную часть репозитория. Если вы подозреваете, что сайт взломан, действуйте по инструкции Сайт взломали: первые шаги в правильном порядке.
Часто задаваемые вопросы
Безопасны ли переменные окружения в cPanel?
Они намного безопаснее, чем ключ, записанный в коде. Они не видны на сайте и не попадают в GitHub. Их видит только тот, у кого есть доступ к вашему аккаунту cPanel.
Как узнать, не стал ли мой ключ публичным?
GitHub автоматически проверяет публичные репозитории и уведомляет провайдеров о многих типах ключей. Многие провайдеры сами отключают найденные так ключи и отправляют вам e-mail. Не полагайтесь только на это.
Как часто менять ключи?
Сразу, как только появились сомнения, и когда уходит человек, у которого был к ним доступ. В остальных случаях хорошее правило: раз в несколько месяцев.