Porozmawiajmy o Twojej firmie

PyPI pokazuje provenance pakietów w interfejsie — co to zmienia w weryfikacji zależności w firmowych pipeline’ach

PyPI pokazuje provenance pakietów w interfejsie — co to zmienia w weryfikacji zależności w firmowych pipeline’ach

PyPI zakończyło modernizację interfejsu projektów i udostępniło na stałe kartę bezpieczeństwa, która pokazuje stan provenance wydania oraz attestacje przypisane do poszczególnych plików. Zmiana dotyczy każdego, kto pobiera pakiety z PyPI — a więc przede wszystkim zespołów utrzymujących aplikacje w Pythonie i pipeline’y CI/CD, które instalują zależności automatycznie. Jej znaczenie nie polega na tym, że pojawiło się nowe zabezpieczenie blokujące ataki, bo takiego mechanizmu tu nie ma. Polega na tym, że informacja o pochodzeniu pliku stała się widoczna w miejscu, w którym deweloper i administrator i tak zaglądają — na stronie projektu i w historii wydań.

Wcześniej attestacje istniały, ale były słabo komunikowane. PyPI samo przyznaje, że provenance i attestacje pozostawały dla wielu użytkowników pojęciami nieznanymi, a interfejs nie tłumaczył ich znaczenia ani ograniczeń. Po zmianie stan provenance jest widoczny w sidebarze, ostrzeżenia trafiają na górę strony projektu, a zakładka plików pozwala sprawdzić status każdego pliku osobno. Dla firmy oznacza to nowe źródło sygnałów w procesie weryfikacji zależności — ale też nowe ryzyko: łatwo pomylić „brak provenance” z „pakiet jest niebezpieczny” albo uznać „Full Provenance” za certyfikat bezpieczeństwa, którym on nie jest.

Co dokładnie zostało wdrożone

Prace nad nowym interfejsem PyPI zapowiedziało w lipcu, a według wpisu na blogu PyPI zostały one ukończone i są dostępne publicznie. Zmiany objęły cztery obszary.

Karta bezpieczeństwa

Nowa zakładka bezpieczeństwa na stronie projektu pokazuje stan provenance wydania i attestacje dla poszczególnych plików. To dedykowane miejsce na weryfikację pochodzenia plików wydania — wcześniej takie informacje trzeba było wydobywać z metadanych lub narzędzi zewnętrznych.

Stany provenance

PyPI oblicza stan provenance wydania, sprawdzając, czy każdy plik wydania ma attestację. W praktyce występują dwa podstawowe stany:

  • Full Provenance — 100% plików wydania ma attestacje. Mogą to być attestacje typu PyPI Publish, SLSA Build Provenance albo oba typy jednocześnie.
  • No Provenance — żaden plik wydania nie ma attestacji. PyPI wprost zaznacza, że nie świadczy to o złośliwości pakietu. Oznacza jedynie, że pochodzenia pliku nie da się zweryfikować kryptograficznie. To typowa sytuacja dla starszych wydań i projektów, które nie skonfigurowały Trusted Publishing.

Typ PyPI Publish potwierdza, że plik został opublikowany przez Trusted Publisher w PyPI. Typ SLSA Build Provenance wiąże plik z konkretnym commitem źródłowym, platformą budowania i instrukcjami budowania. Oba typy można przejrzeć w interfejsie, a w przypadku SLSA dostępny jest też link do logu transparentności.

Ostrzeżenia provenance

To najbardziej operacyjnie istotna część zmiany. PyPI wyróżnia cztery ostrzeżenia, które mają sygnalizować sytuacje, w których plik może nie pochodzić od opiekunów projektu — na przykład po przejęciu konta lub workflow publikacji.

Ostrzeżenie Co oznacza Typowa przyczyna legalna
Incomplete Provenance Część plików ma attestacje, część nie Wheele publikowane przez Trusted Publishing, a tarball źródłowy wgrany tokenem API
Inconsistent Provenance Pliki w tym samym wydaniu pochodzą z różnych systemów budowania lub repozytoriów Różne pipeline’y dla różnych platform docelowych
Change of Provenance Pliki pochodzą z innego repozytorium lub workflow niż poprzednie wydanie Zmiana nazwy organizacji, migracja repozytorium
Loss of Provenance Projekt wcześniej publikował z attestacjami, a przeszedł na publikację bez nich Powrót do tokenów API, zmiana konfiguracji publikacji

