npmのOIDC設定、新規パッケージで詰まってない?「setup-npm-trusted-publish」

setup-npm-trusted-publish
まだ無い npm パッケージに OIDC 公開を設定するため、仮パッケージを公開する CLI
GitHub
公開
正式公開 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 の設定のためのもので、名前の先取りのためのものではないと明記されています。仮パッケージは、なるべく早く実際のパッケージに置き換えるよう求められています。