PaPoo
cover
technews
Author
technews
世界の技術ニュースをリアルタイムでキャッチし、日本語でわかりやすく発信。AI・半導体・スタートアップから規制動向まで、グローバルテックシーンの「今」をお届けします。

PyPIが「どこから来たファイルか」を見せるようになった理由

Python のパッケージ配布基盤である PyPI が、プロジェクトページの見た目と情報の出し方を大きく改めた。単なるデザイン変更ではなく、release file の由来や attestation を前面に出して、利用者が安全性を判断しやすくするのが狙いだ。パッケージの供給網を狙う攻撃が増える中で、見た目の刷新とセキュリティ表示を結びつけたのはかなり実務的な一歩だと思う。元記事では、何が変わったのかだけでなく、利用者がどう読めばよいかまで丁寧に説明している。

PyPI の新しい project page で見えるようになった security signal

PyPI は 7月に、ユーザー調査を踏まえた UI 更新の予定を公表していた。今回の記事は、その作業が完了し、すでに本番の PyPI で反映されていると伝えている。背景にあるのは、Python エコシステムの拡大で PyPI が悪意ある攻撃者にとって魅力的な標的になっていることだ。そこで PyPI チームは、これまでも security feature を増やしてきたが、今度は「利用者が安全性をどう見分けるか」により踏み込んだ。

中核にあるのは digital attestation だ。これは 2024年に導入された仕組みで、release file がどこから来たのかを暗号学的にたどれる証跡になる。ただし、この provenance や attestation という概念は、まだ多くの PyPI 利用者にとってなじみが薄い。しかも従来の UI は、その意味や限界を十分に伝えていなかった。そこで PyPI は Kabu Creative と組み、OpenSSF の Attestations Style Guide に沿って表示を組み直したという。

新しく追加されたのが security tab だ。ここでは release provenance state が表示され、各 file ごとの attestation も見られる。PyPI は release の provenance state を、各 release file に attestation があるかどうかで計算する。全部の file に attestation があれば Full Provenance で、PyPI Trusted Publisher による PyPI Publish attestation か、あるいは SLSA Build Provenance attestation が付いている。前者はその file が Trusted Publisher から公開されたことを示し、後者は source commit、build platform、instructions まで exact にひもづく。UI から metadata を見られるだけでなく、transparency log へのリンクもある。

一方で No Provenance は、release 内のどの file にも attestation がない状態を指す。古い release や、まだ Trusted Publishing を設定していない project では普通に起こりうる。ただし「attestation がない」ことは「悪意がある」という意味ではない。暗号学的に origin を検証できない、というだけだ。そうした場合は maintainer の履歴、release の並び方、repository の活動状況など、周辺の信号で判断してほしいと記事は促している。

さらに PyPI は provenance warning も導入した。これは、attestation の見え方がその project の履歴と食い違うときに出る警告だ。たとえば Incomplete Provenance は、wheel には attestation があるのに source tarball にはない、といったケースを指す。Inconsistent Provenance は、同じ release の file が別々の build system や source repository から来ていることを示す。Change of Provenance は、前回の release と違う repository や workflow から来た場合に出るが、組織名の変更や repository migration のように正当な理由もある。Loss of Provenance は、以前は attestation 付きで出していた project が、突然 attestation なしで file を上げるようになったときの警告だ。これらはすべて、すぐに危険だと断定するためではなく、確認すべき違和感を表に出すためのものだ。

project detail page も組み替えられた。provenance warning は yanked release、archived project、pre-release などの状態バナーと同じくページ上部に出る。ただし quarantine された project や release がある場合は、それが最優先で単独表示になる。full provenance か warning がある release では、sidebar に provenance state が出て security tab へつながる。metadata の並び順も変わり、以前のように verification status でまとめるのではなく、utility ベースで並べて「PyPI data」「Data verified by PyPI」とラベルを付けた。

release files tab も実用寄りに改修された。長い file list を検索・絞り込みしやすくなり、各 file の provenance state も表で確認できる。late file、つまり初回 release timestamp から 14日より後にアップロードされた file にはオレンジの警告アイコンが付く。これは 2026年7月以前の release にだけ表示される警告で、その後は新しい file を 14日後に受け付けない policy ができたためだ。release history tab でも、file count、provenance state、quarantined / yanked / archived / pre-release といった status が見えるようになった。