PyPI zaznacza, że wiele ostrzeżeń ma uzasadnione wyjaśnienie, ale każde warto sprawdzić przed instalacją. Przy Incomplete Provenance sugeruje zajrzenie do release notes lub pytanie w issue trackerze projektu. Przy Change of Provenance — potwierdzenie w oficjalnych kanałach, że migracja infrastruktury była planowana. Przy Loss of Provenance — ustalenie, czy opiekunowie świadomie zmienili proces publikacji; jeśli nie, wydanie należy traktować sceptycznie do czasu weryfikacji.

Przebudowana strona projektu i lista plików

Ostrzeżenia provenance wyświetlają się teraz na górze strony projektu, obok banerów o wydaniach wycofanych, projektach zarchiwizowanych i wersjach przedpremierowych. Jeśli projekt lub wydanie jest w kwarantannie, pokazywany jest wyłącznie baner kwarantanny, bo ma pierwszeństwo przed pozostałymi. Metadane uporządkowano według użyteczności i oznaczono jako „PyPI data” lub „Data verified by PyPI” — wcześniej grupowano je według statusu weryfikacji.

Zakładka plików wydania dostała wyszukiwanie i filtrowanie, kolumnę ze stanem provenance każdego pliku oraz oznaczenie plików spóźnionych. Ostrzeżenie o pliku spóźnionym pojawia się, gdy co najmniej jeden plik wgran o więcej niż 14 dni po początkowym znaczniku czasu wydania. Co istotne, ostrzeżenia te dotyczą wyłącznie wydań sprzed lipca 2026 — od tego momentu obowiązuje polityka odrzucania nowych plików po 14 dniach. Historia wydań pokazuje teraz liczbę plików, stan provenance i status wydania.

Tło techniczne bez żargonu

Attestacja to podpisany cyfrowo zapis stwierdzający określony fakt o pliku. W kontekście PyPI chodzi o dwa fakty: kto opublikował plik (PyPI Publish) oraz z jakiego kodu i w jakim procesie budowania powstał (SLSA Build Provenance). Attestacje wprowadzono w 2024 roku. Provenance to właśnie pochodzenie pliku odtworzone na podstawie takich zapisów.

Mechanizm działa tak: system budowania lub workflow publikacji generuje podpisane oświadczenie, PyPI je przyjmuje i przechowuje, a użytkownik może je obejrzeć. Podpis można zweryfikować kryptograficznie, więc sfałszowanie attestacji bez dostępu do klucza podpisującego jest trudne. To odróżnia provenance od zwykłego metadanych, które można dowolnie wpisać.

Kluczowe rozróżnienie: attestacja potwierdza pochodzenie, a nie bezpieczeństwo. Plik może mieć nienaganny provenance i jednocześnie zawierać złośliwy kod, jeśli złośliwy kod trafił do repozytorium źródłowego i został zbudowany w legalnym pipeline. Provenance odpowiada na pytanie „skąd to przyszło i jak powstało”, nie na pytanie „czy to jest bezpieczne”.

PyPI wprost stwierdza, że „No provenance” niekoniecznie oznacza wydanie lub plik złośliwy — oznacza brak możliwości kryptograficznej weryfikacji pochodzenia pliku.

Warto też odnotować kontekst: PyPI opisuje wzrost ekosystemu Pythona jako czynnik, który czyni go coraz atrakcyjniejszym celem dla aktorów o złośliwych zamiarach. Nowy interfejs jest odpowiedzią na ten problem, ale odpowiedzią w warstwie komunikacji, nie w warstwie egzekwowania. PyPI nie blokuje instalacji pakietów bez provenance ani z ostrzeżeniami. Decyzja o tym, co zrobić z tymi sygnałami, należy do użytkownika i do narzędzi, które ten użytkownik skonfiguruje.

