npmのOIDC設定、新規パッケージで詰まってない?「setup-npm-trusted-publish」
- 公開
- 正式公開 2025-09-06
- 作り手
- azu(個人)
- 対応
- CLI(npm パッケージ)
- 価格
- 無料(MIT ライセンス)
- 評価
- GitHub のスター 68(2026-10-14)
どんなアプリか
npm パッケージに OIDC(OpenID Connect)の Trusted Publishing を設定するための CLI です。中身の無い最小限の仮パッケージを公開し、そのあとで npmjs.com から OIDC の公開設定ができる状態にします。
README によると、PyPI はまだ存在しないパッケージにも OIDC を設定できますが、npm ではパッケージが先に存在していないと Trusted Publishing を設定できません。この制約を回避するために作られました。
This tool provides a responsible way to “reserve” a package name for OIDC setup by creating a package that:
- Clearly communicates its purpose
- Cannot be mistaken for a functional package
- Enables the OIDC configuration workflow
azu さん、GitHub の README「Why is this needed?」
コマンドにパッケージ名を渡すと、一時ディレクトリに package.json と README.md を作って公開し、一時ディレクトリを片付けたうえで、OIDC を設定するページへのリンクを表示します。生成される README には、動くパッケージではないこと、コードを含まないこと、依存として使わないことが明記されます。
グローバルにインストールするほか、npx や pnpm dlx から直接実行することもできます。pnpm から起動したときは pnpm publish で、それ以外は npm publish で公開します。オプションは、公開せずにパッケージを作る –dry-run、スコープ付きパッケージの公開範囲を選ぶ –access、レジストリの URL を指定する –registry、仮パッケージのバージョンを指定する –package-version です。
同じ分野のアプリ
| 名前 | 型 | 仕掛け | 対応 | 料金 |
|---|---|---|---|---|
| setup-npm-trusted-publish | 公開の準備 | 仮パッケージを公開して、OIDC の Trusted Publishing を設定できる状態にする | CLI(npm パッケージ) | 無料(MIT ライセンス) |
| 小姑(kojuto) | セキュリティ検査 | サンドボックスでインストールさせ、システムコール監視で悪性パッケージを見抜く | CLI(PyPI / npm、Docker 使用) | 無料(MIT) |
| Modulist | パッケージ管理 | VS Code の中で npm パッケージの追加・削除・情報確認を完結させる | VS Code 拡張 | 無料 |
| Rolldphobia | サイズ計測 | Tree-shaking 後のバンドルサイズを Rolldown と esm.sh でブラウザ上で計算する | Web | 無料(OSS, MIT) |
入れる前に
OIDC の Trusted Publishing と公開時の MFA 要件の設定は、この CLI では行いません。仮パッケージを公開したあと、npmjs.com のパッケージのアクセス設定ページで自分で設定します。npm trust と npm access set mfa=… は対話式の 2FA の OTP が必要で、NPM_TOKEN では動かせないため、意図して外してあると説明されています。
npm 11.10.0 以降には、仮パッケージを公開せずに Trusted Publishing を設定できる npm trust コマンドがあります。README は、これらのコマンドが対話式で使えるなら、このツールを使わずに直接実行するよう案内しています。
手元で npm login をしていない場合は、環境変数 NPM_TOKEN でトークンを渡せます。トークンはディスクに書き込まれません。README は、有効期限を最短の7日にした Granular Access Token を作り、公開後に取り消す手順を示しています。
既知の制限として、pnpm 11 では、すでに公開済みのバージョンに重ねて公開しようとしたとき、公開を飛ばさずにエラーで終了します。npm、pnpm 10、pnpm 12 では、これまでどおり公開を飛ばします。公開に失敗しても、もう一方のパッケージマネージャーで再試行はしません。
このツールは OIDC の設定のためのもので、名前の先取りのためのものではないと明記されています。仮パッケージは、なるべく早く実際のパッケージに置き換えるよう求められています。