秘密情報の扱い — 鍵やパスワードを隠す

中級の解説は準備中のため、中級の内容を表示しています。

概要 — まず全体をつかむ

初級では「秘密はコードの外に隔離し、参照だけする」を土台としました。中級では、どこにどう隔離し、運用でどう守り続けるかを整理します。

詳細 — 1段階ずつ追う

なぜ気をつける?

秘密(APIキー・DBパスワード・署名鍵)が漏れると、DBの中身を抜かれたり、外部サービスを勝手に使われて課金されたり——被害が直接的です。中級で押さえたいのは、秘密は「置き場所」だけでなく「経路」でも漏れるという視点です。

  • コードに直書き — リポジトリの履歴に残り、公開・共有で流出
  • フロントへの埋め込み — ブラウザに配るコードは全部読まれる前提
  • ログ・エラー出力 — トークンをそのまま出すと保存先から漏れる
  • CI/CDの設定 — ビルドログや設定ファイルに平文で残る
アニメーション『秘密情報の扱い(隔離)』を開く
NG:コードに直書きapp.js(ソースコード)const dbPass =  "P@ssw0rd-秘密";apiKey = "sk-live-9f8a...";🔑そのまま残るリポジトリ履歴に秘密が残る(消しても既に読まれた前提)ビルド成果物配布物に秘密が同梱(フロントなら全部読まれる)漏洩 → 悪用・課金・侵入被害が直接的OK:外に隔離して実行時に読み込むapp.js(ソースコード)const dbPass =  process.env.DB_PASS;参照だけ(中身は持たない)実行時に読み込む🔐 環境変数/シークレットマネージャコードの外・サーバ側だけに保管🔑 APIキー🔑 パスワード🔑 署名鍵↻ ローテーション(定期更新)定期的に、また漏れたら即、鍵を無効化して新しくする→ 漏れても被害を最小化リポジトリにもビルドにも秘密が残らないブラウザに配るコードは全部読まれる前提。秘密はサーバ側だけに置く

どう扱う?

  1. コードの外に置く環境変数や専用のシークレットマネージャ(Vault、クラウドのKMS/Secrets Manager)に保管し、実行時に読み込む
  2. リポジトリに入れない.gitignore で秘密ファイルを除外し、シークレットスキャンで混入を自動検知する
  3. フロントに置かない — 秘密が要る処理はサーバ側に寄せ、ブラウザには渡さない
  4. 最小権限 — 1つの鍵は必要な範囲だけに使わせ、用途ごとに分ける
  5. ローテーション — 定期的に、また漏れたら即、鍵を新しくする

隔離の選択肢

置き場所は用途と規模で選びます。

  • 環境変数 — 小規模や単一サービスで手軽。ただしプロセスやログから見えやすい点に注意
  • シークレットマネージャ(Vault・クラウドのSecrets Manager) — 一元管理・アクセス制御・監査・自動ローテーションを仕組み化できる
  • KMS(鍵管理サービス) — 暗号鍵そのものを預け、鍵を取り出さずに暗号化や署名を実行させる

規模が大きくなるほど、誰が・いつ・どの鍵を使ったかを追える管理へ寄せるのが定石です。

⚠️ 破れ方のパターン

  • リポジトリへの混入 — 一度でも公開されたら「漏れた」扱い。履歴を消すより先に無効化&差し替え
  • ビルドでフロントに露出 — 埋め込んだ鍵はブラウザから読める。サーバ側に寄せる
  • ログに秘密を出す — エラーログやアクセスログにトークンを出さない
  • 共有しすぎ・放置 — 1つの鍵を広く使い回すと被害が拡大。ローテーションされない鍵も危険

理解度チェック

そのまま解けます(成績は保存されません)。無料アカウントを作ると、学習の記録と進捗の山登りが始まります。

1. ビルド時にAPIキーをフロントのコードへ埋め込む方式のリスクとして正しいのは?

2. シークレットマネージャ(VaultやクラウドのKMS)を使う主な利点はどれ?

3. 中級で押さえたい「秘密は置き場所だけでなく○○でも漏れる」の○○に入るのはどれ?

4. 秘密がリポジトリへ混入したときの正しい初動はどれ?

5. 「.gitignore」による除外に加えて 秘密の混入を自動で検知する仕組みはどれ?

6. KMS(鍵管理サービス)の説明として正しいのはどれ?

7. リポジトリに秘密ファイルを含めないよう 除外設定を書き込むファイルの名前は?

8. 暗号鍵そのものを預け 鍵を取り出さずに暗号化や署名を実行させるサービスを英字3文字の略語で?