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

Печать
  • 0

Коротко: ключ API, например для сервиса ИИ или для платежей, храните как пароль. Не вставляйте его в код, в GitHub или в файл в public_html. Для приложений Node.js и Python добавьте ключ как переменную окружения в cPanel. Для PHP и WordPress храните его в файле вне public_html. Если ключ утёк, сразу отзовите его у провайдера и установите новый.

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

ПриложениеГде хранить ключКак его прочитать
Node.jscPanel, Setup Node.js App, ваше приложение, Environment variablesprocess.env.KEY_NAME
PythoncPanel, Setup Python App, ваше приложение, Environment variablesos.environ["KEY_NAME"]
PHP и WordPressФайл вне public_html, например /home/USERNAME/config/secrets.phpПодключается из wp-config.php или из приложения
LaravelФайл .env в корне проекта, сайт обслуживается из папки publicenv('KEY_NAME')
GitHub ActionsSettings, Secrets and variables, Actions${{ secrets.KEY_NAME }}

После того как вы добавили или изменили переменную в приложении Node.js или Python, нажмите Save, затем Restart. Полные шаги описаны в Как запустить приложение Node.js в cPanel и Приложение на Python в cPanel: создание и управление.

Пример для WordPress

  1. В File Manager создайте папку config рядом с public_html, а не внутри неё.
  2. В этой папке создайте файл secrets.php:
    <?php
    define('ANTHROPIC_API_KEY', 'ваш-ключ');
  3. Измените права файла на 600 в File Manager через Permissions.
  4. В wp-config.php перед строкой /* That's all, stop editing! */ (или её переведённым вариантом) добавьте:
    require_once '/home/USERNAME/config/secrets.php';

Плагины, которые принимают ключ как константу, читают его отсюда. Точное имя константы уточните в документации плагина.

Чего делать нельзя

  • Не вставляйте ключ в JavaScript сайта. Любой посетитель увидит его в коде страницы.
  • Не оставляйте файл .env в public_html. Если сервер его не блокирует, его может скачать кто угодно.
  • Не загружайте ключ в GitHub, даже в приватный репозиторий. Если позже удалить файл, ключ останется в истории.
  • Не отправляйте ключ в тикетах, по e-mail, в чате или на скриншотах. Нашей команде ваши ключи API не нужны.
  • Не вставляйте ключ в переписку с ИИ-ассистентами. Текст переписки попадает в сервис ИИ.

Как снизить риск

  1. Отдельный ключ для каждого сайта или приложения. Если один ключ утечёт, вы отключите только его.
  2. Лимит расходов и оповещение по e-mail в аккаунте у провайдера.
  3. Минимальные права. Некоторые провайдеры позволяют создавать ключи только для определённых функций или только для определённых IP-адресов. Используйте эту возможность.
  4. Двухфакторная аутентификация в личном кабинете клиента и в cPanel. Переменные окружения видны любому, кто входит в cPanel. См. Двухфакторная аутентификация для личного кабинета и cPanel.

Что делать, если ключ утёк

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

Часто задаваемые вопросы

Безопасны ли переменные окружения в cPanel?

Они намного безопаснее, чем ключ, записанный в коде. Они не видны на сайте и не попадают в GitHub. Их видит только тот, у кого есть доступ к вашему аккаунту cPanel.

Как узнать, не стал ли мой ключ публичным?

GitHub автоматически проверяет публичные репозитории и уведомляет провайдеров о многих типах ключей. Многие провайдеры сами отключают найденные так ключи и отправляют вам e-mail. Не полагайтесь только на это.

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

Сразу, как только появились сомнения, и когда уходит человек, у которого был к ним доступ. В остальных случаях хорошее правило: раз в несколько месяцев.

Полезные статьи

Помог ли вам данный ответ?

Нужна помощь? Позвоните нам +373 795-800-80