Realne konsekwencje dla firm

Zmiana ma trzy praktyczne skutki, które warto rozdzielić.

1. Nowy sygnał w procesie przeglądu zależności

Zespoły, które dziś opierają się wyłącznie na skanerach podatności (SCA), zyskują dodatkową warstwę informacji o łańcuchu dostaw. Skaner SCA odpowiada na pytanie „czy ta wersja ma znane CVE”. Provenance odpowiada na pytanie „czy ten plik pochodzi z miejsca, z którego powinien”. To różne pytania i różne ryzyka. Podatność można załatać aktualizacją; przejęte konto opiekuna może dostarczyć złośliwy kod w wersji, która nie ma jeszcze żadnego CVE, bo nikt jej jeszcze nie zgłosił.

2. Ryzyko fałszywego poczucia bezpieczeństwa

„Full Provenance” brzmi jak certyfikat. Nie jest nim. Wydanie z pełnym provenance może zawierać podatności, może zawierać kod o słabej jakości, może wreszcie zawierać złośliwy kod wprowadzony do repozytorium źródłowego. Z kolei „No Provenance” obejmuje ogromną część ekosystemu — starsze wydania i projekty, które nie przeszły na Trusted Publishing. Traktowanie braku provenance jako sygnału blokującego w firmowym CI oznaczałoby zablokowanie dużej części legalnych zależności.

3. Nowa powierzchnia do automatyzacji

Informacje o provenance są dostępne w interfejsie, ale PyPI nie ogłosiło w omawianym materiale nowego, stabilnego API do maszynowego odczytu tych stanów. To istotne ograniczenie: ręczne sprawdzanie karty bezpieczeństwa nie skaluje się do setek zależności. Zespoły, które chcą wpiąć te sygnały w CI, muszą najpierw ustalić, czy dysponują wiarygodnym, udokumentowanym sposobem pobrania tych danych, czy też opierają się na danych z interfejsu przeznaczonych dla człowieka. Materiał dowodowy nie potwierdza istnienia dedykowanego endpointu dla stanów provenance, więc nie należy tego zakładać.

Scenariusze ryzyka

Poniższe scenariusze opisują sytuacje, w których nowe sygnały mają realną wartość diagnostyczną. To interpretacja na podstawie opisanych mechanizmów, nie lista potwierdzonych incydentów.

Przejęcie konta opiekuna

Atakujący przejmuje konto opiekuna i publikuje nowe wydanie. Jeśli publikacja odbywa się przez ten sam Trusted Publisher i ten sam workflow, provenance może wyglądać poprawnie — bo technicznie plik pochodzi z właściwego pipeline’u. Ostrzeżenia provenance nie zastąpią więc analizy diffu kodu. Wartość sygnału pojawia się wtedy, gdy atakujący publikuje z innego workflow lub w inny sposób — wtedy Change of Provenance lub Loss of Provenance może zwrócić uwagę.

Przejęcie pipeline’u publikacji

Jeśli atakujący uzyska kontrolę nad workflow publikacji, może generować attestacje zgodne z oczekiwaniami. To scenariusz, w którym provenance nie pomaga, bo podpis jest ważny, a pochodzenie „zgodne”. Ochroną jest tu kontrola dostępu do repozytorium i konfiguracji CI, nie analiza strony PyPI.

Niespójne wydanie

Inconsistent Provenance lub Incomplete Provenance mogą sygnalizować, że część plików powstała w innym miejscu niż reszta. Może to być niewinne — różne pipeline’y dla różnych platform — ale może też oznaczać, że jeden plik został podmieniony. To sygnał wymagający weryfikacji, nie automatycznej blokady.

Nagła utrata provenance

Loss of Provenance w projekcie, który wcześniej publikował z attestacjami, jest najbardziej niepokojącym z czterech ostrzeżeń, bo łączy dwa fakty: projekt miał skonfigurowany bezpieczniejszy proces i nagle go porzucił. Może to być świadoma decyzja (powrót do tokenów API z powodu problemów z Trusted Publishing), ale może też być skutkiem przejęcia konta i zmiany konfiguracji publikacji.