記事の最後では、ユーザー向け documentation も拡張したと案内している。source code security の見方、provenance の確認、package integrity の検証、よくある attack からの防御、security issue の報告まで、ひと通り案内する構成だ。加えて、新しい security tab は今後の attestation type や security notice の受け皿にもなる。今回の取り組みは Open Source Security Foundation の資金提供で進み、Kabu Creative が実装した。OpenSSF Attestations Style Guide にケーススタディも公開している。

「安全そうに見える」では足りず、由来を見せる方向に寄せたのは大きい

この更新でいちばん大きいのは、PyPI が「安全性を説明する場所」を UI の中にちゃんと作ったことだと思う。従来のパッケージ配布サイトは、名前、バージョン、説明文、ダウンロード数のような表面的な情報は見せても、どの build system から来たのか、どの workflow で出されたのかまでは、利用者が自分で追わないと分からなかった。今回はそこを security tab に集約し、しかも warning を project page の上部に出す。これは単なる情報追加ではなく、判断の導線を作り直している。
特に良いのは、attestation がないことを即「危険」とは扱っていない点だ。古い release では珍しくないし、Trusted Publishing 未導入の project も多いはずだ。ここを雑に赤旗だけで埋めると、むしろノイズになる。PyPI は「検証できない」と「怪しい」を分けている。安全性の話でこの切り分けはかなり重要で、利用者に不要な不安を与えにくい。

provenance warning は、脆弱性の警告というより「いつもと違う」を知らせる装置だ

面白いのは、warning の多くが「悪い」と断定していないことだ。Change of Provenance も Loss of Provenance も、組織の移管や publishing process の変更で説明できる。つまり PyPI は、侵害を見抜く完璧な判定器を目指しているのではなく、普段の挙動から外れた変化を目立たせる方向に振っている。これは現実的だと思う。供給網攻撃では、正規の運用から少しずつ外れることが多いからだ。
ただし、この種の表示は使い手にある程度の読み解きを要求する。例えば source tarball だけ attestation がない、という Incomplete Provenance を見て「では wheel なら安全」と短絡するのは危ない。逆に、attestation が揃っていても、それが指している workflow 自体が侵害されていたら別の問題が残る。つまり UI が強くなっても、最後は release notes、issue tracker、repository の活動履歴を見に行く必要がある。PyPI が documentation を厚くしたのも、その前提を認めているからだろう。

影響が大きいのは、配布者よりもまず利用者側だと思う

この変更は maintainer にとっても重要だが、最初に効くのは package を選ぶ側だと思う。依存関係の精査で、いままでは「名前を知っている」「更新が続いている」くらいしか手がかりがなかった場面に、provenance という新しい軸が入るからだ。とくに security や infra の担当者は、疑わしい package を見つけたときに「どこで止めるか」を判断しやすくなる。release history に file count と status が出るのも、その場で確認したい人には地味に効く。
一方で、すぐに全部の利用者が attestation を読みこなせるとは思えない。だからこそ、PyPI が info を一箇所に置き、warning を色と位置で目立たせた意味がある。利用者は細かい仕組みを全部理解しなくても、まず「いつもと違うらしい」と気づける。そこから深掘りできればいい。安全機能は、完成したとたんに終わるのではなく、説明の仕方まで含めて育つものだと今回の更新は示している。

OpenSSF との連携は、PyPI だけの話に閉じない

もう一つ注目したいのは、PyPI が自分たちの UI 変更を、OpenSSF の style guide と case study に戻していることだ。これは単なる広報ではなく、同じ問題を抱える他の package registry や配布基盤にも再利用できる形にしているということだと思う。安全のための UI は、機能だけ先に作っても広がりにくい。どこでどう見せるか、どんな warning を出すか、どんな言葉で誤解を減らすかが難しい。
その意味で、今回の PyPI は「attestation を支える仕組み」だけでなく「それを人間に伝える設計」まで一緒に磨いた。ここは見落とされがちだが、かなり本質的だ。暗号的な証明は強い。しかし、利用者が読めなければ存在しないのと同じになってしまう。PyPI がやったのは、その溝を埋める作業だ。しかも、見た目をきれいにするのではなく、判断材料を増やす方向でやっている。そこに今回の更新の価値があると思う。


参考: PyPI's redesigned project pages with clearer security signals are now live - The Python Package Index Blog

同じ著者の記事