Zum Inhalt springen
Deutsch

Supply Chain

Auf dieser Seite geht es um das Paket, das du installierst, nicht um Code, den du schreibst. Sie beantwortet eine Frage: Wie viel an actor-ts kannst du nachprüfen, statt es zu glauben?

ArtefaktWoWas es beweist
npm-Provenance-AttestationDie npm-Registry, am veröffentlichten TarballWelcher Commit und welcher Workflow-Run diese Bytes erzeugt hat.
CycloneDX-SBOMAm GitHub-Release als actor-ts-sbom.cyclonedx.json, ab v0.17.0Die exakte Dependency-Closure, die beim Bauen des Releases installiert war.
CHANGELOG-EintragCHANGELOG.mdSicherheitsrelevante Änderungen bekommen einen eigenen Security-Abschnitt.

Veröffentlicht wird über npm Trusted Publishing (OIDC) — der Workflow tauscht ein kurzlebiges GitHub-Identity-Token gegen ein Einmal-Publish-Token. Es liegt nirgends ein langlebiges npm-Token, also kann auch keins abfließen.

Der Publish-Job läuft im GitHub-Environment npm, und dieses Environment entscheidet, wer veröffentlichen darf (#704). GitHub startet den Job nur auf einer Ref, die das Environment zulässt — einem Tag v* oder dem Branch main — und hält ihn an, bis ein Maintainer den Lauf freigibt. Der Trusted Publisher auf npmjs.com ist mit demselben Environment-Namen registriert, also gibt npm keinem Lauf ein Publish-Token, der ihn nicht trägt. Ein Branch, den ein Konto mit Schreibrechten pusht, kann deshalb keine eigene Version veröffentlichen, weder über einen manuellen Dispatch noch über eine geänderte Kopie des Workflows.

Terminal-Fenster
npm audit signatures

In einem Projekt ausgeführt, das actor-ts installiert hat, prüft das die Registry-Signatur und die Provenance-Attestation jedes installierten Pakets, dieses eingeschlossen.

Die SBOM ist ein Release-Asset, braucht also keine Installation. Setze das Release ein, um das es dir geht:

Terminal-Fenster
gh release download vX.Y.Z --pattern 'actor-ts-sbom.cyclonedx.json'

Jedes Release bis einschließlich v0.16.0 ist älter als die Jobs, die das Asset erzeugen — dort gibt es also nichts zu holen. gh release view vX.Y.Z --json assets sagt dir vorher, ob ein bestimmtes Release es mitbringt.

Es ist ein CycloneDX-1.x-JSON-Dokument, das jedes SCA-Tool liest. Der Sinn: Du kannst “war Release X von Advisory Y betroffen?” beantworten, ohne die Closure aus einer Lockfile zu rekonstruieren, die du dafür erst auschecken müsstest.

Vier Checks stehen zwischen einer Änderung und einem Release. Sie laufen auf Pull Requests — das Advisory-Gate nur, wenn der Pull Request src/** oder ein Manifest oder eine Lockfile berührt, die es prüft, das ist sein Path-Filter, ein reiner Prosa-Request wartet also nicht darauf; die beiden, die ohne einen Commit veralten können, laufen zusätzlich nach Zeitplan.

.github/workflows/codeql.yml analysiert das gesamte Repository mit CodeQLs javascript-typescript-Pack bei jedem Pull Request, bei Pushes auf main und develop und wöchentlich. Funde landen in den Code-Scanning-Alerts des Repositorys.

Die Query-Suite ist security-extended. Das war nicht immer so: Zuerst lief bewusst die engere Standard-Suite, damit die allererste Analyse eines Codebestands dieser Größe eine Triage ergab, die man auch abschließen kann. Nachdem diese Baseline sauber war, wurde die Suite erweitert.

Der wöchentliche Lauf ist nicht redundant: CodeQL liefert laufend neue Queries aus, eine Datei kann also Monate nach ihrer Entstehung markiert werden, ohne dass jemand sie angefasst hat.

bun audit läuft in .github/workflows/package-health.yml mit --audit-level=high und lässt den Job bei jedem neuen High- oder Critical-Advisory fehlschlagen. Du kannst genau das ausführen, was CI ausführt — im Repository-Root für die ausgelieferte Closure und unter docs/ für die der Dokumentationsseite:

Terminal-Fenster
bun run lint:audit

Es liest eine Lockfile statt eines Manifests, sieht also die Versionen, die tatsächlich ausgeliefert werden — und genau deshalb ist es bun audit und nicht actions/dependency-review-action. Und es liest jede Bun-Lockfile, die CI installiert, nicht nur die ausgelieferte: bun.lock, docs/bun.lock und devtools-ui/bun.lock, die letzte davon aufgelöst in dem Job, der nach npm veröffentlicht. Die beiden verschachtelten Closures blieben ungeprüft, bis das Gate erweitert wurde, und trugen zusammen neun High-Advisories, jedes mit einem Fix innerhalb des deklarierten Ranges, während das Root-Gate grün blieb; ein Test schlägt jetzt fehl, wenn ein Workflow eine Bun-Closure installiert, die der Job nicht prüft. Der Schritt für die DevTools-UI schreibt dieselben Flags aus, statt über ein Skript zu gehen, weil dieses Manifest in das eingebettete UI-Bundle gehasht wird und eine Skriptzeile dort einen Rebuild davon erzwingen würde. Das Gate läuft außerdem wöchentlich per Cron, denn ein Advisory wird upstream gegen eine Lockfile veröffentlicht, die sich nicht geändert hat; ein rein Push-getriebenes Gate würde es erst beim nächsten unabhängigen Commit bemerken.

Es ist nichts unterdrückt. Das Gate startete mit einer Baseline — elf ignorierten Advisory-IDs, damit es grün landen konnte, statt rot zu landen und ignoriert zu werden — und diese Baseline ist weg: Jede einzelne wurde von einem Release behoben, das innerhalb des ohnehin in der package.json deklarierten Ranges liegt, ein Refresh der bun.lock hat sie also beseitigt, ohne irgendetwas aufzuweiten. Jede wieder hinzugefügte Unterdrückung muss in SECURITY.md dokumentiert werden, und ein Test schlägt fehl, wenn Unterdrückungsliste und SECURITY.md auseinander laufen — die Menge kann also nicht stillschweigend wachsen.

Jedes uses: in jedem Workflow ist auf einen vollständigen 40-stelligen Commit-SHA gepinnt, mit dem Release-Tag in einem nachgestellten Kommentar. Ein Tag ist ein veränderlicher Zeiger: Wer actions/checkout@v7 umbiegen kann, führt beliebigen Code in dem Job aus, der nach npm veröffentlicht. Ein SHA lässt sich nicht umbiegen. Der nachgestellte Kommentar ist das, was Dependabot die Pins aktuell halten lässt.

tests/unit/ci/WorkflowHygiene.test.ts prüft das bei jedem bun test — Workflow-YAML ist für den Typechecker unsichtbar, ohne diesen Test verfällt eine Härtungsentscheidung also beim ersten Edit von jemandem, der nichts davon weiß.

Jede Installation in CI läuft mit --frozen-lockfile, ein grüner Check bedeutet also nie “gegen ein Dependency-Set bestanden, das niemand reproduzieren kann”. Job-Tokens sind standardmäßig read-only; ein Write-Scope sitzt an genau dem einen Job, der ihn braucht, und kein Job, der ins Repository schreiben darf, führt zugleich fremde Install-Skripte aus. Dieselbe Testdatei prüft alle drei Punkte.

Diese letzte Regel gilt auch für die Publishing-Credential, nicht nur für die Scopes, die ins Repository schreiben. id-token: write erzeugt das OIDC-Token, das npm gegen ein einmalig gültiges Publish-Token eintauscht — ein Job, der es hält, kann also ein Release veröffentlichen, und damit ist es der denkbar ungeeignetste Scope, um daneben einen Dependency-Baum auszuführen. Der Release-Workflow baut, testet und packt das Tarball deshalb in einem Job ganz ohne Credential und veröffentlicht dieses Artefakt aus einem Job heraus, der weder das Repository auscheckt noch irgendetwas installiert. Beide kommunizieren ausschließlich über das gepackte Tarball, und der Versions-Guard liest die Version aus genau diesen Bytes statt aus einer zweiten Kopie des Baums.

trustedDependencies: [] in der Root-package.json schließt die andere Hälfte. Bun führt Install-Skripte einer Dependency nur für die dort genannten Pakete aus, und eine leere Liste beschreibt diesen Closure heute ehrlich — nichts darin hat ein Install-Skript. Der Punkt ist, was danach passiert: Eine Dependency, die eines hinzubekommt, taucht als bun pm untrusted-Zeile auf, die man sich ansieht, statt einfach zu laufen.

SECURITY.md ist die Policy: der private Meldekanal, die Erwartung an die Antwortzeit und — der Teil, der sich vor dem Melden zu lesen lohnt — die Scope-Grenze. Der Cluster-Transport läuft bewusst als klartextiges TCP ohne Peer-Authentifizierung, dokumentiert neben dem Rezept unter Cluster-Sicherheit, dieser Default ist also keine Schwachstelle. Eine dokumentierte Gegenmaßnahme, die nicht hält, was sie verspricht, schon.