Jak sprawdzić, czy problem dotyczy Twojej organizacji

Pytanie nie brzmi „czy używamy PyPI”, bo w firmach z Pythonem odpowiedź jest zwykle twierdząca. Pytanie brzmi, czy proces weryfikacji zależności w ogóle uwzględnia sygnały pochodzenia.

  1. Zinwentaryzuj zależności pobierane z PyPI. Uwzględnij nie tylko bezpośrednie zależności z plików requirements i pyproject, ale też zależności tranzytywne oraz pakiety instalowane w obrazach bazowych.
  2. Ustal, czy pipeline ma dostęp do internetu i pobiera pakiety w czasie budowania. Jeśli tak, każdy build jest momentem, w którym nowe wydanie może wejść do środowiska.
  3. Sprawdź, czy stosujecie pinning wersji i sumy kontrolne. Jeśli tak, ryzyko podmiany pliku w ramach tej samej wersji jest ograniczone, ale nie znika przy aktualizacjach.
  4. Sprawdź, czy macie wewnętrzne repozytorium pośredniczące (mirror, proxy). Jeśli pakiety przechodzą przez wasz mirror, macie punkt kontroli — o ile mirror weryfikuje provenance, a nie tylko przekazuje pliki.
  5. Sprawdź, czy zespół w ogóle wie o karcie bezpieczeństwa. Jeśli nikt nie zagląda na tę zakładkę, nowe sygnały nie działają.

Plan reakcji krok po kroku

Krok 1: Zdefiniuj politykę, zanim zaczniesz blokować

Nie zaczynaj od blokowania instalacji. Zacznij od ustalenia, które ostrzeżenia są dla was sygnałem do ręcznej weryfikacji, a które do eskalacji. Propozycja podziału:

Stan / ostrzeżenie Rekomendowana reakcja Blokować automatycznie?
Full Provenance Brak dodatkowej akcji poza standardowym SCA Nie dotyczy
No Provenance Ocena na podstawie innych sygnałów: historia opiekunów, wzorce wydań, aktywność repozytorium Nie
Incomplete Provenance Sprawdzenie release notes i issue trackera przed wdrożeniem Zależnie od krytyczności pakietu
Inconsistent Provenance Weryfikacja metadanych attestacji, czy wszystkie pliki pochodzą ze źródeł kontrolowanych przez opiekunów Tak dla pakietów w ścieżce krytycznej
Change of Provenance Potwierdzenie w oficjalnych kanałach, że migracja była planowana Tak do czasu potwierdzenia
Loss of Provenance Ustalenie, czy zmiana procesu publikacji była świadoma Tak do czasu potwierdzenia

To propozycja redakcyjna, nie rekomendacja PyPI. PyPI nie wskazuje, które ostrzeżenia powinny blokować instalację — opisuje ich znaczenie i sugeruje weryfikację.

Krok 2: Ustal, gdzie w procesie sprawdzać

Sprawdzanie provenance na etapie code review jest mało skuteczne, bo dotyczy wersji, nie plików. Sensownym miejscem jest etap aktualizacji zależności — gdy pojawia się nowa wersja pakietu, przed jej wdrożeniem. Drugim miejscem jest etap budowania obrazów, jeśli budujecie z dostępem do sieci.

Krok 3: Ogranicz powierzchnię ataku niezależnie od provenance

Pinning wersji i weryfikacja sum kontrolnych to podstawy, które działają niezależnie od tego, czy pakiet ma attestacje. Wewnętrzny mirror pakietów daje punkt kontroli i możliwość odcięcia dostępu do nowych wydań do czasu przeglądu. To działania, które nie zależą od interfejsu PyPI.

Krok 4: Obsłuż pakiety wewnętrzne

Jeśli publikujecie własne pakiety na PyPI lub do wewnętrznego repozytorium, przejście na Trusted Publishing z generowaniem attestacji jest działaniem, które poprawia wasz własny łańcuch dostaw. PyPI sugeruje to opiekunom pakietów bez provenance.

Krok 5: Ustal proces eskalacji

