← Усі статті довідкиБезпека

Безпека API-ключів і Webhooks

Секретні ключі залишаються на серверах, події Webhooks перевіряються за підписом, а перевипуск ключа — звичайна рутина.

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

Ключ працює, лише поки його творець залишається активним учасником робочого простору, і лише в межах його поточної ролі. Видалення учасника відкликає всі створені ним ключі; блокування зупиняє його ключі до відновлення доступу. Тож перед тим як хтось піде, попросіть іншого власника чи адміністратора створити ключі на заміну і спершу переключіть на них сервер. Також замінюйте ключ, коли загублено ноутбук або ключ міг потрапити в логи: створіть новий, переключіть сервер, потім відкличте старий.

Перевіряйте підпис кожної події Webhooks, перш ніж довіряти її вмісту, і обробляйте події ідемпотентно — доставка гарантується «щонайменше один раз», а порядок не гарантується.

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

Не розібралися?

Напишіть нам з e-mail вашого акаунта, і ми продовжимо звідти.

Написати в підтримку