API連携の秘密情報を守る｜キー・権限・更新・失敗時の設計

連携ごとの所有者と用途を記録する

地図、メール、決済、会計など、サービス名、契約名義、管理者、用途、対象環境、更新期限を一覧にします。個人アカウントだけへ依存しません。

開発・テスト・本番のキーを分け、テストから本番データへ入れないようにします。使っていないキーは停止し、棚卸し日を決めます。

コード・Git・画面へ秘密を置かない

キーやトークンをソースコード、Git履歴、通常の仕様書、エラー画面へ書きません。専用の秘密管理や環境設定を使い、閲覧者を限定します。

ログでは値そのものを伏せ、どの連携設定を使ったか識別できるIDだけを残します。問い合わせへ秘密情報を貼り付けない手順を用意します。

最小権限と送信先を確認する

読取だけでよいキーへ更新権限を与えず、対象サービス・データ・送信元を可能な範囲で限定します。管理者キーを日常処理へ使いません。

コールバックURLや送信先を固定し、テスト環境から顧客へメール・SMS・決済を実行しない安全設定を確認します。

更新・失効・再送を練習する

期限前のキー更新、古いキー停止、担当者不在、漏えい疑いを匿名環境で試します。切替中に処理が止まらず、古いキーを戻さなくてよい手順にします。

API失敗と業務データ保存を分け、一意番号で再送の二重処理を防ぎます。失敗件数、応答時刻、期限を監視し、利用者へ内部秘密を含まないエラーを示します。

関連する記事