In diesem Dokument wird beschrieben, wie Sie Abhängigkeitsmetadaten ansehen und filtern, die von Artefaktanalyse durch automatisches Scannen erkannt werden.
Wenn Sie die Scanning API aktivieren, um Sicherheitslücken in Container-Images zu identifizieren, erfasst die Artefaktanalyse auch Informationen zu den Abhängigkeiten und Lizenzen, die in Ihren Images verwendet werden.
Anhand dieser Metadaten können Sie die Komponenten Ihrer Container-Images nachvollziehen und Sicherheitsprobleme beheben.
Artefaktanalyse bietet Abhängigkeits- und Lizenzerkennung für Betriebssystempakete und unterstützte Sprachpakete in Container-Images, die in einem Artifact Registry-Repository im Docker-Format gespeichert sind. Weitere Informationen finden Sie unter Container-Scans – Übersicht.
Wie Informationen zu Sicherheitslücken werden Lizenz- und Abhängigkeitsmetadaten jedes Mal generiert, wenn Sie ein Image per Push an Artifact Registry übertragen, und dann in der Artefaktanalyse gespeichert.
Artefaktanalyse scannt Images und Pakete weiterhin, solange sie in den letzten 30 Tagen abgerufen wurden. Nach 30 Tagen werden die Metadaten für gescannte Bilder und Pakete nicht mehr aktualisiert und die Ergebnisse sind veraltet.
Die Artefaktanalyse archiviert Metadaten, die seit mehr als 90 Tagen inaktiv sind. Diese archivierten Metadaten können nur über die API ausgewertet werden. Sie können ein Image mit veralteten oder archivierten Metadaten noch einmal scannen, indem Sie es per Pull abrufen. Das Aktualisieren der Metadaten kann bis zu 24 Stunden dauern. Pakete mit veralteten oder archivierten Metadaten können nicht neu gescannt werden.
Hinweis
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Container Analysis, Artifact Registry APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Install the Google Cloud CLI.
-
Configure the gcloud CLI to use your federated identity.
For more information, see Sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init - Sie haben ein Docker-Repository in Artifact Registry . Weitere Informationen zum Generieren von SBOMs
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von SBOM-Daten und zum Filtern von Ergebnissen benötigen:
- Betrachter von Container Analysis-Vorkommen (
roles/containeranalysis.occurrences.viewer) - Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer) - Artifact Registry-Leser (
roles/artifactregistry.reader)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Lizenzen und Abhängigkeiten in der Google Cloud -Console ansehen
Öffnen Sie die Seite Repositories von Artifact Registry.
Auf der Seite wird eine Liste Ihrer Repositories angezeigt.
Klicken Sie in der Liste der Repositories auf einen Repository-Namen.
Die Seite Repository details (Repository-Details) wird geöffnet und zeigt eine Liste Ihrer Bilder an.
Klicken Sie in der Liste der Images auf einen Image-Namen.
Auf der Seite wird eine Liste Ihrer Image-Digests angezeigt.
Klicken Sie in der Liste der Image-Digests auf einen Digest-Namen.
Auf der Seite wird eine Reihe von Tabs angezeigt, wobei der Tab Übersicht geöffnet ist. Hier finden Sie Details wie Format, Speicherort, Repository, virtuelle Größe und Tags.
Klicken Sie in der Tab-Zeile auf den Tab Dependencies (Abhängigkeiten).
Der Tab „Abhängigkeiten“ wird geöffnet und enthält die folgenden Informationen:
- SBOM-Abschnitt
- Abschnitt „Lizenzen“
- Eine filterbare Liste der Abhängigkeiten
SBOMs
Wenn Sie mit Artefaktanalyse eine Software-Materialliste (SBOM) generieren oder hochladen, werden die SBOM-Details in diesem Abschnitt angezeigt. SBOMs werden nicht automatisch generiert wie Lizenz- und Abhängigkeitsinformationen. Informationen zum Hinzufügen von SBOMs finden Sie unter SBOM-Übersicht.
Lizenzen
Im Zusammenfassungsbereich Lizenzen wird ein Balkendiagramm mit dem Titel Häufigste Lizenzen angezeigt. Dies sind die Lizenztypen, die in Ihren Abhängigkeitsinformationen am häufigsten vorkommen. Wenn Sie den Mauszeiger auf einen Balken im Diagramm bewegen, wird in der Konsole die genaue Anzahl der Instanzen dieses Lizenztyps angezeigt.
Abhängigkeiten
Die Liste der Abhängigkeiten enthält den Inhalt Ihres Bild-Digests, einschließlich:
- Paketname
- Paketversion
- Pakettyp
- Lizenztyp
Sie können die Liste der Abhängigkeiten nach einer dieser Kategorien filtern.
Lizenzen und Abhängigkeiten in Cloud Build ansehen
Wenn Sie Cloud Build verwenden, können Sie die Metadaten von Images in der Seitenleiste Sicherheitsinformationen in der Google Cloud Console aufrufen.
Die Seitenleiste Sicherheitsinformationen bietet einen allgemeinen Überblick über die Buildsicherheitsinformationen für Artefakte, die in Artifact Registry gespeichert sind. Weitere Informationen zur Seitenleiste und dazu, wie Sie Cloud Build zum Schutz Ihrer Softwarelieferkette verwenden können, finden Sie unter Sicherheitserkenntnisse für Builds ansehen.
Beschränkungen
Informationen zu Lizenzen und Abhängigkeiten sind nur bei automatischem Scannen verfügbar. Diese Funktion wird beim On-Demand-Scannen nicht unterstützt.
Nächste Schritte
- Erstellen Sie eine Software-Materialliste (SBOM), um die Compliance-Anforderungen zu erfüllen.
- Sicherheitslücken untersuchen: Verwenden Sie gängige Abfragemuster.
- VEX-Erklärungen erstellen, um den Sicherheitsstatus Ihrer Images zu attestieren.