APIキーとWebhookを安全に保つ
シークレットキーはサーバーに、Webhookは必ず検証、そしてキーのローテーションは日常的な保守です。
キーは 開発者 で作成します。シークレットキーは bk_test_ または bk_live_ で始まり、作成時に一度だけ表示されます。サーバー上のシークレットストアに保管し、リポジトリ、モバイルアプリ、フロントエンドのコードには決して含めないでください。
キーは、作成した人がワークスペースのアクティブなメンバーである間だけ、その人の現在のロールの範囲内で機能します。メンバーを削除するとその人が作成したキーはすべて失効し、停止するとキーは復帰するまで使えなくなります。そのため、メンバーが離れる前に別のオーナーまたは管理者に代わりのキーを作成してもらい、先にサーバーを切り替えてください。また、ノートPCを紛失したときやキーがログに残った可能性があるときもキーを交換してください。新しいキーを作成し、サーバーを切り替えてから、古いキーを無効にします。
ペイロードを信頼する前にすべてのWebhook署名を検証し、イベントは冪等に処理してください — 配信は最低1回で、順序は保証されません。
開発者には開発者ロールを付与してください。キーとWebhookは管理できますがお金は動かせないため、1つの漏洩による影響範囲を限定できます。