← すべてのヘルプ記事セキュリティ

APIキーとWebhookを安全に保つ

シークレットキーはサーバーに、Webhookは必ず検証、そしてキーのローテーションは日常的な保守です。

キーは 開発者 で作成します。シークレットキーは bk_test_ または bk_live_ で始まり、作成時に一度だけ表示されます。サーバー上のシークレットストアに保管し、リポジトリ、モバイルアプリ、フロントエンドのコードには決して含めないでください。

キーは、作成した人がワークスペースのアクティブなメンバーである間だけ、その人の現在のロールの範囲内で機能します。メンバーを削除するとその人が作成したキーはすべて失効し、停止するとキーは復帰するまで使えなくなります。そのため、メンバーが離れる前に別のオーナーまたは管理者に代わりのキーを作成してもらい、先にサーバーを切り替えてください。また、ノートPCを紛失したときやキーがログに残った可能性があるときもキーを交換してください。新しいキーを作成し、サーバーを切り替えてから、古いキーを無効にします。

ペイロードを信頼する前にすべてのWebhook署名を検証し、イベントは冪等に処理してください — 配信は最低1回で、順序は保証されません。

開発者には開発者ロールを付与してください。キーとWebhookは管理できますがお金は動かせないため、1つの漏洩による影響範囲を限定できます。

まだ解決しませんか?

アカウントのメールアドレスからご連絡ください。そこから当社が引き継ぎます。

サポートに問い合わせる