攻撃を知り、防ぐ

秘密情報は、どこから漏れるのか

コードや公開ファイルに紛れ込んだ API キーを見つける方法と、鍵を探しに来た相手をおとりの SSH の鍵で知る方法を学びます。

  • レベル: 基礎
  • 約40分
  • 2026-11-13

#秘密情報は、どこから漏れるのか

API キー、アクセストークン、秘密鍵のような「秘密情報」は、持っているだけで、持ち主になりすませる文字列です。攻撃者は、パスワードを破る代わりに、誰かがすでに置き忘れた秘密情報を探します。置き忘れは、たいてい次の 4 か所で起きます。

場所起きること
ソースコード動作確認のために直接書いた鍵が、そのままコミットされる
設定ファイル・ログ.env やデバッグの出力に鍵が混ざったまま、共有される
Web に公開するファイルビルドの成果物(dist など)に、鍵がそのまま入っている
ソースマップ本番にも置かれて、元のソースコードが丸ごと読めてしまう

どの場合も、攻撃者は侵入する必要がありません。公開されている場所を読むだけで、秘密情報が手に入ります。

「消せば終わり」ではない

一度でも公開された秘密情報は、あとで消しても、漏れたものとして扱います。コピーや検索エンジンのキャッシュ、誰かのクローンに残っているかもしれないからです。対処の中心は「消す」ことではなく、発行元で「無効にする」ことです。

#文字列の中の秘密情報を見つける

RoamSwitch の API キー・秘密鍵の検出 は、文章やファイルの中から、既知の形式の API キーや秘密鍵を探します。

文字列を検査する

下の鍵は、AWS の公式文書に載っている無効なサンプルです。実在しない鍵なので、安心して試せます。本物の鍵は使わないでください。

roamswitch audit-secrets "aws_access_key_id=AKIAIOSFODNN7EXAMPLE"
echo "終了コード: $?"
roamswitch audit-secrets ./no-such-dir
echo "終了コード: $?"
実行結果
=====================================================
  🔑 機密情報・APIキー漏洩監査
=====================================================

  1件の機密情報・APIキー露出を検出しました。コミットや外部共有前に削除してください。

  ⚠️  AWS Access Key ID (AWS): 行番号 1
      マスク済み: AKIAIO...MPLE (エントロピー: 3.68)
      ↳ 推奨対応: AWS IAMコンソールからアクセスキーを非アクティブ化してください。

終了コード: 1
✗ パスが見つかりません: ./no-such-dir(文字列として調べるときは --text を付けてください)
使い方: roamswitch audit-secrets <ファイルパス | ディレクトリ | テキスト> | --text <テキスト>
終了コード: 2

見るところは 3 つあります。

  • マスク済み: 鍵の全体は、画面にも記録にも残しません。検査の結果を人に見せても、鍵は漏れません
  • エントロピー: 文字の並びのでたらめさです。値が高いほど、人が付けた名前ではなく、機械が作った鍵らしい文字列です
  • 推奨対応: 鍵の発行元で無効にすることを求めています。ファイルから消すだけでは、対処は終わりません

終了コードは、見つけると 1、見つからなければ 0 です。引数がないときと、パスに見える引数が存在しないときは 2 です。パスの形の文字列を、文字列として調べるときは --text を付けます。

#公開するファイルの中の秘密情報を見つける

Web サイトのビルド成果物は、そのまま世界中に公開されます。公開されるフロントエンドの秘密の検査 は、公開するフォルダを調べます。

公開するフォルダを検査する

ダミーのビルド成果物を作って、検査します。app.js に先ほどのサンプルキーを書き、ソースマップ(app.js.map)も置きます。うっかり紛れ込んだ .env も 1 つ置きます。

mkdir -p dist
printf 'const cfg = { accessKeyId: "AKIAIOSFODNN7EXAMPLE" };\n//# sourceMappingURL=app.js.map\n' > dist/app.js
echo '{"version":3,"sources":["src/app.ts"],"mappings":""}' > dist/app.js.map
printf 'AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE\n' > dist/.env
roamswitch scan-frontend ./dist
echo "終了コード: $?"
実行結果
=====================================================
  フロントエンドの公開ファイルの確認
=====================================================

調べた場所: .(ファイル 3 件)
- 機密情報(APIキー・秘密鍵など): .env:1 AWS AKIAIO...MPLE
- 機密情報(APIキー・秘密鍵など): app.js:1 AWS AKIAIO...MPLE
- ソースマップ(元のソースコードが読めてしまう): app.js.map
3 件(機密情報 2、トークン 0、ソースマップ 1)
見つかったキーやトークンは、ファイルをすでに公開していた場合、流出したものとして扱ってください。発行元で無効にして、新しく作り直します。秘密情報はビルドに含めず、サーバー側に置いてください。ソースマップは、本番に置かないか、取得できる人を限ってください。
終了コード: 1

.env の鍵も、app.js の鍵と別に挙がりました。公開フォルダーの .env・.env.*・*.env も読むためです。

終了コードが 1 になるので、このコマンドをビルドの最後に入れると、秘密情報が入ったまま公開しようとしたときに、そこで止められます。問題がなければ、終了コードは 0 です。

#盗みに来たことを、おとりで知る

ここまでは、置き忘れた鍵を探す側の機能でした。反対に、鍵を探しに来た相手に気づくのが 認証情報のおとり です。Server Edition は、honeytokens_home(既定 /root)の下に、本物でない鍵のファイルを置き、開かれたら知らせます。

/root/.ssh/id_rsa のおとりは、そのホストの ssh-keygen で作った、使い捨ての ed25519 の鍵です。パスフレーズはなく、どこにも登録しません。ファイル名だけが id_rsa です。

おとりの SSH の鍵を使わせてみる

