結論
API キーをコマンドの引数に入れて外部コマンドを呼ぶと、そのコマンドが失敗したときの例外メッセージにキーがそのまま入りました(ダミーのキーで確認)。
- Python 3.13:
subprocess.run(..., check=True)のCalledProcessError→Command '['curl', ..., 'Authorization: Bearer sk-dummy-...']' returned non-zero exit status 7. - Python 3.13:
timeout=で止まったときのTimeoutExpiredにも同じく引数が全部入った - Node.js 24:
execSync/execFileSyncの例外 →Command failed: curl -sS -f -H Authorization: Bearer sk-dummy-...
ヘッダを標準入力から渡す(curl -H @-)と、どちらの例外メッセージにもキーは出ず、サーバにはヘッダが届きました。
この例外メッセージは、ログやターミナルにそのまま出るものです。AIエージェントにスクリプトを実行させると、失敗時の出力も会話の記録に入ると考えられます(推測。エージェントごとの記録内容はこの記事では確かめていません)。
試した環境
- Python 3.13.5、Node.js v24.22.1、curl 8.14.1(Linux)
- 失敗させる相手は閉じたポート(
http://127.0.0.1:9/)と、401 を返すローカルの小さなサーバ - キーはダミー(
sk-dummy-1234567890abcdef)
1. Python:CalledProcessError にキーが入る
import subprocess
key = "sk-dummy-1234567890abcdef" # ダミー
subprocess.run(["curl", "-sS", "-f", "-H", f"Authorization: Bearer {key}",
"http://127.0.0.1:9/v1"], check=True)
実行結果(最後の行):
subprocess.CalledProcessError: Command '['curl', '-sS', '-f', '-H', 'Authorization: Bearer sk-dummy-1234567890abcdef', 'http://127.0.0.1:9/v1']' returned non-zero exit status 7.
トレースバックのソース行は f"Authorization: Bearer {key}" のまま(展開されない)でしたが、最後の例外メッセージには展開後の値が入っています。例外の cmd 属性に渡した引数がそのまま入っているためです(help(subprocess.CalledProcessError) の Attributes に cmd があります)。
try で受けて str(e) や logging.exception() で出しても同じでした。
str(e): Command '['curl', '-sS', '-f', '-H', 'Authorization: Bearer sk-dummy-1234567890abcdef', 'http://127.0.0.1:9/v1']' returned non-zero exit status 7.
capture_output=True にしても、メッセージに入るのは引数なので変わりません。
タイムアウトでも出る
subprocess.run(["python3", "-c", "import time;time.sleep(5)", f"--token={key}"], timeout=0.5)
Command '['python3', '-c', 'import time;time.sleep(5)', '--token=sk-dummy-1234567890abcdef']' timed out after 0.5 seconds
2. Node.js:Command failed にキーが入る
const { execSync, execFileSync } = require("child_process");
const key = "sk-dummy-1234567890abcdef"; // ダミー
execSync(`curl -sS -f -H "Authorization: Bearer ${key}" http://127.0.0.1:9/v1`, { stdio: "pipe" });
execFileSync("curl", ["-sS", "-f", "-H", `Authorization: Bearer ${key}`, "http://127.0.0.1:9/v1"], { stdio: "pipe" });
それぞれの例外の message の1行目:
[execSync] Command failed: curl -sS -f -H "Authorization: Bearer sk-dummy-1234567890abcdef" http://127.0.0.1:9/v1
[execFileSync] Command failed: curl -sS -f -H Authorization: Bearer sk-dummy-1234567890abcdef http://127.0.0.1:9/v1
シェルを通さない execFileSync でも出ました。シェルを通すかどうかではなく、「引数に書いたかどうか」で決まります。
3. 対策:キーは引数でなく標準入力で渡す
curl の -H は @ファイル名 の形を受け付け、@- なら標準入力から読みます(curl --manual の -H の説明に "Using @- makes curl read the header file from stdin." とあります)。
subprocess.run(["curl", "-sS", "-f", "-H", "@-", "http://127.0.0.1:18080/v1"],
input=f"Authorization: Bearer {key}\n", text=True,
capture_output=True, check=True)
str: Command '['curl', '-sS', '-f', '-H', '@-', 'http://127.0.0.1:18080/v1']' returned non-zero exit status 22.
key in str: False
受け側のローカルサーバのログ:
GOT Authorization: Bearer sk-dummy-1234567890abcdef
Node.js でも input で渡すと、メッセージは Command failed: curl -sS -f -H @- http://127.0.0.1:9/v1 で、キーは入りませんでした。
execFileSync("curl", ["-sS", "-f", "-H", "@-", "http://127.0.0.1:9/v1"],
{ stdio: "pipe", input: `Authorization: Bearer ${key}\n` });
引数に書いたキーは、実行中に別ユーザーの ps からも見えます(以前の記事 で確認)。標準入力で渡せば、その経路も引数には残りません(この記事では ps は再確認していません)。
ほかの選択肢
- そもそも外部コマンドを使わず、Python なら HTTP ライブラリ、Node.js なら
fetchで送る(ただし、ライブラリのデバッグ出力やエラーの丸ごと出力でキーが出る例は requests・axios の記事で確認しています) - 例外を受けてログに出すときは、
e.cmdやe.messageをそのまま出さず、終了コード(e.returncode/e.status)だけにする
試してみる
ai-secret-check の scan-code は、今のところこのパターン(引数に Authorization を入れた subprocess / execFileSync)を検出しません。この記事のサンプル2つを scan-code にかけると「候補は見つかりませんでした」でした。検出の追加は Issue で検討します。今ある scan-code は、debuglevel=1・URL の ?api_key=・エラーの丸ごと出力・curl -v と認証の同時指定などを知らせます(値は出しません)。
npx github:supportapp3-lab/ai-secret-check scan-code .
まとめ
- 引数に入れたキーは、Python の
CalledProcessError/TimeoutExpired、Node.js のCommand failedにそのまま入った - シェルを通さない
execFileSyncでも同じ -
curl -H @-で標準入力から渡すと、例外メッセージには入らず、ヘッダは届いた - 例外をログに出すときは終了コードだけにする
参考
AIエージェントと鍵まわりを実機で確かめた結果は X(@supportapp3_lab)でも短く流しています。