Kto reaguje, gdy pojawia się ostrzeżenie? Kto ma prawo zatrzymać wdrożenie? Bez zdefiniowanej ścieżki eskalacji ostrzeżenia staną się szumem, który zespół nauczy się ignorować.

Typowe błędy

  • Traktowanie „No Provenance” jako czerwonej flagi. To najczęstszy błąd, przed którym PyPI wprost ostrzega. Większość ekosystemu nie ma attestacji i nie jest przez to złośliwa.
  • Traktowanie „Full Provenance” jako gwarancji bezpieczeństwa. Provenance potwierdza pochodzenie, nie jakość ani brak podatności.
  • Blokowanie wszystkich ostrzeżeń bez wyjątków. Prowadzi do obejść — zespoły zaczynają instalować pakiety poza pipeline’em, co pogarsza kontrolę.
  • Poleganie wyłącznie na interfejsie. Ręczne sprawdzanie karty bezpieczeństwa nie skaluje się i jest podatne na przeoczenia.
  • Ignorowanie ostrzeżeń przy aktualizacjach rutynowych. Właśnie przy rutynowych aktualizacjach uwaga zespołu spada, a to moment, w którym Change of Provenance lub Loss of Provenance powinny zwrócić uwagę.
  • Zakładanie, że provenance ochroni przed przejęciem pipeline’u. Jeśli atakujący kontroluje workflow publikacji, attestacje będą poprawne.

Działania krótkoterminowe

  1. Zapoznaj zespół z nową kartą bezpieczeństwa i znaczeniem czterech ostrzeżeń. To działanie jednorazowe, które zwiększa skuteczność wszystkich pozostałych.
  2. Przejrzyj pakiety w ścieżce krytycznej pod kątem stanu provenance. Nie po to, by cokolwiek blokować, ale by wiedzieć, gdzie jesteście.
  3. Ustal, czy wasz pipeline ma dostęp do sieci przy budowaniu i czy pobiera nowe wersje bez przeglądu.
  4. Wprowadź pinning wersji i sumy kontrolne tam, gdzie ich nie ma.
  5. Zidentyfikuj pakiety wewnętrzne publikowane bez attestacji i zaplanuj migrację na Trusted Publishing.

Działania długoterminowe

  1. Wbuduj weryfikację provenance w proces aktualizacji zależności — jako etap przeglądu, nie automatyczną blokadę.
  2. Utrzymuj wewnętrzny mirror pakietów z kontrolą tego, co wchodzi do środowiska.
  3. Regularnie przeglądaj historię wydań pakietów krytycznych pod kątem nagłych zmian provenance.
  4. Szkol zespół z rozróżnienia między provenance a bezpieczeństwem — to kompetencja, która nie starzeje się wraz z kolejnymi aktualizacjami interfejsu.
  5. Śledź rozwój dokumentacji PyPI dotyczącej bezpieczeństwa pakietów, bo interfejs ma być miejscem dla przyszłych typów attestacji i komunikatów bezpieczeństwa.

Checklista praktyczna

  • Czy wiesz, które pakiety w Twoim środowisku mają Full Provenance, a które No Provenance?
  • Czy pipeline pobiera pakiety z internetu przy każdym buildzie?
  • Czy masz pinning wersji i weryfikację sum kontrolnych?
  • Czy masz wewnętrzny mirror pakietów?
  • Czy zespół wie, czym są ostrzeżenia Incomplete, Inconsistent, Change i Loss of Provenance?
  • Czy masz zdefiniowaną ścieżkę eskalacji przy ostrzeżeniu provenance?
  • Czy pakiety wewnętrzne są publikowane przez Trusted Publishing z attestacjami?
  • Czy przegląd zależności obejmuje historię wydań, a nie tylko najnowszą wersję?

Co powinien zrobić właściciel firmy / administrator

Właściciel firmy powinien zrozumieć jedną rzecz: nowe sygnały w PyPI nie zastępują procesu zarządzania zależnościami, tylko go wzbogacają. Decyzja inwestycyjna nie dotyczy wdrożenia „provenance”, bo to nie jest produkt do wdrożenia. Dotyczy tego, czy organizacja ma proces przeglądu zależności, w którym takie sygnały mają miejsce, oraz czy zespół ma czas i kompetencje, by je interpretować. Jeśli nie ma procesu, nowa karta bezpieczeństwa będzie kolejnym elementem interfejsu, który nikt nie odwiedza.

