1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

外部コマンドが失敗すると例外メッセージに API キーが出る:Python の CalledProcessError と Node の Command failed(実機確認)

1
Posted at

結論

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)でも短く流しています。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?