← Блог
10 мин чтения
|
Опубликовано
|
Обновлено

Безопасность блокчейн-API: 6 практических советов

Шесть практик безопасности при работе с блокчейн-API: генерация ключей, офлайн-хранение, локальная подпись, адреса, API-токены и подписи вебхуков.

Главы
C
Chaingateway Team
Эксперты по блокчейну

Проверил(а) Maurice Sobiera

Безопасность блокчейн-API — это набор практик, которые защищают приватные ключи, API-токены и трафик вебхуков от злоумышленников, когда ваше приложение использует блокчейн через API. Риск заключается в обращении с ключами, учётными данными и эндпоинтом вебхуков, а не в самом блокчейне. Эти шесть практик применимы к Chaingateway и к любому похожему API.

Как генерировать приватные ключи?

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

Chaingateway может создать для вас адрес через POST /api/v2/{blockchain}/addresses. В руководстве по управлению кошельками описаны два режима. С параметром password приватный ключ хранится у нас в зашифрованном виде, и для отправки транзакций вы используете пароль. Без пароля ответ содержит приватный ключ в открытом виде. Это подходит для временного адреса, но не для того, который вы планируете хранить. Если нужен полный контроль, генерируйте ключ на своём компьютере или на аппаратном кошельке и импортируйте его, только если это необходимо.

Как хранить приватные ключи?

Храните ключи, на которых лежат средства на долгий срок, офлайн. На серверных ключах держите только рабочие балансы. Ключ на машине с доступом в интернет может украсть любой, кто взломает эту машину. Аппаратные кошельки и офлайн-резервные копии устраняют этот риск. Но аппаратный кошелёк можно потерять, поэтому держите проверенную резервную копию для восстановления.

Никогда не записывайте ключи и пароли в исходный код, логи или тикеты. В шпаргалке OWASP по управлению секретами отмечено, что многие организации жёстко прописывают секреты открытым текстом в исходном коде и конфигурационных файлах. Там рекомендуют централизованное хранение с контролем доступа и автоматической ротацией.

Стоит ли подписывать транзакции на своей машине?

Да, если есть такая возможность. Транзакция, подписанная локально, никогда не раскрывает приватный ключ третьей стороне. API нужно только передать результат в сеть. Для TRON Chaingateway поддерживает этот процесс. Эндпоинты build возвращают неподписанную транзакцию. Вы подписываете её инструментами TRON из руководства по офлайн-подписи TRON, а POST /api/v2/tron/transactions/broadcast отправляет подписанную транзакцию.

Для сетей EVM эндпоинты транзакций принимают либо password сохранённого адреса, либо privatekey в теле запроса. Если вы используете privatekey, ключ передаётся в самом запросе. Поэтому обращайтесь к API только по HTTPS и никогда не логируйте тела запросов. Наше руководство по расшифровке keystore показывает, как открыть экспортированный файл keystore локально.

Можно ли использовать адреса, созданные через API, как холодный кошелёк?

Нет. Адрес, ключ которого создан или хранится в онлайн-сервисе, — это горячий кошелёк, как его ни называй. Используйте адреса, созданные через API, как адреса для депозитов. Входящие средства переводите на холодный кошелёк, сгенерированный офлайн. Адрес для депозита считайте краткосрочным.

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

Как защитить API-токен?

Передавайте токен в заголовке Authorization и не выносите его в URL, фронтенд-код и репозитории. Chaingateway использует схему Bearer: Authorization: Bearer <token>, как определено в RFC 6750. Этот RFC требует TLS для каждого запроса, который несёт bearer-токен, потому что любой, кто увидит токен, может им воспользоваться.

Три привычки уменьшают ущерб от утечки:

  • Храните токен в переменной окружения или в менеджере секретов, а не в коде.
  • Меняйте его по расписанию и после любого подозрения на утечку, как описано в нашем руководстве по ротации API-ключей.
  • Ограничивайте доступ по IP-адресу, если в панели аккаунта это предусмотрено. В статье о функции IP-белого списка объясняется, как она работает.

OWASP API Security Top 10 относит нарушенную аутентификацию, включая слабую работу с токенами, к ведущим рискам API.

Как проверять вебхуки от API?

Проверяйте заголовок X-Signature в каждом вебхуке, прежде чем доверять содержимому. Без проверки любой, кто знает URL вашего вебхука, может отправить поддельное уведомление о платеже. Chaingateway подписывает вебхуки, если вы задали персональный секрет в настройках профиля. Подпись — это HMAC, как определено в RFC 2104. Она строится из ID транзакции и вашего секрета.

В руководстве по безопасности вебхуков есть код проверки на Python, Java, PHP и JavaScript. Сравнивайте подписи функцией постоянного времени и подтверждайте транзакцию в блокчейне, прежде чем зачислять заказ. Chaingateway не повторяет неудачные вебхуки автоматически. Неудачные уведомления перечислены по адресу /api/v2/{blockchain}/webhooks/notifications/failed. Отправить каждое из них повторно можно через /webhooks/notifications/{id}/retry. Поэтому проверяйте этот список, когда платёж кажется пропавшим.

Нужны ли все шесть?

Для всего, что хранит реальную ценность, — да. Практики закрывают разные точки отказа. Пропуск одной оставляет эту точку открытой, как бы вы ни защищались в остальных местах.

Точка отказаЧто делатьГде проверить
Создание ключаИспользуйте криптографически стойкий генератор или адрес с паролемРуководство по управлению кошельками
Хранение ключаХраните долгосрочные средства офлайн, держите секреты вне кода и логовШпаргалка OWASP по управлению секретами
ПодписьПодписывайте локально там, где это поддерживает API, иначе используйте только HTTPSPOST /api/v2/tron/transactions/broadcast
Использование адресаИспользуйте адреса API для депозитов и переводите средства на холодный кошелёкВаш собственный процесс вывода средств
Доступ к APIХраните bearer-токен в менеджере секретов и меняйте егоРуководство по ротации API-ключей
УведомленияПроверяйте X-Signature и подтверждайте транзакцию в блокчейнеРуководство по безопасности вебхуков

Проверьте таблицу, прежде чем переходить с тестовой сети на основную. Заголовок X-Network: testnet позволяет прогнать весь процесс, включая проверку вебхуков, без реальных средств.

Как мы пишем эти статьи

Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API блокчейна для полного справочника по эндпоинтам.

C
Chaingateway Team
Эксперты по блокчейну

Команда Chaingateway стремится упростить интеграцию блокчейна для разработчиков по всему миру.