Administrator powinien skupić się na trzech obszarach:

  1. Kontrola dostępu do pipeline’ów publikacji. Provenance nie ochroni przed przejęciem workflow, więc to access control jest tu pierwszą linią obrony.
  2. Mirror i polityka pobierania. Punkt kontroli między PyPI a środowiskiem produkcyjnym pozwala reagować, zanim nowe wydanie trafi do buildów.
  3. Dokumentacja wewnętrzna. Zespół powinien wiedzieć, gdzie sprawdzić provenance, jak interpretować ostrzeżenia i do kogo eskalować. Bez tego nawet najlepiej zaprojektowany interfejs nie zmieni praktyki.

Warto też pamiętać o ograniczeniach materiału dowodowego. PyPI opisuje stany provenance, ostrzeżenia i zmiany w interfejsie, ale nie ogłasza w tym materiale nowego mechanizmu egzekwowania ani API do maszynowego odczytu. Nie należy więc zakładać, że nowe sygnały da się w prosty sposób zautomatyzować w CI bez dodatkowej pracy. To, co zostało potwierdzone, to widoczność informacji i rozszerzona dokumentacja — i to jest realna, ale ograniczona zmiana.

Weryfikacja praktyczna: jak sprawdzić provenance w codziennej pracy

Weryfikacja provenance nie wymaga narzędzi specjalistycznych, ale wymaga ustalonej kolejności działań. Poniższa procedura opiera się wyłącznie na elementach opisanych przez PyPI: karcie bezpieczeństwa, stanach provenance, metadanych attestacji i linku do transparency logu.

Procedura weryfikacji pojedynczego wydania

  1. Otwórz stronę projektu na PyPI i przejdź do karty bezpieczeństwa.
  2. Odczytaj stan provenance wydania: Full Provenance, No Provenance lub ostrzeżenie (Incomplete, Inconsistent, Change, Loss).
  3. Przy Full Provenance sprawdź, jakie typy attestacji występują: PyPI Publish (potwierdzenie publikacji przez Trusted Publisher) i/lub SLSA Build Provenance (powiązanie pliku z konkretnym commitem źródłowym, platformą budowania i instrukcjami).
  4. Przejrzyj metadane attestacji bezpośrednio w interfejsie. Jeśli potrzebujesz więcej informacji, skorzystaj z linku do transparency logu.
  5. Przy każdym ostrzeżeniu wykonaj czynność weryfikacyjną wskazaną przez PyPI dla danego typu (release notes, issue tracker, oficjalne kanały projektu, metadane attestacji).
  6. Zapisz wynik weryfikacji wraz z datą i wersją — bez tego nie da się odtworzyć decyzji przy kolejnej aktualizacji.

Weryfikacja per plik, nie per projekt

Provenance liczone jest na poziomie wydania poprzez sprawdzenie, czy każdy plik wydania ma attestację. Oznacza to, że weryfikacja musi objąć wszystkie pliki w wydaniu, a nie tylko ten, który trafia do waszego builda. Wydanie może być w stanie Full Provenance, a mimo to wymagać sprawdzenia, czy typ attestacji odpowiada waszym wymaganiom — PyPI Publish potwierdza publikację przez Trusted Publisher, SLSA Build Provenance wiąże plik ze źródłem i platformą budowania. To dwa różne potwierdzenia i warto wiedzieć, które z nich jest dla was istotne.

