← Все статьи справкиБезопасность

Безопасность API-ключей и Webhooks

Секретные ключи остаются на серверах, события Webhooks проверяются по подписи, а перевыпуск ключа — обычная рутина.

Ключи создаются в разделе Разработчикам. Секретный ключ начинается с bk_test_ или bk_live_ и показывается один раз, при создании, — храните его на своём сервере, в хранилище секретов, но никогда в репозитории, мобильном приложении или фронтенд-коде.

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

Проверяйте подпись каждого события Webhooks, прежде чем доверять его содержимому, и обрабатывайте события идемпотентно — доставка гарантируется «хотя бы один раз», а порядок не гарантируется.

Давайте разработчикам роль «Разработчик». Она позволяет управлять ключами и Webhooks, но не двигать деньги, что ограничивает масштаб ущерба при любой компрометации.

Не разобрались?

Напишите нам с e-mail вашего аккаунта, и мы продолжим оттуда.

Написать в поддержку