software-wartung24.de
· 6 Min. Lesezeit· Sandor Farkas

SBOM erstellen für PHP- und JavaScript-Projekte: Tools und Ablauf

Compliance & RegulierungSBOMCyber Resilience ActPHPJavaScript
Abstraktes Titelbild zum Thema SBOM erstellen für PHP- und JavaScript-Projekte: Tools und Ablauf (KI-generiert)

Ein Kunde schickt einen Fragebogen. Darin steht eine Zeile, die vor zwei Jahren noch selten war: "Bitte legen Sie eine SBOM bei." Viele Teams wissen dann nicht genau, wo sie anfangen sollen. Eine SBOM erstellen ist dabei kein großes Projekt. Für PHP und JavaScript gibt es erprobte Tools, die den Großteil der Arbeit übernehmen.

SBOM steht für Software Bill of Materials, auf Deutsch Software-Stückliste. Sie listet jede Bibliothek auf, die in Ihrer Anwendung steckt. Dazu gehören Name, Version und Lizenz. Auch die Abhängigkeiten der Abhängigkeiten stehen darin. Fachleute nennen sie transitive Abhängigkeiten.

In diesem Artikel geht es um die Praxis. Welches Tool passt zu welchem Projekt? Wie bleibt die Liste aktuell? Und was sollte ein Dienstleister Ihnen am Ende liefern?

Warum die SBOM jetzt auf dem Tisch liegt

Der Cyber Resilience Act (CRA) ist eine EU-Verordnung für Produkte mit digitalen Elementen. Er verpflichtet Hersteller, eine SBOM zu führen. Die Hauptpflichten gelten ab Dezember 2027. Wen das genau betrifft, steht in unserem Artikel zur SBOM-Pflicht.

Doch auch ohne Gesetz steigt der Druck. Größere Auftraggeber fragen die Stückliste in Ausschreibungen ab. Öffentliche Stellen ebenso. Wer keine liefern kann, fällt früh aus der Auswahl.

Was passiert, wenn Sie keine SBOM haben

Stellen Sie sich eine neue Sicherheitslücke in einer verbreiteten Bibliothek vor. Die Nachricht kommt am Freitagnachmittag. Die erste Frage lautet: Sind wir betroffen?

Ohne SBOM beginnt jetzt die Suche. Jemand durchsucht Repositories, Server und alte Deployments. Das kann Stunden dauern, manchmal Tage. Mit SBOM genügt eine Suche in einer Datei. Die Antwort steht nach wenigen Minuten fest.

Das zweite Problem sind Anfragen von Kunden und Auditoren. Ohne fertige Liste muss jemand sie nachträglich zusammentragen. Das bindet Entwickler, die eigentlich an etwas anderem arbeiten sollten. Die Liste ist dann oft unvollständig, weil transitive Abhängigkeiten fehlen.

Ein mittelgroßes Symfony- oder Laravel-Projekt hat schnell 150 bis 300 Pakete. Von Hand pflegt das niemand zuverlässig.

CycloneDX oder SPDX: welches Format?

Für SBOMs haben sich zwei Formate etabliert. CycloneDX kommt aus der OWASP-Community und hat einen Sicherheitsfokus. SPDX ist ein Standard der Linux Foundation und stammt aus dem Lizenzmanagement. Beide sind maschinenlesbar. Gängige Scanner verstehen beide.

Im PHP- und JavaScript-Umfeld ist die Tool-Unterstützung für CycloneDX am besten. Für die meisten Projekte empfehlen wir deshalb CycloneDX im JSON-Format. Verlangt ein Kunde SPDX, wandeln Sie die Datei mit dem CycloneDX CLI um.

SBOM erstellen für PHP mit Composer

Composer ist der Paketmanager für PHP. Er hält alle installierten Versionen in der Datei composer.lock fest. Genau diese Datei ist die Quelle für die SBOM.

Das passende Tool heißt cyclonedx-php-composer. Es ist ein Composer-Plugin. Sie installieren es als Entwicklungsabhängigkeit:

composer require --dev cyclonedx/cyclonedx-php-composer
composer CycloneDX:make-sbom --output-format=JSON --output-file=sbom.json

Der Befehl läuft meist in wenigen Sekunden durch. Das Ergebnis ist eine JSON-Datei mit allen Paketen, Versionen und Lizenzen.

Wenn es keine composer.lock gibt

In älteren PHP-Projekten fehlt Composer oft ganz. Bibliotheken wurden irgendwann per Hand in einen Ordner kopiert. Versionsangaben gibt es keine. Dann kann kein Tool automatisch eine vollständige Liste bauen.

Der erste Schritt ist in diesem Fall, Composer nachträglich einzuführen. Wie das ohne Risiko gelingt, zeigen wir im Artikel über PHP Composer in Legacy-Projekten. Um das Aufräumen bestehender Pakete geht es in Composer-Abhängigkeiten in Legacy-Projekten. Erst danach lohnt sich das SBOM-Tool.

SBOM für JavaScript-Projekte

Bei JavaScript gibt es zwei gute Wege. Für reine npm-Projekte eignet sich cyclonedx-npm. Es liest die package-lock.json und erzeugt daraus die Stückliste:

npx @cyclonedx/cyclonedx-npm --output-format JSON --output-file sbom-frontend.json

Für gemischte Projekte empfehlen wir cdxgen. Das Tool erkennt selbst, welche Paketmanager im Repository vorkommen. Es versteht npm, Yarn und pnpm. Auch Composer, Maven und Python-Projekte liest es ein. Bei PHP-Backend und JavaScript-Frontend im selben Repository reicht damit ein Aufruf:

npm install -g @cyclonedx/cdxgen
cdxgen -r -o sbom.json .

Der Schalter -r durchsucht das Projekt rekursiv. So landen auch Unterordner wie frontend oder admin in der Liste.

Die SBOM aktuell halten

Eine SBOM ist eine Momentaufnahme. Nach dem nächsten Update stimmt sie schon nicht mehr. Der CRA verlangt aber eine Liste, die zur ausgelieferten Version passt.

Die Lösung ist Automatisierung. Die SBOM entsteht bei jedem Build in der CI/CD-Pipeline. CI/CD bezeichnet den automatischen Ablauf aus Testen, Bauen und Ausliefern. In GitHub Actions sieht ein einfacher Schritt so aus:

- name: SBOM erzeugen
  run: |
    composer CycloneDX:make-sbom --output-format=JSON --output-file=sbom.json
    npx @cyclonedx/cyclonedx-npm --output-format JSON --output-file sbom-frontend.json
- name: SBOM speichern
  uses: actions/upload-artifact@v4
  with:
    name: sbom
    path: sbom*.json

Legen Sie die SBOM immer zusammen mit dem Release ab. Dann wissen Sie auch in zwei Jahren, was in Version 3.4 steckte. Das hilft, wenn ein Kunde noch eine alte Version betreibt.

Was Sie mit der SBOM anfangen

Die Liste allein schützt nichts. Ihr Nutzen entsteht erst im Einsatz.

Scanner wie Grype, Trivy oder OSV-Scanner lesen die SBOM ein. Sie gleichen jede Komponente mit Datenbanken bekannter Schwachstellen ab. Solche Lücken tragen eine eindeutige Kennung, die CVE. Ein Aufruf wie grype sbom:sbom.json zeigt, welche Pakete betroffen sind.

Wer viele Projekte betreut, kann OWASP Dependency-Track einsetzen. Die Plattform sammelt alle SBOMs an einer Stelle. Sie meldet sich, sobald eine neue Lücke eine gespeicherte Komponente betrifft. Sie müssen also nicht selbst regelmäßig nachsehen.

Ein Tool bewertet die Funde allerdings nicht. Ob eine Lücke in Ihrem System wirklich ausnutzbar ist, bleibt eine fachliche Frage. Davon hängt ab, welches Update zuerst kommt. Was eine Dependency ist und warum sie Risiken mitbringt, erklärt unser Glossar.