Weryfikacja przy ostrzeżeniach — konkretne czynności

  • Incomplete Provenance — sprawdź release notes pod kątem problemów z budowaniem lub zapytaj w issue trackerze projektu przed instalacją. Typowy scenariusz: wheels opublikowane przez Trusted Publishing, a source tarball wgrany tokenem API.
  • Inconsistent Provenance — sprawdź metadane attestacji i potwierdź, czy wszystkie pliki pochodzą ze źródeł kontrolowanych przez opiekunów. Ostrzeżenie oznacza, że pliki w tym samym wydaniu pochodzą z różnych systemów budowania lub repozytoriów źródłowych.
  • Change of Provenance — sprawdź release notes lub oficjalne kanały projektu i potwierdź, że migracja infrastruktury była planowana. Ostrzeżenie oznacza, że pliki pochodzą z innego repozytorium lub workflow niż poprzednie wydanie.
  • Loss of Provenance — ustal, czy opiekunowie świadomie zmienili proces publikacji (np. powrót do tokenów API albo zmiana konfiguracji, która nie generuje już attestacji). Jeśli zmiana jest nieoczekiwana, traktuj wydanie sceptycznie do czasu weryfikacji.

Weryfikacja przy braku provenance

No Provenance oznacza, że żaden plik w wydaniu nie ma attestacji — typowe dla starszych wydań i projektów, które nie skonfigurowały Trusted Publishing. To nie jest sygnał złośliwości. Weryfikacja polega wtedy na ocenie innych sygnałów zaufania: historii opiekunów, wzorców wydań i aktywności repozytorium. Jeśli jesteście opiekunami pakietu, rozważcie Trusted Publishing u wydawcy, który generuje attestacje, przy następnym wydaniu.

Monitoring po wdrożeniu: co obserwować i jak często

Po wprowadzeniu weryfikacji provenance do procesu potrzebny jest monitoring, który wychwyci zmiany stanu, a nie tylko jednorazowy przegląd. PyPI nie ogłasza w tym materiale API do maszynowego odczytu ani nowego mechanizmu egzekwowania, więc monitoring trzeba oprzeć na tym, co jest potwierdzone: karcie bezpieczeństwa, metadanych attestacji i transparency logu.

Zakres monitoringu

  • Pakiety w ścieżce krytycznej — każda nowa wersja i każde nowe wydanie plików wymaga odczytu stanu provenance przed wdrożeniem.
  • Zmiany stanu względem poprzedniego wydania — szczególnie przejścia w kierunku ostrzeżeń: pojawienie się Incomplete, Inconsistent, Change lub Loss Provenance.
  • Pakiety wcześniej bez provenance — pojawienie się attestacji to zmiana warta odnotowania, podobnie jak jej późniejszy brak.
  • Pakiety wewnętrzne — regularne potwierdzanie, że publikacja nadal odbywa się przez Trusted Publishing z generowaniem attestacji.

Częstotliwość przeglądów

  1. Przy każdej aktualizacji zależności — odczyt karty bezpieczeństwa nowej wersji przed wdrożeniem.
  2. Przy każdym rutynowym przeglądzie zależności — sprawdzenie historii wydań pakietów krytycznych pod kątem nagłych zmian provenance.
  3. Okresowo dla pakietów wewnętrznych — potwierdzenie, że konfiguracja publikacji nie została zmieniona w sposób, który wyłącza attestacje.
  4. Przy każdej zmianie w pipeline publikacji — świadome sprawdzenie, czy zmiana nie prowadzi do Loss of Provenance przy kolejnym wydaniu.

Rejestr obserwacji

Monitoring bez zapisu jest nieskuteczny. Rejestr powinien zawierać co najmniej: nazwę pakietu, wersję, datę sprawdzenia, odczytany stan provenance, typy attestacji (jeśli występują), rodzaj ostrzeżenia (jeśli występuje) oraz podjętą decyzję i jej uzasadnienie. Taki rejestr pozwala odróżnić zmianę planowaną od nieoczekiwanej przy kolejnym wydaniu — a to jest dokładnie ta informacja, której wymagają ostrzeżenia Change of Provenance i Loss of Provenance.

Interpretacja trendów

Pojedyncze ostrzeżenie ma znaczenie ograniczone. Seria ostrzeżeń w tym samym pakiecie, powtarzające się Loss of Provenance po wcześniejszym Full Provenance albo nagłe przejście na No Provenance w pakiecie wcześniej publikowanym z attestacjami — to wzorce, które powinny trafić do eskalacji niezależnie od tego, czy pojedyncze wydanie zostało uznane za dopuszczalne. PyPI opisuje ostrzeżenia jako sygnały do sprawdzenia, nie jako wyroki — monitoring ma wychwycić właśnie te przypadki, w których sprawdzenie jest konieczne.

