0
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?

npm run deploy -- --token=キー と渡すと、画面にも ~/.npm/_logs にも平文で残る:--silent でもログファイルには出て、npm トークンだけ伏せ字になった(npm 11.21で確認)

0
Posted at

先に結論

npm run <スクリプト> -- --token=<キー> のように、npm run の引数で API キーを渡すと、手元の npm 11.21.1 では次の3か所に平文で出ました。

出る場所 出たか 消し方
ターミナル(> node deploy.js --token=... の行) 出た --silent(--loglevel=silent)
デバッグログ(既定は ~/.npm/_logs/*-debug-0.log) 成功しても出た --logs-max=0
実行中の ps(npm・sh・node の3プロセス) 出た 引数で渡さない

npm_ で始まる npm トークンと、URL に書いた Basic 認証のパスワードは *** に置き換わりましたが、それ以外の形のキー(今回は sk-test-... のダミー)はそのままでした。

一番安全だったのは、キーを引数に書かず、環境変数のままスクリプトに読ませる書き方です(ログ・画面・ps のどこにも出ませんでした)。

使った値はすべてダミーです。

環境

  • Linux、Node.js v24.22.1、npm 11.21.1
  • ログの場所を確かめやすいように、検証中は NPM_CONFIG_LOGS_DIR で作業フォルダに向けました(既定の場所は後述)
package.json
{
  "name": "demo-argv",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "deploy": "node deploy.js",
    "deploy:env": "node deploy.js --token=$DEMO_TOKEN",
    "deploy:safe": "node deploy-env.js",
    "wait": "node sleep.js"
  }
}
deploy.js
console.log("deploy ok, args=", process.argv.length - 2)
deploy-env.js
const t = process.env.DEMO_TOKEN; console.log("deploy ok, token set:", Boolean(t))

1. 引数で渡すと、画面とログファイルの両方に出る

$ npm run deploy -- --token=sk-test-DUMMY0123456789

> demo-argv@1.0.0 deploy
> node deploy.js --token=sk-test-DUMMY0123456789

deploy ok, args= 1

npm はスクリプトを動かす前に、実行するコマンド行を > 付きで表示します。-- のあとの引数もここに入るので、キーがそのまま出ました。CI のログに残るのはこの行です。

そして、コマンドが成功してもデバッグログのファイルが作られ、そこにも入っていました。

*-debug-0.log(抜粋)
7 verbose title npm run deploy --token=sk-test-DUMMY0123456789
8 verbose argv "run" "deploy" "--" "--token=sk-test-DUMMY0123456789"
9 verbose logfile logs-max:10 dir:.../2026-11-20T20_15_10_268Z-
16 verbose exit 0

exit 0 でも書かれていて、logs-max:10 のとおり最新10回分が残ります。公式ドキュメント(Logging)にも「すべてのログはデバッグログに書かれる」「既定の場所は npm キャッシュの中の _logs」とあります。手元のキャッシュは npm config get cache で ~/.npm だったので、既定なら ~/.npm/_logs/ です。

2. npm トークンと URL のパスワードだけは伏せ字になった

$ npm run deploy -- --token=npm_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789
> node deploy.js --token=npm_***

$ npm run deploy -- --url=https://user:sk-test-DUMMYurl555@example.com/x
> node deploy.js --url=https://user:***@example.com/x

公式ドキュメントの「Logs and Sensitive Information」には、伏せる対象は「basic 認証 URL のパスワード」と「npm トークン」で、ベストエフォートだから頼らないように、と書かれています。実際、sk-test-... のような他サービス風のキーは1章のとおり伏せられませんでした。

3. --silent だけでは、ログファイルには残る

$ npm run --loglevel=silent deploy -- --token=sk-test-DUMMYsilent111
deploy ok, args= 1

画面の > 行は消えました。ところがログファイルは1つ作られていて、中身はこうでした。

8 verbose argv "run" "--loglevel" "silent" "deploy" "--" "--token=sk-test-DUMMYsilent111"

画面が静かになったので消えたと思いがちですが、ファイル側は別でした。ここが今回いちばん意外だった点です。

4. --logs-max=0 を足すと書かれない(既存のログも消えた)

$ ls repro_logs | wc -l
1
$ npm run --loglevel=silent --logs-max=0 deploy -- --token=sk-test-DUMMYboth222
deploy ok, args= 1
$ ls repro_logs | wc -l
0

新しいログは作られず、それまであった1件も消えていました。公式ドキュメントでは --logs-max=0 は「ログを完全に止める」設定で、--loglevel=silent と組み合わせるよう案内されています。古いログが消えたのは手元で見た挙動で、ドキュメントの「上限を超えたら古い順に消す」動きが 0 件に対して働いたのだと思います(推測)。調査用にログを残しておきたい場合は注意が必要です。

5. 実行中は ps にも3つ並ぶ

$ ps -eo args | grep DUMMYps444
npm run wait --token=sk-test-DUMMYps444
sh -c node sleep.js --token=sk-test-DUMMYps444
/usr/local/lib/nodejs/node sleep.js --token=sk-test-DUMMYps444

npm 本体のプロセス名、間に入る sh -c、実際の node の3つすべてに入りました。同じマシンの別ユーザーから見える点は、コマンド引数一般の話として以前の記事(https://qiita.com/supportapp3/items/cd1f04df4b681507e3e1 )で確かめたとおりです。

--silent --logs-max=0 は画面とファイルには効きますが、ここは消せません。

6. package.json に $DEMO_TOKEN と書く場合

$ DEMO_TOKEN=sk-test-DUMMYenv999 npm run deploy:env
> node deploy.js --token=$DEMO_TOKEN

画面の > 行は展開前の $DEMO_TOKEN のままで、npm の argv にも入らないのでログファイルにも出ませんでした。ただし展開するのは間の sh なので、実行中の node は ps 上で node deploy.js --token=sk-test-DUMMYenv999 と展開後の値になっていました。

7. 出なかった書き方:環境変数をスクリプトで直接読む

$ DEMO_TOKEN=sk-test-DUMMYsafe333 npm run deploy:safe
> node deploy-env.js

deploy ok, token set: true
$ grep -c DUMMYsafe333 repro_logs/*
(0件)

process.env.DEMO_TOKEN をスクリプトの中で読むだけなら、画面・ログファイル・ps の引数のどこにもキーは出ませんでした。CI ならシークレットを環境変数に入れて、この形で読ませるのが手堅いと考えます。

すでに引数で渡していた場合

# 自分のログに残っていないか(既定の場所)
grep -l -- '--token=' ~/.npm/_logs/*.log
# CI で一時的に止めるなら
npm run --silent --logs-max=0 deploy

見つかったキーは、ログを消すより先に発行元で無効化して作り直すのが確実です。CI の画面ログは、npm の外(CI 側)に保存されているので、そちらの削除も必要です。

まとめ

  • npm run x -- --token=キー は、画面・~/.npm/_logs のデバッグログ(成功時も)・ps の3か所に出た
  • 伏せ字になるのは npm トークンと URL のパスワードだけ(公式にもベストエフォートと明記)
  • --silent は画面だけ。ファイルも止めるには --logs-max=0(手元では既存ログも消えた)
  • キーは引数にせず、環境変数をスクリプトで読む

参考

0
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
0
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?