読むだけで、設定は変えません。ふつうの ssh と、おとりの鍵を名指しした ssh -i を、同じ VM の sshd へ向けます。どちらも鍵は登録されていないので、ログインは断られます。grep -c は、おとりの鍵が開かれた通知の数です。

sudo roamswitch notifications | grep -c ssh_private_key
sudo ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new localhost true
sleep 5
sudo roamswitch notifications | grep -c ssh_private_key
sudo ssh -o BatchMode=yes -i /root/.ssh/id_rsa localhost true
sleep 5
sudo roamswitch notifications | grep -c ssh_private_key
sudo roamswitch notifications | sed -n '5,9p'
sudo ls /root/.ssh
実行結果
0
Warning: Permanently added 'localhost' (ED25519) to the list of known hosts.
root@localhost: Permission denied (publickey,password).
0
root@localhost: Permission denied (publickey,password).
1
  2026-11-13T02:26:03.449957629+00:00
  おとりの認証情報ファイルが開かれました
    /root/.ssh/id_rsa (ssh_private_key) は本物ではありません。
    プロセス: root / /usr/bin/ssh / コマンド: ssh -o BatchMode=yes -i /root/.ssh/id_rsa localhost true (pid 1255)
    親プロセス: sudo ← dash ← tart-guest-agent ← systemd / サービス: tart-guest-agent.service
authorized_keys
config
id_rsa
known_hosts

ふつうの ssh では、数が増えませんでした。ssh は既定の鍵として id_rsa を接続先に試しますが、断られて終わるだけなので、知らせません。-i で名指しすると、1 件増えました。

通知には、開いたコマンドと親のプロセスが出ます。開かれたあと、/root/.ssh に config が増えました。RoamSwitch が足した、次のおとりです。中には、ありそうな踏み台のサーバーの名前が書いてあります。読んだプロセスか、その時点の親が AI エージェント(Claude Code や Codex など)の下で動いていれば、通知に、エージェントの名前と pid、確かめることが 1 行増えます。

通知の時刻は UTC です。日本時間は 9 時間足して読みます。

鍵の指紋を見るだけでも、おとりを開いたことになります。

sudo ssh-keygen -l -f /root/.ssh/id_rsa
実行結果
256 SHA256:+u582zTn/dRT7LZ8LovXk3FNv0yZr+EW8SekadPdPfA ROAMSWITCH_HONEYTOKEN decoy - not a real key, do not use (ED25519)

コメントに印があり、本物の鍵と取り違えません。鍵はホストごとに作るので、別の VM では指紋が違いました。この ssh-keygen も、おとりの読み取りとして通知に入りました。

#見つかったとき、最初にすること

順番が大切です。

  1. 発行元で、その鍵を無効にする。先に Git の履歴を直したり、ファイルを消したりしないでください。その間も、鍵は使えるままです
  2. 使われた形跡を調べる。発行元の操作ログ(AWS なら CloudTrail など)で、身に覚えのない操作がないかを確かめます
  3. 新しい鍵を発行して、差し替える。差し替えたあと、正しく動くかを確かめます
  4. ソースから取り除く。秘密情報はコードやビルドに含めず、動かす側(サーバーの環境変数や、秘密情報を管理する仕組み)に置きます
  5. 再発を防ぐ。コミットの前や、ビルドの最後に、検査が自動で動くようにします
やってはいけないこと
  • 鍵を消しただけで、無効にしないまま済ませる
  • 「本当に使えるか」を確かめようとして、漏れた鍵を自分で使ってみる
  • 検査の結果を共有するために、鍵の全体をチャットや Issue に貼る(マスクされた表示を使います)

#見えない部分

検査が見つけられないもの

使い捨ての VM で確かめた範囲では、次のようなことがあります。

  • 鍵の片方だけでは、見つからないことがある。AWS の鍵は、AKIA で始まる「アクセスキー ID」と、決まった形がない「シークレットアクセスキー」の 2 つで 1 組です。シークレットアクセスキーだけを検査すると、「検出されませんでした」と表示されました。ID と一緒に書いてあれば、ID が検出されます
  • 「検出されませんでした」と表示されても、鍵がない証明にはならない。意味は「知っている形式の鍵は見つからなかった」です。独自の形式の鍵や、名前が付いていない文字列は、検査の対象外です
  • 検査は文字列を読むだけで、その鍵がまだ有効かどうかは確かめません。有効かどうかは、発行元でしか分かりません
  • おとりは、honeytokens_home の下だけにあります。既定の /root のとき、一般のアカウントのホームにはありません。本物の鍵だけを狙って読む相手には、おとりは反応しません
  • ふつうの ssh は、おとりの鍵を試しても知らせません。知らせるのは、ssh -i・ssh-add・ssh-keygen などで、おとりを名指しして読んだときです
確認問題

シークレットアクセスキーだけを検査したら、「検出されませんでした」と表示されました。正しい解釈はどれですか

解説を見る

この検査は、形式(AKIA で始まるなど)を手がかりに探します。決まった形がない文字列は、鍵であっても見つけられません。「見つからない」ことは、「ない」ことと同じではありません。

#次に学ぶこと

扱う機能

対応する攻撃手法 (ATT&CK): T1204.004 T1552.001

確認した内容

2026-11-13に確認しました。対象は Linux 1.17.41 です。公開版 1.17.41 の入った使い捨ての Ubuntu 24.04 の VM で、AWS の公式文書の無効なサンプルキーと、同じ VM の sshd に向けた ssh で全演習を日本語と英語で上から実行し、日本語で記録したおとりの通知を LANG=en_US.UTF-8 で読みました。

コマンドの出力は、製品の版や環境によって変わります。違いが出たら、まず製品の版を確かめてください。