Checklisty operacyjne

Checklista przed wdrożeniem nowej wersji pakietu

  • Czy odczytano stan provenance nowej wersji na karcie bezpieczeństwa?
  • Czy sprawdzono wszystkie pliki w wydaniu, a nie tylko ten używany w buildzie?
  • Czy przy Full Provenance odnotowano typy attestacji (PyPI Publish, SLSA Build Provenance)?
  • Czy przy ostrzeżeniu wykonano czynność weryfikacyjną wskazaną przez PyPI dla tego typu ostrzeżenia?
  • Czy przy No Provenance oceniono sygnały otoczenia: historię opiekunów, wzorce wydań, aktywność repozytorium?
  • Czy wynik weryfikacji zapisano w rejestrze wraz z decyzją?

Checklista konfiguracji pipeline i publikacji

  • Czy pipeline publikacji ma ograniczony dostęp i czy jest objęty kontrolą dostępu? Provenance nie ochroni przed przejęciem workflow — jeśli atakujący kontroluje workflow publikacji, attestacje będą poprawne.
  • Czy pakiety wewnętrzne są publikowane przez Trusted Publishing z generowaniem attestacji?
  • Czy po zmianie konfiguracji publikacji sprawdzono, czy nadal generuje attestacje?
  • Czy wiadomo, które pakiety w środowisku mają Full Provenance, a które No Provenance?
  • Czy przegląd zależności obejmuje historię wydań, a nie tylko najnowszą wersję?

Checklista reagowania na ostrzeżenie

  1. Zidentyfikuj typ ostrzeżenia: Incomplete, Inconsistent, Change czy Loss Provenance.
  2. Wykonaj właściwą czynność weryfikacyjną: release notes, issue tracker, metadane attestacji, oficjalne kanały projektu.
  3. Ustal, czy wyjaśnienie jest przekonujące i udokumentowane.
  4. Jeśli wyjaśnienia brak lub jest nieprzekonujące — wstrzymaj wdrożenie i eskaluj zgodnie z ustaloną ścieżką.
  5. Zapisz wynik i uzasadnienie decyzji w rejestrze.

Checklista utrzymania kompetencji zespołu

  • Czy zespół zna różnicę między provenance a bezpieczeństwem pakietu? Provenance potwierdza pochodzenie, nie jakość ani brak podatności.
  • Czy zespół wie, że No Provenance nie jest równoznaczne ze złośliwością?
  • Czy zespół wie, że Full Provenance nie jest gwarancją bezpieczeństwa?
  • Czy nowi członkowie zespołu przechodzą zapoznanie z kartą bezpieczeństwa i czterema ostrzeżeniami?
  • Czy śledzicie rozwój dokumentacji PyPI dotyczącej bezpieczeństwa pakietów, w tym przyszłe typy attestacji i komunikaty bezpieczeństwa?

Checklista ograniczeń materiału dowodowego

  • Czy zespół wie, że PyPI nie ogłasza w tym materiale API do maszynowego odczytu stanu provenance?
  • Czy plan automatyzacji w CI uwzględnia konieczność dodatkowej pracy zamiast założenia o gotowym mechanizmie?
  • Czy decyzje opierają się na potwierdzonych elementach: widoczności informacji w interfejsie i rozszerzonej dokumentacji?

Źródła i materiały do dalszej weryfikacji

Artykuł jest autorskim opracowaniem przygotowanym na podstawie poniższych materiałów. Linki prowadzą do publikacji źródłowych.

  1. PyPI's redesigned project pages with clearer security signals are now live – The Python Package Index Blog (blog.pypi.org)

Zdjęcie wyróżniające: Julio Lopez / Pexels.

Masz pytanie do tego tematu? Napisz do nas — odpowiemy konkretnie.

Porozmawiajmy

Potrzebujesz kogoś, kto ogarnie technologię w Twojej firmie?

Porozmawiajmy o tym, co możemy przejąć, usprawnić albo zbudować. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.