PyPI запустила редизайн страниц проектов с вкладкой «Безопасность»

PyPI запустила редизайн страниц проектов с вкладкой «Безопасность»

Команда PyPI объявила, что редизайн интерфейса, о планах которого она рассказывала в июле, завершён и уже работает на PyPI. Обновления сформированы по итогам пользовательских исследований с участниками сообщества Python и нацелены на то, чтобы лучше показывать сигналы безопасности и сведения о пакетах. Работу финансировал Open Source Security Foundation (OpenSSF), а реализовала студия Kabu Creative, опираясь на рекомендации из OpenSSF Attestations Style Guide.

Контекст, который приводит команда: с быстрым ростом экосистемы Python PyPI стал всё более привлекательной целью для злоумышленников. Цифровые аттестации (digital attestations), появившиеся в 2024 году, дают проверяемую запись о происхождении файла релиза, но многим пользователям понятия provenance и attestations по-прежнему незнакомы, а прежний интерфейс почти не объяснял их смысл, важность и ограничения.

Главное новшество, вкладка безопасности. Она показывает состояние происхождения релиза и аттестации каждого файла. PyPI считает это состояние, проверяя, есть ли аттестация у каждого файла релиза. Обычно релиз находится в одном из двух состояний. «Полное происхождение» (Full Provenance) означает, что аттестации есть у 100% файлов релиза; допустимы аттестации PyPI Publish (подтверждают, что файл опубликован через PyPI Trusted Publisher) и SLSA Build Provenance (связывают файл с точным коммитом исходного кода, платформой сборки и инструкциями), любая из них или обе. «Нет происхождения» (No Provenance) означает, что ни у одного файла релиза нет аттестации; это типично для старых релизов и проектов, где ещё не настроена доверенная публикация (Trusted Publishing). Это не значит, что релиз вредоносен, лишь что происхождение файла нельзя проверить криптографически. В таком случае PyPI советует опираться на косвенные признаки доверия: историю мейнтейнеров, ритм выпуска релизов и активность репозитория.

Отдельно введены предупреждения о происхождении, они должны помогать заметить, что файл мог прийти не от мейнтейнеров проекта, например при захвате аккаунта или рабочего процесса публикации. Их четыре. «Неполное происхождение»: часть файлов с аттестациями, часть без (например, колёса (wheels) опубликованы через Trusted Publishing, а архив с исходниками загружен по API-токену); рекомендуется проверить заметки о релизе или спросить в трекере задач. «Несогласованное происхождение»: файлы одного релиза собраны в разных системах сборки или происходят из разных репозиториев; нужно сверить метаданные аттестаций. «Смена происхождения»: файлы пришли из другого репозитория или рабочего процесса, чем в предыдущем релизе, часто это законно (переименование организации, миграция репозитория), но может означать и скомпрометированный конвейер или захват аккаунта; стоит свериться с заметками о релизе и официальными каналами. «Потеря происхождения»: проект, ранее публиковавшийся с аттестациями, стал загружать файлы без них; если это неожиданно, к релизу следует относиться с осторожностью, пока не будет проверки.

Изменилась и страница проекта. Предупреждения о происхождении выводятся вверху страницы рядом с баннерами о снятых (yanked) релизах, архивированных проектах и предварительных версиях; если проект или релиз помещён в карантин, показывается только баннер карантина, он приоритетнее всех остальных. Состояние происхождения при полном происхождении или наличии предупреждений отображается в боковой панели со ссылкой на вкладку безопасности. Метаданные теперь упорядочены по полезности и помечены как «PyPI data» или «Data verified by PyPI» (вместо прежней группировки по статусу проверки).

Вкладка файлов релиза получила поиск и фильтры для длинных списков, показывает состояние происхождения каждого файла и помечает «поздние» файлы оранжевым значком предупреждения. Предупреждение о позднем файле выводится, если файл загружен более чем через 14 дней после первоначальной отметки времени релиза; оно показывается только для релизов до июля 2026 года, когда ввели правило отклонять новые файлы после 14 дней. Вкладка истории релизов теперь показывает число файлов, состояние происхождения и статус релиза (карантин, снят, архивирован или предварительная версия).