Was Ihr Dienstleister liefern sollte

Sie müssen die Tools nicht selbst bedienen. Sie sollten aber wissen, was Sie verlangen können. Ein guter Dienstleister liefert Ihnen:

  • eine SBOM im CycloneDX- oder SPDX-Format, maschinenlesbar als JSON
  • alle direkten und transitiven Abhängigkeiten mit Version und Lizenz
  • eine automatische Erzeugung bei jedem Release
  • regelmäßige Schwachstellen-Scans auf Basis der SBOM
  • eine kurze Einschätzung kritischer Funde mit Empfehlung

Fehlt einer dieser Punkte, fragen Sie nach. Eine einmal erstellte PDF-Liste reicht für den CRA nicht aus.

Die SBOM passt gut in eine laufende Software-Wartung. Dort laufen Updates und Scans ohnehin regelmäßig. Die Stückliste entsteht dann nebenbei mit.

Fazit: Eine SBOM erstellen ist der leichte Teil

Mit cyclonedx-php-composer, cyclonedx-npm oder cdxgen steht die erste SBOM nach wenigen Minuten. In der Pipeline entsteht sie danach bei jedem Release von selbst. Aufwendig wird es nur, wenn Composer fehlt oder Bibliotheken ohne Version im Code liegen. Dann ist vorher etwas Aufräumarbeit nötig. Solche technischen Schulden lassen sich aber Schritt für Schritt abbauen.

Sie wissen nicht, wie es um die Abhängigkeiten in Ihrem Projekt steht? Oder Ihr System nutzt noch gar keinen Paketmanager? Sprechen Sie uns an. Das Erstgespräch ist kostenlos.

Weitere Artikel

Abstraktes Titelbild zum Thema SBOM-Pflicht: Was eine Software-Stückliste ist und wer sie braucht (KI-generiert)
· 6 Min. Lesezeit

SBOM-Pflicht: Was eine Software-Stückliste ist und wer sie braucht

Eine SBOM listet alle Bauteile einer Software auf, von Bibliotheken bis zu Abhängigkeiten. Mit dem Cyber Resilience Act wird die SBOM-Pflicht für viele Hersteller real. Dieser Artikel erklärt den Begriff, die Formate und den tatsächlichen Aufwand.

Compliance & RegulierungCyber Resilience ActSBOM
Abstraktes Titelbild zum Thema CE-Kennzeichnung für Software: Was der Cyber Resilience Act ab Dezember 2027 verlangt (KI-generiert)
· 7 Min. Lesezeit

CE-Kennzeichnung für Software: Was der Cyber Resilience Act ab Dezember 2027 verlangt

Ab dem 11. Dezember 2027 gilt die CE-Kennzeichnung für Software auch für Cybersicherheit. Wir erklären, was Konformitätsbewertung, technische Dokumentation und EU-Konformitätserklärung für Hersteller bedeuten. Und wie Sie mit gewachsener Software rechtzeitig fertig werden.

Compliance & RegulierungCyber Resilience ActCE-Kennzeichnung
Abstraktes Titelbild zum Thema Vulnerability Disclosure Policy und security.txt: Was der CRA von Herstellern verlangt (KI-generiert)
· 6 Min. Lesezeit

Vulnerability Disclosure Policy und security.txt: Was der CRA von Herstellern verlangt

Eine Vulnerability Disclosure Policy legt fest, wie Sie mit gemeldeten Sicherheitslücken umgehen. Der Cyber Resilience Act macht sie für Hersteller zur Pflicht. Dieser Artikel zeigt, was hineingehört, wie eine security.txt aussieht und wie Sie Meldungen sauber bearbeiten.

Compliance & RegulierungCyber Resilience ActIT-Sicherheit

Bereit, Ihre Software in gute Hände zu geben?

Das Erstgespräch ist kostenlos und unverbindlich. Wir schauen uns an, was Sie haben, und sagen Ihnen ehrlich, was möglich ist.

Kostenlose Erstberatung anfragen