シークレット管理とは?APIキーやパスワードの保管・配布・更新

シークレット管理は、APIキー、データベースの接続用パスワードなど、漏れるとアクセスに使われ得る値を管理する取り組みです。保存場所を決めるだけでなく、発行、利用、更新、失効までを扱います。

値を知る人を増やすことなく、必要なプログラムが必要な範囲で使える状態を目指します。

保存先と利用権限を分けて考える

専用の管理サービスに入れても、すべてのアプリや担当者がすべての値を読めるなら、影響範囲は大きいままです。OWASPは、シークレットごとの細かなアクセス制御と最小権限を推奨しています。OWASP: Secrets Management

開発用と本番用、アプリごとの用途を分け、誰が管理できるか、どの実行主体が読めるかを確認します。管理サービスへアクセスするための権限も、同じように対象を絞ります。

秘密の値を含まない台帳を作る

運用の把握には値そのものを一覧表へ貼り付ける必要はありません。次のように、用途と責任を追える情報を整理する方法が考えられます。

項目 記録する内容の例
識別名 本番の通知サービス接続用
用途と利用元 どのアプリ・ジョブが使うか
認証先 どのサービスへ接続する値か
管理責任者 更新・失効を判断する担当
権限と期限 可能な操作、有効期限、更新方針
更新手順 利用側の反映方法と確認先

実際のキーやパスワードは、台帳、チャット、チケットへ記載しません。確認に必要なのは、秘密の値を共有することではなく、その管理対象を特定できることです。

ローテーションでは三つの状態をそろえる

ローテーションは値を更新することです。AWSの説明では、管理サービスに保管した値と、データベースやサービス側の認証情報の両方を更新します。AWS: Rotate secrets

さらに実際のアプリが新しい値を使えているかを確認します。保管値だけを変えて認証先が古いまま、あるいはアプリが古い値を保持したままだと、接続に失敗する可能性があります。

架空の外部APIキーの更新なら、次の順序を検討します。

  1. 利用しているアプリとバッチを洗い出す。
  2. 発行元の仕様に従って新しい値を用意する。
  3. 承認された保管先と利用側へ反映する。
  4. 新しい値で必要な操作ができることを確認する。
  5. 不要になった古い値を失効し、利用が残っていないか確かめる。

新旧の値を並行利用できるか、即時置き換えになるかはサービスごとに異なります。一定の日数を全シークレットへ機械的に当てはめず、期限・リスク・停止への影響に応じて手順を決めます。

ログへ残すのは操作の記録

誰が、いつ、どの対象にアクセスしたかは監査に役立ちますが、値そのものをログに出すと漏えい経路になります。OWASPも、平文の秘密情報を記録しないことを求めています。OWASP: Detection lifecycle

アプリのデバッグ出力、例外メッセージ、CI/CDの実行ログも点検します。正常時に隠れていても、失敗時だけ入力全体が出る場合があるため、テスト用の値でエラー経路も確認してください。

漏えい時は削除だけで終えない

値が外へ出た場合、コードや画面から消しても、既に取得された値は使われる可能性があります。OWASPは、失効、新しい値への更新、露出した場所への対処、利用記録の確認を整理しています。OWASP: Incident response

対応時は秘密の値を追加共有せず、識別名と発見場所、時刻を責任者へ伝えます。履歴の扱いを含む修復は、証拠と業務影響を考慮して担当者が判断します。インフラや運用体制の整理については、インフラ支援をご確認ください。

記事一覧へ戻る

ITの困りごとを、
まずはご相談ください。

何から手をつけるか決まっていない段階でも構いません。ご相談内容に応じて、担当者からご連絡します。

まずは相談する

採用へのご応募は採用エントリーからお願いします。