Пользовательская документация PyPI дополнена руководством по безопасности пакетов: оценка безопасности исходного кода, проверка происхождения, проверка целостности, защита от распространённых атак и сообщение об уязвимостях. Вкладка безопасности, по словам команды, станет местом для будущих типов аттестаций и уведомлений о безопасности; кроме того, в OpenSSF Attestations Style Guide опубликован разбор кейса с паттернами дизайна и предупреждениями, найденными в проекте.

Ключевые факты

  • Обновлённый интерфейс PyPI, анонсированный в июле, завершён и работает: новая вкладка безопасности, переделанные страница проекта, вкладки файлов и истории релизов.
  • Релиз получает состояние «Полное происхождение» (аттестации у 100% файлов) или «Нет происхождения»; второе не означает вредоносность, а лишь невозможность криптографически проверить источник файла.
  • Четыре предупреждения о происхождении: неполное, несогласованное, смена и потеря; часть имеет законные причины, но каждое стоит проверить перед установкой.
  • Поздние файлы (загруженные позже чем через 14 дней после релиза) помечаются в списке файлов, но только у релизов до июля 2026 года, когда ввели правило отклонять такие файлы.
  • Работу профинансировал OpenSSF, выполнила студия Kabu Creative; документация PyPI дополнена руководством по безопасности пакетов.

Почему это важно

PyPI, основной репозиторий пакетов Python, и, как пишет сама команда, он стал всё более привлекательной целью для злоумышленников. Цифровые аттестации существуют с 2024 года, но интерфейс почти не объяснял, что они значат. Теперь информация о происхождении релиза вынесена в отдельную вкладку и подкреплена заметными предупреждениями прямо на странице проекта. Это не ИИ-новость по теме, но она касается цепочки поставок ПО.

Кому это важно

Разработчикам и командам, которые устанавливают пакеты из PyPI и хотят быстро оценить, откуда пришёл релиз. Мейнтейнерам пакетов: PyPI прямо советует рассмотреть Trusted Publishing с издателем, который создаёт аттестации, уже со следующего релиза. Специалистам по безопасности цепочки поставок, а также участникам OpenSSF: опыт проекта оформлен как кейс в OpenSSF Attestations Style Guide.

Как это применить

Перед установкой незнакомого или обновляемого пакета откройте вкладку безопасности и посмотрите состояние происхождения. При «Полном происхождении» можно изучить метаданные аттестаций или перейти по ссылке на журнал прозрачности. При «Нет происхождения» опирайтесь на косвенные сигналы: историю мейнтейнеров, ритм релизов, активность репозитория. Если видите предупреждение, действуйте по подсказкам PyPI: сверьтесь с заметками о релизе и трекером задач, проверьте метаданные аттестаций, а при потере происхождения относитесь к релизу с осторожностью, пока не подтверждено, что мейнтейнеры сменили способ публикации намеренно. Мейнтейнерам стоит настроить Trusted Publishing, чтобы релизы получали аттестации. Подробности, в новом руководстве по безопасности пакетов в документации PyPI.

Можно ли доверять

Источник, официальный блог PyPI, то есть первоисточник; описание функций дано самой командой. В тексте нет статистики внедрения (какая доля пакетов или релизов имеет аттестации), нет результатов пользовательских исследований и не названо конкретного инцидента, послужившего поводом. Точной даты запуска в самом тексте тоже нет. Оценки вроде «PyPI стал привлекательной целью», утверждение авторов без подтверждающих цифр.

Риски и подводные камни

Отсутствие аттестации, не признак вредоносности, поэтому для старых релизов и проектов без Trusted Publishing «Нет происхождения» остаётся обычной ситуацией, и по одному этому состоянию выводы делать нельзя. Наличие аттестации тоже не гарантия безопасности пакета в целом: она подтверждает происхождение файла, а не добротность кода. Предупреждения о смене происхождения часто имеют законные причины (переименование организации, перенос репозитория), поэтому нужна ручная проверка по заметкам и официальным каналам. Предупреждения о поздних файлах показываются только для релизов до июля 2026 года.

«Отсутствие происхождения не обязательно означает, что релиз или файл релиза вредоносен; оно означает лишь, что происхождение файла нельзя проверить криптографически.»

— Команда PyPI, блог PyPI