【とらすてっどぱぶりっしんぐ】

Trusted Publishing とは?

公開:
💡 パッケージ公開に、長期キーではなくCIの身分証を
📌 このページのポイント
CIの身分証で、パッケージ公開 CIの公開処理OIDCのID情報PyPI公開元と照合照合後に発行短期トークン期限内も要保護パッケージ公開公開するコードの安全性は、別に確認
PyPIの例。紙は短期APIトークン、箱はパッケージの比喩です。公開元とCIの保護は必要で、短期の認証情報も漏らしてはいけません。公開物の安全性を保証する仕組みではありません。
ひよこ ひよこ
Pythonのパッケージ公開用キーをCIに置くのが心配。
ペンギン先生 ペンギン先生
PyPIのTrusted Publishingでは、CIが発行するOIDCのID情報を使えるよ。PyPI側に信頼する公開元を登録し、合うID情報を確認すると、公開用の短期APIトークンを受け取れるんだ。
ひよこ ひよこ
手作業でAPIトークンを作らなくていい?
ペンギン先生 ペンギン先生
この方法では長期トークンを作ってCIへコピーする必要を減らせるよ。ただ、公開元の設定は必要だし、対応するCIサービスやワークフローを使う必要があるんだ。
ひよこ ひよこ
短期トークンは、どれくらい使える?
ペンギン先生 ペンギン先生
PyPIの公式説明では発行後15分以内に失効するよ。期限が短くても、その間は公開権限を持つ情報なので、ログなどへ漏らさないことが大切だね。
ひよこ ひよこ
Trustedなら、パッケージの中身も信頼できる?
ペンギン先生 ペンギン先生
公開の認証方法の名前で、コードが安全という評価ではないよ。登録したCIやワークフローが侵害されれば公開にも影響する。信頼するリポジトリや公開用の処理を限定して保護しよう。
もっと詳しく知りたい人へ

署名付きのattestationと同じ仕組み?

Trusted Publishingは公開時の認証を扱います。attestationは成果物の来歴などを示す情報です。公開できる主体の確認と、公開された成果物の検証は役割が違い、組み合わせて使えます。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「Trusted Publishing」って出てきたら「CIのIDを使い、短期トークンでパッケージを公開する方法」と思えばだいたいOK!
📖 おまけ:英語の意味
「Trusted Publishing」 = 信頼する公開元による公開
💬 Trustedは信頼する、Publishingは公開するという意味だよ。ここでの信頼は、設定した公開元のIDを受け入れるという意味で、コードの安全性の評価ではないんだ。

参考資料

← 用語集にもどる