PyPIのプロジェクトページが刷新され、より明確なセキュリティシグナルが表示されるようになりました
PyPI's redesigned project pages with clearer security signals are now live (blog.pypi.org)
要約
PyPIは、ユーザー調査に基づき、プロジェクトページのUIを刷新しました。新しい「セキュリティ」タブでは、パッケージのリリースファイルに関する「プロビナンス(出所)」情報やアテステーション(証明)の詳細が表示され、セキュリティリスクの評価が容易になります。また、プロビナンスに関する警告表示も追加され、潜在的なリスクをユーザーに通知します。
全文翻訳
PyPIのプロジェクトページが刷新され、より明確なセキュリティシグナルが表示されるようになりました
7月には、PyPIユーザーインターフェースへの一連の計画されたアップデートを発表しました。このアップデートは、Pythonコミュニティのメンバーとのユーザーリサーチに基づいており、セキュリティシグナルを提示する方法とパッケージの詳細の表示方法を改善することを目的としています。
この作業が完了し、PyPIで公開されたことをお知らせできることを嬉しく思います。
背景
Pythonエコシステムの急速な成長に伴い、PyPIは悪意のある攻撃者にとってますます魅力的な標的となっています。これに対応するため、PyPIチームは多くのセキュリティ機能を提供するとともに、PyPIユーザーがパッケージのセキュリティを評価し理解するのを支援する上で、より積極的な役割を担ってきました。
2024年に導入されたデジタルアテステーションは、この取り組みの一例であり、リリースファイルのプロビナンス(出所)(どこから来たか)の検証可能な記録を提供します。しかし、プロビナンスとアテステーションは多くのPyPIユーザーにとってまだ馴染みのない概念であり、PyPIのインターフェースはそれらの意味、重要性、または制限を伝える上でほとんど役立っていませんでした。
この問題に対処するため、PyPIはKabu Creativeと提携し、OpenSSF Attestations Style Guideで開発された推奨事項を実装して、PyPI UIに明確なセキュリティシグナルをもたらしました。
ここでは、何が変更され、それがあなたにとって何を意味し、どのような行動を取れるかを見ていきます。
新しいセキュリティタブ
新しいセキュリティタブは、リリースプロビナンスの状態を伝え、ファイルごとのアテステーションを表示し、リリースファイルの出所を確認するための専用の場所を提供します。
[画像: プロジェクト詳細ページのタブ:説明、リリースファイル、セキュリティ(選択中)、リリース履歴]
PyPIプロジェクト詳細ページの新しいセキュリティタブ
プロビナンスの状態
PyPIは、各リリースファイルのプロビナンス状態をチェックすることで、各リリースのプロビナンス状態を計算します。通常、リリースは次のいずれかの状態になります。
完全なプロビナンス
これは、リリースファイルの100%にアテステーションがあり、サポートされているアテステーションタイプのいずれか、または両方を含んでいることを意味します。
PyPI Publishアテステーションは、ファイルがPyPI Trusted Publisherによって公開されたことを確認します。
[画像: PyPI上のPyPI Publishアテステーション]
PyPI上のPyPI Publishアテステーション
SLSA Build Provenanceアテステーションは、ファイルを正確なソースコミット、ビルドプラットフォーム、および指示にリンクします。
[画像: PyPI上のSLSA Build Provenanceアテステーション]
PyPI上のSLSA Build Provenanceアテステーション
アテステーションメタデータをUIで直接確認するか、トランスペアレンシーログリンクをクリックして詳細を確認できます。
プロビナンスなし
「プロビナンスなし」とは、単にリリース内のどのファイルにもアテステーションがないことを意味します。これは、古いリリースや、まだTrusted Publishingを構成していないプロジェクトによく見られます。プロビナンスがないことは、必ずしもリリースファイルが悪意のあるものであることを示すものではありません。むしろ、ファイルの出所が暗号学的に検証できないことを意味します。
プロビナンスがない場合は、メンテナーの履歴、リリースパターン、リポジトリのアクティビティなど、周囲の信頼シグナルに依存してセキュリティを評価する必要があります。パッケージを管理している場合は、次のリリースでアテステーションを生成するパブリッシャーを使用したTrusted Publishingの使用を検討してください。
プロビナンスの警告
プロビナンスの警告は、ファイルがプロジェクトのメンテナーから提供されたものではない可能性がある場合(例:アカウントが侵害された、または公開ワークフローが侵害された場合)を特定するのに役立つように設計されています。
プロビナンスメタデータが異常に見えたり、プロジェクトの履歴と矛盾したりする場合、PyPIは目立つ警告を表示します。多くの警告には正当な説明がありますが、それぞれ確認する価値があります。
不完全なプロビナンス
これは、一部のファイルにはアテステーションがあるが、他のファイルにはないことを意味します(例:ホイールはTrusted Publishing経由で公開されましたが、ソースtarballはAPIトークンを使用してアップロードされました)。
この警告が表示された場合は注意してください。インストールする前に、ビルドの問題に関するリリースノートを確認するか、プロジェクトのissueトラッカーで質問してください。
一貫性のないプロビナンス
この警告は、同じリリース内のファイルが異なるビルドシステムまたはソースリポジトリに由来することを示しています。
アテステーションメタデータを確認して、すべてのファイルがメンテナーによって制御されているソースから来たかどうかを確認してください。
プロビナンスの変更
この警告は、リリースファイルが以前のリリースとは異なるリポジトリまたはワークフローに由来することを示しています。多くの場合正当な理由(組織名の変更やリポジトリの移行など)がありますが、パイプラインの侵害やアカウントの乗っ取りを示す可能性もあります。
この警告が表示された場合は、インフラストラクチャの移行が計画されていたことを確認するために、プロジェクトのリリースノートまたは公式チャネルを確認してください。
プロビナンスの喪失
これは、以前はアテステーション付きで公開していたプロジェクトが、アテステーションなしでリリースファイルをアップロードするようになったことを意味します。
メンテナーが公開プロセスを意図的に変更したかどうかを確認してください。例えば、APIトークンに戻したり、アテステーションを生成しなくなったように公開設定を変更したりした場合などです。これが予期しない場合は、確認されるまで懐疑的にリリースを扱ってください。
プロビナンスとアテステーション、およびプロビナンスの警告についてさらに詳しく知るには、ユーザー向けドキュメントを参照してください。
[画像: 不完全なプロビナンスのバナーが上部に表示され、セキュリティタブが開いており、不完全なプロビナンスの警告が表示されているプロジェクト詳細ページの例:5ファイル中2ファイルがプロビナンスメタデータなしでアップロードされました]
PyPI上のプロビナンス警告の例。不完全なプロビナンスを持つリリースを示しています。
再設計されたプロジェクト詳細ページ
これらの変更をサポートするために、プロジェクト詳細ページも更新されました。
- プロビナンスの警告は、ヤンクされたリリース、アーカイブされたプロジェクト、およびプレリリースに関するステータスバナーとともに、ページの先頭に表示されるようになりました。プロジェクトまたはリリースが隔離されている場合、隔離バナーのみが表示されます。これは、他のすべての警告およびバナーよりも優先されるためです。
- リリースに完全なプロビナンスまたはプロビナンスの警告がある場合、そのプロビナンス状態がサイドバーに表示され、詳細についてはセキュリティタブにリンクされます。
- メタデータは、ユーティリティ別に並べ替えられ、「PyPIデータ」または「PyPIによって検証されたデータ」とラベル付けされるようになりました。これは、データが検証ステータス別にグループ化および並べ替えられていた古いデザインに取って代わるものです。
[画像: プロジェクトリンク、主要な日付、メンテナー、クレジット、GitHub統計、および「PyPIデータ」または「PyPIによって検証されたデータ」とラベル付けされた「完全なプロビナンス」を示すプロビナンスパネルを含む、再設計されたメタデータサイドバー]
ユーティリティ別に並べ替えられた情報の、再設計されたメタデータサイドバー
リリースファイルとリリース履歴
再設計されたリリースファイルタブは、長いリストの検索とフィルタリングにより、適切なファイルを見つけるのに役立ちます。テーブル内で各ファイルのプロビナンス状態を表示することもでき、遅延ファイル(オレンジ色の警告アイコンでマークされています)をすばやく特定できます。
遅延ファイル警告は、1つ以上のファイルが最初のリリースタイムスタンプから14日以上経過してアップロードされた場合に表示されます。これらの警告は、14日以降の新規ファイルの拒否ポリシーが導入された2026年7月より前のリリースにのみ表示されます。
リリース履歴タブも、各リリースに関する詳細情報を提供するようになり、ファイル数、プロビナンス状態、およびリリースステータス(隔離、ヤンク、アーカイブ、またはプレリリース)が表示されます。
[画像: 5つのリリースがリストされたリリース履歴タイムライン。各リリースには日付、リリースファイル数、および完全なプロビナンス状態が表示されています。1つはプレリリースとラベル付けされ、別の1つはメンテナーによって理由が示されたヤンク済みとラベル付けされています]
リリースステータス、ファイル数、およびプロビナンス状態が表示された再設計されたリリース履歴タブ
ヘルプの入手
インターフェースのアップデートと並行して、PyPIのユーザー向けドキュメントが拡張され、パッケージセキュリティのナビゲーションが向上しました。パッケージセキュリティガイドを読んで、以下について学びましょう。
今後の展望と謝辞
新しいセキュリティタブにより、PyPIは将来のさまざまなアテステーションタイプやセキュリティ通知のための専用の場所を持つことになります。この作業の恩恵をより広いオープンソースエコシステムが受けられるように、このプロジェクト中に開発された設計パターンと警告を詳述したケーススタディをOpenSSF Attestations Style Guideで公開しました。
この取り組みはOpen Source Security Foundationによって資金提供され、Kabu Creativeによって実装されました。この取り組みを推進してくれたDustin Ingram、Zach Steindler、およびOpenSSF Securing Software Repositories Working Groupのメンバーに感謝します。特に、Mike Fiedler、Jacob Coffee、およびPyPIチームのメンバーには、思慮深いデザインフィードバックとコードレビューに感謝します。@cofiemには新しいリリースファイルタブへの貢献に感謝します。また、ユーザーインタビュー参加者およびコミュニティテスターには、最終デザインの形成に協力してくれたことに感謝します。
最後に、OpenSSFの資金提供と、Pythonパッケージングエコシステムのセキュリティ確保における継続的なパートナーシップに感謝します。