Безопасность API-ключей и Webhooks
Секретные ключи остаются на серверах, события Webhooks проверяются по подписи, а перевыпуск ключа — обычная рутина.
Ключи создаются в разделе Разработчикам. Секретный ключ начинается с bk_test_ или bk_live_ и показывается один раз, при создании, — храните его на своём сервере, в хранилище секретов, но никогда в репозитории, мобильном приложении или фронтенд-коде.
Ключ работает, только пока его создатель остаётся активным участником рабочего пространства, и только в пределах его текущей роли. При удалении участника все созданные им ключи отзываются; при блокировке его ключи останавливаются до восстановления доступа. Поэтому до ухода сотрудника попросите другого владельца или администратора создать ключи на замену и сначала переключите на них сервер. Заменяйте ключ и тогда, когда потерян ноутбук или ключ мог попасть в логи: создайте новый, переключите сервер, затем отзовите старый.
Проверяйте подпись каждого события Webhooks, прежде чем доверять его содержимому, и обрабатывайте события идемпотентно — доставка гарантируется «хотя бы один раз», а порядок не гарантируется.
Давайте разработчикам роль «Разработчик». Она позволяет управлять ключами и Webhooks, но не двигать деньги, что ограничивает масштаб ущерба при любой компрометации.