Nach Secrets suchen

Vorschau

Dieses Produkt oder Feature unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Bei Artefaktanalyse-Scans auf Sicherheitslücken können vertrauliche Informationen wie Dienstkontoschlüssel und API-Schlüssel erkannt werden, die in gescannten Bildern gespeichert sind. Informationen zu diesen vertraulichen Daten finden Sie im Ereignisbericht des Scans auf Sicherheitslücken. Sie können dann Maßnahmen ergreifen, um die Offenlegung vertraulicher Informationen zu verhindern.

Übersicht

Wenn bei einem Scan auf Sicherheitslücken ein Secret erkannt wird, erstellt die Artefaktanalyse ein Vorkommen vom Typ „Secret“ mit Details zum Secret. Bei der Artefaktanalyse können die folgenden Secrets erkannt werden:

Secrets

• Anthropic-Administratorschlüssel
• Anthropic-API-Schlüssel
• Azure-Zugriffstokens
• Azure-ID-Tokens
• Persönliche Zugriffstokens für Docker Hub
• Aktualisierungstokens für GitHub-Apps
• Server-zu-Server-Tokens für GitHub-Apps
• Nutzer-zu-Server-Tokens für GitHub-Apps
• Klassische persönliche GitHub-Zugriffstokens
• Granulare persönliche Zugriffstokens für GitHub
• GitHub-OAuth-Tokens
• Google Cloud  OAuth2-Paare (Client-ID und Client-Secret)
• Google Cloud OAuth2-Zugriffstokens
• Google Cloud -Dienstkontoschlüssel
• Google Cloud API-Schlüssel
• Huggingface-API-Schlüssel
• OpenAI-API-Schlüssel
• Perplexity API-Schlüssel
• Eingeschränkte Stripe-Schlüssel
• Geheime Stripe-Schlüssel
• Stripe-Webhook-Secrets

Ausführliche Informationen zu den verschiedenen Arten von vertraulichen Informationen in Ereignisberichten finden Sie in der Dokumentation zur Artifact Analysis API unter SecretKind.

Mit der Artefaktanalyse können nur Secrets erkannt werden, die als Textdateien gespeichert sind. Die folgenden Dateiendungen werden unterstützt:

• .cer
• .cfg
• .crt
• .der
• .env
• .html
• .key
• .ipynb
• .json
• .log
• .md
• .pem
• .py
• .pypirc
• .textproto
• .toml
• .txt
• .xml
• .yaml

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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 the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry and Container Scanning APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. 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.

Enable the APIs

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

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 the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry and Container Scanning APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. 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.

Enable the APIs

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

Wichtig :Wenn Sie die Artifact Analysis API aktivieren, beginnt Artefaktanalyse automatisch mit dem Scannen jedes neuen Images, das in Artifact Registry-Repositories in Ihrem Projekt übertragen wird. Das Scannen ist jedoch standardmäßig für Pakete deaktiviert, die an Artifact Registry-Repositories gesendet werden. Informationen zum Aktivieren des Scannens in einem Repository finden Sie unter Scaneinstellungen für ein einzelnes Repository verwalten.

Wenn Sie diese API aktivieren, wird auch das Scannen von Sprachpaketen in Artifact Registry aktiviert. Unterstützte Pakettypen

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Scannen von Images nach Secrets während der Scans auf Sicherheitslücken haben:

• Artifact Registry-Autor (roles/artifactregistry.writer)
• Container Analysis Occurrences Viewer (roles/containeranalysis.occurrences.viewer)

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.

Secrets ansehen

So rufen Sie Secrets nach einem Scan auf Sicherheitslücken auf:

1. Docker-Image per Push an Artifact Registry übertragen

2. Warten Sie, bis der Scan auf Sicherheitslücken abgeschlossen ist.

3. Führen Sie den folgenden Befehl aus, um Secret-Vorkommen für das gescannte Image aufzulisten:

   $ curl -G -H "Content-Type: application/json"   -H "Authorization: Bearer $(gcloud auth print-access-token)" --data-urlencode "filter=(kind=\"SECRET\" AND resourceUrl=\"RESOURCE_URL\")" https://containeranalysis.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/occurrences
   

   Wobei:

   • PROJECT_ID ist die Projekt-ID Ihrer Google Cloud -Konsole.
   • LOCATION ist der regionale oder multiregionale Standort Ihres Repositorys.
   • RESOURCE_URL ist die URL des gescannten Bildes im Format https://LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID.

   Die folgende Beispielantwort zeigt ein mögliches Ergebnis. In diesem Fall wurde einGoogle Cloud API-Schlüssel mit dem Namen my_api_key.yaml im documents-Verzeichnis eines Bildes gefunden. Das Attribut secret enthält Informationen zum gefundenen Secret.

   {
     "occurrences": [
       {
         "name": "projects/my-project/locations/us-east1/occurrences/45619d23-66b1-4f5b-9b12-9060d7f97ff3",
         "resourceUri": "https://us-east1-docker.pkg.dev/my-project/my-images/test-image-0106@sha256:73cf5b9a788dc391c40e9cf1599144d03875b5d2dc935988ebfef8260bd2678e",
         "noteName": "projects/my-project/locations/us-east1/notes/secret_kind_gcp_api_key",
         "kind": "SECRET",
         "createTime": "2026-01-06T21:16:14.905851Z",
         "updateTime": "2026-01-06T21:16:14.905851Z",
         "secret": {
           "kind": "SECRET_KIND_GCP_API_KEY",
           "locations": [
             {
               "fileLocation": {
                 "filePath": "documents/my_api_key.yaml",
                 "layerDetails": {
                   "index": 2,
                   "diffId": "7b76df10d6d90391830392eac96b0ef2d2d43822c6ff4754aa6daea0fe14a8c5",
                   "command": "COPY . . # buildkit",
                   "chainId": "sha256:75df0c59982f47cc38e730e1a122b67fceaaf7797d91e1fa17ffffc5cfe7ff59"
                 }
               }
             }
           ]
         }
       }
     ]
   }
   

Beschränkungen

• Während des öffentlichen Vorschauzeitraums von Secret Scanning sind Vorkommen von Secret-Typen nur in der Container Analysis API sichtbar.
• Die Artefaktanalyse meldet beim Scannen von Secrets maximal ein Vorkommen pro Secret und Image. Pro Vorkommen werden maximal 1.000 Dateispeicherorte zurückgegeben.
• Bei erkannten vertraulichen Informationen kann es zu falsch positiven Ergebnissen kommen. Überprüfen Sie immer jedes identifizierte Secret, bevor Sie Maßnahmen für Ihre Images ergreifen.