#秘密情報は、どこから漏れるのか
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 -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/.ssh0
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_rsa256 SHA256:+u582zTn/dRT7LZ8LovXk3FNv0yZr+EW8SekadPdPfA ROAMSWITCH_HONEYTOKEN decoy - not a real key, do not use (ED25519)コメントに印があり、本物の鍵と取り違えません。鍵はホストごとに作るので、別の VM では指紋が違いました。この ssh-keygen も、おとりの読み取りとして通知に入りました。
#見つかったとき、最初にすること
順番が大切です。
- 発行元で、その鍵を無効にする。先に Git の履歴を直したり、ファイルを消したりしないでください。その間も、鍵は使えるままです
- 使われた形跡を調べる。発行元の操作ログ(AWS なら CloudTrail など)で、身に覚えのない操作がないかを確かめます
- 新しい鍵を発行して、差し替える。差し替えたあと、正しく動くかを確かめます
- ソースから取り除く。秘密情報はコードやビルドに含めず、動かす側(サーバーの環境変数や、秘密情報を管理する仕組み)に置きます
- 再発を防ぐ。コミットの前や、ビルドの最後に、検査が自動で動くようにします
- 鍵を消しただけで、無効にしないまま済ませる
- 「本当に使えるか」を確かめようとして、漏れた鍵を自分で使ってみる
- 検査の結果を共有するために、鍵の全体をチャットや Issue に貼る(マスクされた表示を使います)
#見えない部分
使い捨ての VM で確かめた範囲では、次のようなことがあります。
- 鍵の片方だけでは、見つからないことがある。AWS の鍵は、
AKIAで始まる「アクセスキー ID」と、決まった形がない「シークレットアクセスキー」の 2 つで 1 組です。シークレットアクセスキーだけを検査すると、「検出されませんでした」と表示されました。ID と一緒に書いてあれば、ID が検出されます - 「検出されませんでした」と表示されても、鍵がない証明にはならない。意味は「知っている形式の鍵は見つからなかった」です。独自の形式の鍵や、名前が付いていない文字列は、検査の対象外です
- 検査は文字列を読むだけで、その鍵がまだ有効かどうかは確かめません。有効かどうかは、発行元でしか分かりません
- おとりは、
honeytokens_homeの下だけにあります。既定の/rootのとき、一般のアカウントのホームにはありません。本物の鍵だけを狙って読む相手には、おとりは反応しません - ふつうの
sshは、おとりの鍵を試しても知らせません。知らせるのは、ssh -i・ssh-add・ssh-keygenなどで、おとりを名指しして読んだときです
シークレットアクセスキーだけを検査したら、「検出されませんでした」と表示されました。正しい解釈はどれですか
解説を見る
この検査は、形式(
AKIAで始まるなど)を手がかりに探します。決まった形がない文字列は、鍵であっても見つけられません。「見つからない」ことは、「ない」ことと同じではありません。
#次に学ぶこと
- 公開の場所に鍵が出たときの手順は、鍵やトークンが公開されたとき で練習できます
- おとりが依存パッケージに読まれた場面は、依存パッケージが乗っ取られていたとき で扱います
- 依存パッケージを通じて秘密情報が盗まれる経路は、サプライチェーン攻撃 で学べます
2026-11-13に確認しました。対象は Linux 1.17.41 です。公開版 1.17.41 の入った使い捨ての Ubuntu 24.04 の VM で、AWS の公式文書の無効なサンプルキーと、同じ VM の sshd に向けた ssh で全演習を日本語と英語で上から実行し、日本語で記録したおとりの通知を LANG=en_US.UTF-8 で読みました。
コマンドの出力は、製品の版や環境によって変わります。違いが出たら、まず製品の版を確かめてください。