初級では「秘密はコードの外に隔離し、参照だけする」を土台としました。中級では、どこにどう隔離し、運用でどう守り続けるかを整理します。
中級の解説は準備中のため、中級の内容を表示しています。
概要 — まず全体をつかむ
詳細 — 1段階ずつ追う
なぜ気をつける?
秘密(APIキー・DBパスワード・署名鍵)が漏れると、DBの中身を抜かれたり、外部サービスを勝手に使われて課金されたり——被害が直接的です。中級で押さえたいのは、秘密は「置き場所」だけでなく「経路」でも漏れるという視点です。
- コードに直書き — リポジトリの履歴に残り、公開・共有で流出
- フロントへの埋め込み — ブラウザに配るコードは全部読まれる前提
- ログ・エラー出力 — トークンをそのまま出すと保存先から漏れる
- CI/CDの設定 — ビルドログや設定ファイルに平文で残る
アニメーション『秘密情報の扱い(隔離)』を開く
どう扱う?
- コードの外に置く — 環境変数や専用のシークレットマネージャ(Vault、クラウドのKMS/Secrets Manager)に保管し、実行時に読み込む
- リポジトリに入れない —
.gitignoreで秘密ファイルを除外し、シークレットスキャンで混入を自動検知する - フロントに置かない — 秘密が要る処理はサーバ側に寄せ、ブラウザには渡さない
- 最小権限 — 1つの鍵は必要な範囲だけに使わせ、用途ごとに分ける
- ローテーション — 定期的に、また漏れたら即、鍵を新しくする
隔離の選択肢
置き場所は用途と規模で選びます。
- 環境変数 — 小規模や単一サービスで手軽。ただしプロセスやログから見えやすい点に注意
- シークレットマネージャ(Vault・クラウドのSecrets Manager) — 一元管理・アクセス制御・監査・自動ローテーションを仕組み化できる
- KMS(鍵管理サービス) — 暗号鍵そのものを預け、鍵を取り出さずに暗号化や署名を実行させる
規模が大きくなるほど、誰が・いつ・どの鍵を使ったかを追える管理へ寄せるのが定石です。
⚠️ 破れ方のパターン
- リポジトリへの混入 — 一度でも公開されたら「漏れた」扱い。履歴を消すより先に無効化&差し替え
- ビルドでフロントに露出 — 埋め込んだ鍵はブラウザから読める。サーバ側に寄せる
- ログに秘密を出す — エラーログやアクセスログにトークンを出さない
- 共有しすぎ・放置 — 1つの鍵を広く使い回すと被害が拡大。ローテーションされない鍵も危険
理解度チェック
そのまま解けます(成績は保存されません)。無料アカウントを作ると、学習の記録と進捗の山登りが始まります。
問1. ビルド時にAPIキーをフロントのコードへ埋め込む方式のリスクとして正しいのは?
問2. シークレットマネージャ(VaultやクラウドのKMS)を使う主な利点はどれ?
問3. 中級で押さえたい「秘密は置き場所だけでなく○○でも漏れる」の○○に入るのはどれ?
問4. 秘密がリポジトリへ混入したときの正しい初動はどれ?
問5. 「.gitignore」による除外に加えて 秘密の混入を自動で検知する仕組みはどれ?
問6. KMS(鍵管理サービス)の説明として正しいのはどれ?
問7. リポジトリに秘密ファイルを含めないよう 除外設定を書き込むファイルの名前は?
問8. 暗号鍵そのものを預け 鍵を取り出さずに暗号化や署名を実行させるサービスを英字3文字の略語で?