Exportieren einer Software-Stückliste (Software Bill of Materials, SBOM) für dein Repository

In diesem Artikel

Du kannst eine Software-Stückliste (SBOM) für dein Repository aus dem Abhängigkeitsdiagramm exportieren. SBOMs ermöglichen Transparenz bei deiner Open Source-Nutzung und helfen dabei, Sicherheitsrisiken in der Lieferkette aufzudecken und dadurch Risiken in der Lieferkette zu reduzieren.

Wer kann dieses Feature verwenden?

Anyone can export the dependency graph of a repository as a software bill of materials. The SBOM export will contain a list of the dependencies that are used in the repository.

Informationen zum Abhängigkeitsdiagramm und zu SBOM-Exporten

Das Abhängigkeitsdiagramm ist eine Zusammenfassung von Manifest- und Sperrdateien, die in einem Repository gespeichert sind, und aller mithilfe der Abhängigkeitsübermittlungs-API (Beta) für das Repository übermittelten Abhängigkeiten. Für jedes Repository wird Folgendes angezeigt:

  • Abhängigkeiten (die Ökosysteme und Pakete, von denen es abhängig ist)
  • Abhängige Elemente (die Repositorys und Pakete, die von ihm abhängig sind)

Für jede Abhängigkeit werden die Lizenzinformationen und Sicherheitsrisikoschweregrade angezeigt. Du kannst auch über die Suchleiste nach einer bestimmten Abhängigkeit suchen. Abhängigkeiten werden automatisch nach dem Sicherheitsrisikoschweregrad sortiert.

Du kannst den aktuellen Zustand des Abhängigkeitsdiagramms für dein Repository als Softwarestückliste im branchenüblichen SPDX-Format exportieren:

  • Über die GitHub-Benutzeroberfläche
  • Verwenden der REST-API

Eine SBOM ist ein formales, maschinenlesbares Verzeichnis der Abhängigkeiten eines Projekts und der zugehörigen Informationen (wie Versionen, Paketbezeichner und Lizenzen). SBOMs reduzieren durch Folgendes die Lieferkettenrisiken:

  • Transparenz über die von deinem Repository verwendeten Abhängigkeiten
  • Frühzeitige Identifizierung von Sicherheitsrisiken
  • Einblicke in die Lizenzkonformität, Sicherheit oder Qualitätsprobleme, die in deiner Codebasis bestehen können
  • Einfachere Einhaltung verschiedener Datenschutzstandards

Wenn dein Unternehmen der US-Regierung Software gemäß Durchführungsverordnung 14028 zur Verfügung stellt, musst du eine SBOM für dein Produkt bereitstellen. Du kannst SBOMs auch als Teil deines Überwachungsprozesses und zur Einhaltung rechtlicher und gesetzlicher Anforderungen verwenden.

Exportieren einer Software-Stückliste für dein Repository über die Benutzeroberfläche

  1. Navigiere auf GitHub.com zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf die Option -Erkenntnisse.

    Screenshot der Hauptseite eines Repositorys. In der horizontalen Navigationsleiste ist eine Registerkarte, die mit einem Diagrammsymbol versehen und mit „Erkenntnisse“ beschriftet ist, dunkelorange umrandet.

  3. Klicke auf der linken Randleiste auf Abhängigkeitsdiagramm.

  4. Klicke oben rechts auf der Registerkarte Abhängigkeiten auf SBOM exportieren, um eine SBOM-Datei zum Herunterladen aus deinem Browser zu generieren.

Exportieren einer Softwarestückliste für dein Repository über die REST-API

Wenn du mithilfe der REST-API eine SBOM für dein Repository exportieren möchtest, finden du weitere Informationen in der REST-API-Dokumentation unter Software-Stückliste (Software Bill of Materials, SBOM).