Cloud Asset Inventory in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Cloud Asset Inventory in Google Security Operations einbinden.

Anwendungsfälle

Bei der Cloud Asset Inventory-Integration werden Google SecOps-Funktionen verwendet, um die folgenden Anwendungsfälle zu unterstützen:

  • Google Cloud Ressourcen anreichern: Detaillierte Metadaten für Cloud-Ressourcen werden automatisch mithilfe vollständiger Ressourcennamen abgerufen, um Kontext für Sicherheitswarnungen bereitzustellen.

  • Ressourcen-Snapshots abrufen: Sie erhalten eine Momentaufnahme der Ressourcenkonfigurationen und des Status, die bei forensischen Untersuchungen und der Analyse von Änderungen hilfreich ist.

  • Berechtigungen von Dienstkonten prüfen: Rollen und eindeutige Berechtigungen auflisten, die mit Dienstkonten verknüpft sind, um Identitäten mit zu vielen Berechtigungen zu identifizieren und das Prinzip der geringsten Berechtigung einzuhalten.

  • Multi-Cloud-Assets inventarisieren: Greifen Sie auf Ressourcendetails inGoogle Cloud und verbundenen externen Umgebungen zu, um die Sichtbarkeit von Assets bei Untersuchungen zu zentralisieren.

Hinweis

Bevor Sie die Cloud Asset Inventory-Integration in Google SecOps konfigurieren, führen Sie die folgenden erforderlichen Schritte aus:

  1. Erstellen Sie ein Dienstkonto.

  2. Benutzerdefinierte IAM-Rolle erstellen

  3. Weisen Sie Ihrem Dienstkonto die erforderlichen Rollen zu.

  4. Wählen Sie eine der folgenden Authentifizierungsmethoden aus und konfigurieren Sie sie:

    • Option 1: Workload Identity (empfohlen): Bei dieser Methode werden kurzlebige, temporäre Zugriffstokens mithilfe der Dienstkonto-Identitätsübernahme verwendet. Dadurch müssen keine vertraulichen Informationen gespeichert werden.

    • Option 2: JSON-Schlüssel für Dienstkonto: Bei dieser Methode wird eine statische, langlebige Secret-Schlüsseldatei verwendet. Verwenden Sie diese Methode nur, wenn Workload Identity in Ihrer Umgebung nicht verfügbar ist.

Dienstkonto erstellen

So erstellen Sie ein Dienstkonto:

  1. Rufen Sie in der Google Cloud Console Anmeldedaten auf.

    Zu den Anmeldedaten

  2. Wählen Sie im Menü Anmeldedaten erstellen die Option Dienstkonto aus.

  3. Geben Sie im Feld Name des Dienstkontos einen Namen ein und klicken Sie auf Erstellen und fortfahren.

  4. Überspringen Sie die optionalen Bildschirme für die Rollenzuweisung und den Prinzipalzugriff, indem Sie auf Weiter> Fertig klicken.

  5. Kopieren Sie die E-Mail-Adresse des Dienstkontos, um sie in den Konfigurationsschritten zu verwenden.

Benutzerdefinierte IAM-Rolle erstellen

Erstellen Sie eine benutzerdefinierte Rolle, um der Integration die erforderlichen Suchfunktionen zur Verfügung zu stellen:

  1. Rufen Sie in der Google Cloud Console die Seite IAM & Verwaltung > Rollen auf.

    Zu Rollen

  2. Klicken Sie auf Rolle erstellen und geben Sie einen Titel (z. B. „SecOps Asset Searcher“) und eine eindeutige ID an.

  3. Setzen Sie die Rollenstartphase auf Allgemeine Verfügbarkeit.

  4. Klicken Sie auf Berechtigungen hinzufügen und fügen Sie cloudasset.assets.searchAllResources hinzu.

  5. Klicken Sie auf Erstellen.

Dienstkonto Rollen zuweisen

Damit die Integration auf Ihre Ressourcen zugreifen kann, weisen Sie Ihrem Dienstkonto die folgenden Rollen zu:

  1. Wechseln Sie in der Google Cloud Console zu IAM & Verwaltung > IAM.

  2. Suchen Sie Ihr Dienstkonto und klicken Sie auf BearbeitenHauptkonto bearbeiten.

  3. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie Folgendes aus:

    • Die benutzerdefinierte IAM-Rolle, die im vorherigen Schritt erstellt wurde.

    • Cloud Asset Viewer

    • Dienstnutzungsnutzer (nur erforderlich, wenn Sie ein Quota Project ID verwenden).

  4. Klicken Sie auf Speichern.

Workload Identity-Anmeldedaten konfigurieren

Wählen Sie diese Methode oder die JSON-Schlüsselmethode aus, um die Integration zu authentifizieren. Workload Identity ist der empfohlene und sicherere Ansatz, da kurzlebige, temporäre Zugriffstokens mithilfe der Identitätsübernahme des Dienstkontos verwendet werden. Dadurch entfällt die Notwendigkeit, langlebige Secrets zu speichern oder zu rotieren.

Eindeutige Instanzidentität ermitteln

Wenn Sie sich mit einer Workload Identity authentifizieren möchten, müssen Sie Ihrer Google SecOps-Instanz die Berechtigung erteilen, die Identität Ihres Dienstkontos zu übernehmen. So kann die Instanz sicher auf Google Cloud Ressourcen zugreifen.

  1. Rufen Sie in Google SecOps Content Hub > Response Integrations auf.

  2. Wählen Sie die Cloud Asset Inventory-Integration aus und geben Sie die E‑Mail-Adresse Ihres Dienstkontos in Workload Identity Email ein.

  3. Klicken Sie auf Speichern > Test. Der Test wird voraussichtlich fehlschlagen.

  4. Klicken Sie rechts neben Test auf close_small und suchen Sie in der Fehlermeldung nach der Identitäts-E-Mail-Adresse, die mit gke-init-python@... oder soar-python@... beginnt.

  5. Kopieren Sie diese eindeutige E‑Mail-Adresse.

Instanzidentität in Google Cloudautorisieren

Nachdem Sie die eindeutige Identität für Ihre Google SecOps-Instanz abgerufen haben, müssen Sie sie autorisieren, auf IhreGoogle Cloud -Ressourcen zuzugreifen. Mit diesem Schritt wird die Identitätsübernahme des Dienstkontos aktiviert. So kann die Plattform kurzlebige Tokens generieren und in Ihrem Namen agieren, ohne dass statische Schlüssel erforderlich sind.

  1. Wechseln Sie in der Google Cloud Console zu IAM & Verwaltung > Dienstkonten.

    Zur Seite „Dienstkonten“

  2. Wählen Sie das Zieldienstkonto aus und rufen Sie Berechtigungen > Zugriff gewähren auf.

  3. Fügen Sie die eindeutige E-Mail-Adresse in das Feld Neue Hauptkonten ein und weisen Sie die Rolle Ersteller von Dienstkonto-Tokens (roles/iam.serviceAccountTokenCreator) zu.

Zugriff auf Kontingentprojekt gewähren

Wenn Sie sich mit einer Workload Identity authentifizieren, müssen Sie in den Integrationseinstellungen ein Quota Project ID angeben, um die API-Nutzung und Abrechnung zu erfassen.

Dazu müssen Sie Ihrem Dienstkonto die folgende Rolle für das angegebene Kontingentprojekt zuweisen:

  1. Rufen Sie in der Google Cloud Console IAM & Verwaltung > IAM auf und wählen Sie Ihr Projekt aus.

    IAM aufrufen

  2. Suchen Sie in der Liste der Hauptkonten nach Ihrem Dienstkonto und klicken Sie für dieses Konto auf Bearbeiten(Hauptkonto bearbeiten).

  3. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie die Rolle Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) aus.

  4. Klicken Sie auf Speichern.

JSON-Schlüssel konfigurieren

Wählen Sie diese Methode oder die Workload Identity-Methode aus, um die Integration zu authentifizieren. Verwenden Sie die JSON-Schlüsselmethode nur, wenn Workload Identity in Ihrer Umgebung nicht verfügbar ist. Workload Identity ist der empfohlene und sicherere Ansatz. Diese Methode basiert auf einer statischen, langlebigen Secret-Schlüsseldatei, die manuell verwaltet und rotiert werden muss.

So generieren Sie die JSON-Schlüsseldatei, die zur Authentifizierung der Integration erforderlich ist:

  1. Wechseln Sie in der Google Cloud Console zu IAM & Verwaltung > Dienstkonten und wählen Sie das erstellte Dienstkonto aus.

    Zur Seite „Dienstkonten“

  2. Rufen Sie den Tab Schlüssel auf.

  3. Klicken Sie auf Schlüssel hinzufügen> Neuen Schlüssel erstellen.

  4. Wählen Sie JSON als Schlüsseltyp aus und klicken Sie auf Erstellen. Die JSON-Datei wird auf Ihren Computer heruntergeladen.

  5. Kopieren Sie den gesamten Inhalt dieser Datei und fügen Sie ihn während der Konfiguration der Integration in User's Service Account ein.

Integrationsparameter

Für die Cloud Asset Inventory-Integration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root Erforderlich

Der API-Root der Cloud Asset Inventory-Instanz.

Der Standardwert ist https://cloudasset.googleapis.com.
Organization ID Optional

Die Organisations-ID, die in der Cloud Asset Inventory-Integration verwendet werden soll.
Project ID Optional

Die Projekt-ID, die für die Cloud Asset Inventory-Integration verwendet werden soll. Wenn kein Wert angegeben wird, ruft die Integration die Projekt-ID aus dem Inhalt der JSON-Datei ab, die im Parameter User's Service Account angegeben ist.
User's Service Account Erforderlich

Der vollständige Inhalt der JSON-Schlüsseldatei des Dienstkontos.
Quota Project ID Optional

Die Google Cloud -Projekt-ID, die Sie für Google Cloud -APIs und die Abrechnung verwenden. Für diesen Parameter müssen Sie Ihrem Dienstkonto die Rolle Service Usage Consumer zuweisen.

Wenn kein Wert angegeben ist, ruft die Integration die Projekt-ID aus Ihrem Google Cloud Dienstkonto ab.
Workload Identity Email Optional.

Die Client-E-Mail-Adresse des Dienstkontos, das für die Identitätsübernahme von Workload Identity verwendet wird.
Verify SSL Erforderlich

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum Cloud Asset Inventory-Server validiert.

Standardmäßig aktiviert.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Bei Bedarf können Sie später Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen über „Mein Arbeitsbereich“ bearbeiten und Manuelle Maßnahme ausführen.

Ressource anreichern

Mit der Aktion Ressource anreichern können Sie Informationen zu einer Google Cloud-Ressource mit Cloud Asset Inventory anreichern.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Aktion Ressource anreichern zu konfigurieren:

Parameter Beschreibung
Resource Names Erforderlich

Eine durch Kommas getrennte Liste mit Ressourcennamen von Ressourcen, für die Details abgerufen werden sollen.

Geben Sie zur Konfiguration dieses Parameters den vollständigen Namen der Metadatenressource im folgenden Format ein: //cloudresourcemanager.googleapis.com/projects/PROJECT_ID.
Fields To Return Optional

Eine durch Kommas getrennte Liste der Felder, die zurückgegeben werden sollen.

Der Standardwert ist *.

Beispiele für Werte: assetType, project, folders, organization, displayName, description, location, labels, networkTags, kmsKeys, createTime, updateTime, state, additionalAttributes, parentFullResourceName, parentAssetType.

Die Aktion gibt immer das Feld displayName zurück.

Außerdem können Sie erweiterte Filter konfigurieren. Wenn Sie beispielsweise einen bestimmten Schlüssel aus additionalAttributes zurückgeben möchten, geben Sie additionalAttributes.{key} ein. Wenn Sie einen bestimmten Schlüssel aus additionalAttributes ausschließen möchten, geben Sie -additionalAttributes.{key} ein.

Aktionsausgaben

Die Aktion Ressource anreichern liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Ressource anreichern empfangen wird:

[
  {
    "Entity": "//iam.googleapis.com/projects/PROJECT/serviceAccounts/SERVICE_ACCOUNT/keys/KEY_ID",
    "EntityResult": {
      "additionalAttributes": {
        "email": "email@example.iam.gserviceaccount.com",
        "uniqueId": 123456789
      },
      "name": "//iam.googleapis.com/projects/PROJECT/serviceAccounts/SERVICE_ACCOUNT/keys/KEY_ID",
      "assetType": "iam.googleapis.com/ServiceAccountKey",
      "project": "projects/PROJECT",
      "displayName": "projects/PROJECT/serviceAccounts/SERVICE_ACCOUNT@PROJECT.iam.gserviceaccount.com/keys/KEY_ID",
      "createTime": "2022-05-26T17:35:07Z",
      "versionedResources": [
        {
          "version": "v1",
          "resource": {
            "keyAlgorithm": "KEY_ALG_RSA_2048",
            "keyOrigin": "GOOGLE_PROVIDED",
            "keyType": "USER_MANAGED",
            "name": "projects/PROJECT/serviceAccounts/SERVICE_ACCOUNT@PROJECT.iam.gserviceaccount.com/keys/KEY_ID",
            "validAfterTime": "2022-05-26T17:35:07Z",
            "validBeforeTime": "9999-12-31T23:59:59Z"
          }
        }
      ],
      "organization": "organizations/ORGANIZATION",
      "parentFullResourceName": "//iam.googleapis.com/projects/PROJECT/serviceAccounts/SERVICE_ACCOUNT@PROJECT.iam.gserviceaccount.com",
      "parentAssetType": "iam.googleapis.com/ServiceAccount"
    }
  }
]
Ausgabenachrichten

Die Aktion Ressource anreichern kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully enriched the following resources using information from Google Cloud Asset Inventory: ASSET_IDENTIFIER

Action wasn't able to enrich the following resources using information from Google Cloud Asset Inventory: ASSET_IDENTIFIER

None of the provided resources were enriched.

 Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Enrich resources". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Ressource anreichern verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Ressourcen-Snapshot abrufen

Verwenden Sie die Aktion Get Resource Snapshot (Ressourcen-Snapshot abrufen), um Informationen zur Ressource über Cloud Asset Inventory abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Aktion Ressourcen-Snapshot abrufen zu konfigurieren:

Parameter Beschreibung
Resource Names Erforderlich

Eine durch Kommas getrennte Liste von Ressourcen, für die Details abgerufen werden sollen.

Geben Sie zur Konfiguration dieses Parameters den vollständigen Namen der Metadatenressource im folgenden Format ein: //cloudresourcemanager.googleapis.com/projects/PROJECT_ID.
Fields To Return Optional

Eine durch Kommas getrennte Liste der Felder, die zurückgegeben werden sollen.

Geben Sie jedes Feld im folgenden Format ein:

assets.FIELD

Beispiele für Werte: assets.asset.name, assets.asset.assetType, assets.asset.resource.data.

Die Aktion gibt immer das Feld assets.asset.name zurück.

Der Standardwert ist *.

Aktionsausgaben

Die Aktion Ressourcen-Snapshot abrufen liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Die folgenden Beispiele zeigen die JSON-Ergebnisausgaben, die bei Verwendung der Aktion Ressourcen-Snapshot abrufen empfangen werden:

JSON-Ergebnis für Google Cloud
    [
 {
   "Entity": "//compute.googleapis.com/projects/example-project/zones/us-central1-a/instances/example-instance",
   "EntityResult": {
     "window": {
       "startTime": "2023-08-14T19:43:41.805828Z",
       "endTime": "2262-04-11T23:47:16.854775807Z"
     },
     "asset": {
       "name": "//compute.googleapis.com/projects/example-project/zones/us-central1-a/instances/example-instance",
       "assetType": "compute.googleapis.com/Instance",
       "resource": {
         "version": "v1",
         "discoveryDocumentUri": "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest",
         "discoveryName": "Instance",
         "parent": "//cloudresourcemanager.googleapis.com/projects/example-project-id",
         "data": {
           "description": "",
           "serviceAccounts": [
             {
               "email": "user@example.com",
               "scopes": [
                 "https://www.googleapis.com/auth/devstorage.read_only",
                 "https://www.googleapis.com/auth/logging.write",
                 "https://www.googleapis.com/auth/monitoring.write",
                 "https://www.googleapis.com/auth/servicecontrol",
                 "https://www.googleapis.com/auth/service.management.readonly",
                 "https://www.googleapis.com/auth/trace.append"
               ]
             }
           ],
           "lastStartTimestamp": "2022-05-26T01:44:52.756-07:00",
           "deletionProtection": false,
           "name": "example-name",
           "keyRevocationActionType": "NONE_ON_KEY_REVOCATION",
           "canIpForward": false,
           "shieldedInstanceIntegrityPolicy": {
             "updateAutoLearnPolicy": true
           },
           "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
           "resourceStatus": {},
           "scheduling": {
             "onHostMaintenance": "MIGRATE",
             "preemptible": false,
             "provisioningModel": "STANDARD",
             "automaticRestart": true
           },
           "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/machineTypes/e2-micro",
           "confidentialInstanceConfig": {
             "enableConfidentialCompute": false
           },
           "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance",
           "id": "example-id",
           "fingerprint": "example-fingerprint",
           "startRestricted": false,
           "networkInterfaces": [
             {
               "network": "https://www.googleapis.com/compute/v1/projects/example-project/global/networks/example-network",
               "stackType": "IPV4_ONLY",
               "name": "example",
               "subnetwork": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/subnetworks/example-network-subnet",
               "accessConfigs": [
                 {
                   "type": "ONE_TO_ONE_NAT",
                   "name": "External NAT",
                   "natIP": "192.0.2.1",
                   "networkTier": "PREMIUM"
                 }
               ],
               "fingerprint": "example-fingerprint",
               "networkIP": "203.0.113.2"
             }
           ],
           "allocationAffinity": {
             "consumeAllocationType": "ANY_ALLOCATION"
           },
           "labelFingerprint": "example-label",
           "shieldedInstanceConfig": {
             "enableSecureBoot": false,
             "enableVtpm": true,
             "enableIntegrityMonitoring": true
           },
           "cpuPlatform": "Intel Broadwell",
           "creationTimestamp": "2022-05-26T01:44:40.323-07:00",
           "status": "RUNNING",
           "disks": [
             {
               "guestOsFeatures": [
                 {
                   "type": "VIRTIO_SCSI_MULTIQUEUE"
                 },
                 {
                   "type": "SEV_CAPABLE"
                 },
                 {
                   "type": "UEFI_COMPATIBLE"
                 },
                 {
                   "type": "GVNIC"
                 }
               ],
               "interface": "SCSI",
               "shieldedInstanceInitialState": {
                 "dbxs": [
                   {
                     "content": "2gcDBhMRFQAAAAAAAAAAABENAAAAAvEOndK",
                     "fileType": "BIN"
                   }
                 ],
                 "dbx": [
                   {
                     "fileType": "BIN",
                     "content": "2gcDBhMRFQAAAAAAAAAAABENAAAAAvEOndK"
                   }
                 ]
               },
               "diskSizeGb": "10",
               "deviceName": "example-device-name",
               "type": "PERSISTENT",
               "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-instance",
               "boot": true,
               "licenses": [
                 "https://www.googleapis.com/compute/v1/projects/example-project/global/licenses"
               ],
               "index": 0,
               "autoDelete": true,
               "mode": "READ_WRITE"
             }
           ],
           "tags": {
             "items": [
               "http-server"
             ],
             "fingerprint": "example-fingerprint"
           },
           "displayDevice": {
             "enableDisplay": false
           },
           "reservationAffinity": {
             "consumeReservationType": "ANY_ALLOCATION"
           }
         },
         "location": "us-central1-a"
       },
       "ancestors": [
         "projects/example-project-id",
         "organizations/example-org-id"
       ],
       "updateTime": "2023-08-14T19:43:41.805828Z"
     }
   }
 },
 {
   "Entity": "//iam.googleapis.com/projects/example-project/serviceAccounts/example-account-id",
   "EntityResult": {
     "window": {
       "startTime": "2023-12-22T13:37:50Z",
       "endTime": "2262-04-11T23:47:16.854775807Z"
     },
     "asset": {
       "name": "//iam.googleapis.com/projects/example-project/serviceAccounts/example-account-id",
       "assetType": "iam.googleapis.com/ServiceAccount",
       "resource": {
         "version": "v1",
         "discoveryDocumentUri": "https://iam.googleapis.com/$discovery/rest",
         "discoveryName": "ServiceAccount",
         "parent": "//cloudresourcemanager.googleapis.com/projects/example-project-id",
         "data": {
           "name": "projects/example-project/serviceAccounts/cloud-asset-inventory-auto@example-project.iam.gserviceaccount.com",
           "projectId": "example-project",
           "email": "cloud-asset-inventory-auto@example-project.iam.gserviceaccount.com",
           "uniqueId": "example-account-id",
           "displayName": "Cloud Asset Inventory Automation",
           "oauth2ClientId": "example-account-id"
         }
       },
       "ancestors": [
         "projects/example-project-id",
         "organizations/example-org-id"
       ],
       "updateTime": "2023-12-22T13:37:50Z"
     }
   }
 }
]
JSON-Ergebnis für AWS
[
   {
       "Entity": "//cloudasset.googleapis.com/organizations/example-org-id/otherCloudConnections/aws/arn:aws:s3:::aps-max-test-bucket",
       "EntityResult": {
           "assets": [
               {
                   "window": {
                       "startTime": "2024-01-24T17:51:03.412233028Z",
                       "endTime": "2262-04-11T23:47:16.854775807Z"
                   },
                   "asset": {
                       "name": "//cloudasset.googleapis.com/organizations/example-org-id/otherCloudConnections/aws/arn:aws:s3:::aps-max-test-bucket",
                       "assetType": "cloudasset.googleapis.com/AWS::S3::Bucket",
                       "resource": {
                           "version": "v1",
                           "discoveryDocumentUri": "n/a",
                           "discoveryName": "n/a",
                           "data": {
                               "dataSourceProvider": "AMAZON_WEB_SERVICES",
                               "supplementaryConfigurations": {
                                   "PublicAccessBlockConfiguration": {
                                       "BlockPublicPolicy": true,
                                       "RestrictPublicBuckets": true,
                                       "BlockPublicAcls": true,
                                       "IgnorePublicAcls": true
                                   },
                                   "TagSet": [
                                       {
                                           "Key": "my-key2",
                                           "Value": "my-value2"
                                       },
                                       {
                                           "Key": "my-key1",
                                           "Value": "my-value1"
                                       }
                                   ],
                                   "ServerSideEncryptionConfiguration": {
                                       "Rules": [
                                           {
                                               "ApplyServerSideEncryptionByDefault": {
                                                   "SSEAlgorithm": "AES256"
                                               },
                                               "BucketKeyEnabled": true
                                           }
                                       ]
                                   },
                                   "AccessControlPolicy": {
                                       "Grants": [
                                           {
                                               "Grantee": {
                                                   "DisplayName": "example",
                                                   "ID": "example-id",
                                                   "Type": "CanonicalUser"
                                               },
                                               "Permission": "FULL_CONTROL"
                                           }
                                       ],
                                       "Owner": {
                                           "DisplayName": "example",
                                           "ID": "example-id"
                                       }
                                   }
                               },
                               "configuration": {
                                   "Name": "aps-max-test-bucket",
                                   "CreationDate": "2023-12-04T15:29:50+00:00"
                               },
                               "tags": {
                                   "my-key2": "my-value2",
                                   "my-key1": "my-value1"
                               },
                               "originalResourceName": "arn:aws:s3:::aps-max-test-bucket",
                               "awsAccount": "arn:aws:organizations::example-id:account/example-account/example-account-id"
                           },
                           "location": "global"
                       },
                       "ancestors": [
                           "organizations/example-org-id"
                       ],
                       "updateTime": "2024-01-24T17:51:03.412233028Z"
                   }
               }
           ]
       }
   }
]
Ausgabenachrichten

Die Aktion Get Resource Snapshot (Ressourcen-Snapshot abrufen) kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung
Successfully returned information about the following resources using Google Cloud Asset Inventory: ASSET_IDENTIFIER

Action wasn't able to return information about the following resources using Google Cloud Asset Inventory: ASSET_IDENTIFIER.

No information was found for the provided resources.

 Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Get Resource Snapshot". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get Resource Snapshot verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Dienstkontorollen auflisten

Mit der Aktion List Service Account Roles (Dienstkontorollen auflisten) können Sie Rollen auflisten, die mit dem Dienstkonto Google Cloud über Cloud Asset Inventory verknüpft sind.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Aktion List Service Account Roles (Dienstkontorollen auflisten) zu konfigurieren:

Parameter Beschreibung
Service Accounts Erforderlich

Eine durch Kommas getrennte Liste der Dienstkonten, für die Details abgerufen werden sollen.
Check Roles Optional

Eine durch Kommas getrennte Liste der Rollen, die in Bezug auf das Dienstkonto geprüft werden sollen, z. B. roles/cloudasset.owner.
Check Permissions Optional

Eine durch Kommas getrennte Liste der Berechtigungen, die in Bezug auf das Dienstkonto geprüft werden sollen, z. B. cloudasset.assets.listResource .
Expand Permissions Optional

Wenn diese Option ausgewählt ist, gibt die Aktion Informationen zu allen eindeutigen Berechtigungen zurück, die mit der Ressource verknüpft sind.

Diese Option ist standardmäßig nicht ausgewählt.
Max Roles To Return Erforderlich

Die Anzahl der Rollen, die für das Dienstkonto zurückgegeben werden sollen.

Der Standardwert ist 100.
Max Permissions To Return Erforderlich

Die Anzahl der Berechtigungen, die für das Dienstkonto zurückgegeben werden sollen.

Aktionsausgaben

Die Aktion Dienstkontorollen auflisten gibt die folgenden Ausgaben zurück:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Dienstkontorollen auflisten empfangen wird:

{
   "roles": ["role1", "role2"],
   "unique_permissions": ["permission1", "permission2"]
}
Ausgabenachrichten

Die Aktion List Service Account Roles kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully enriched for the following service accounts using information from Google Cloud Asset Inventory: ASSET_IDENTIFIER

Action wasn't able to enrich the following service accounts using information from Google Cloud Asset Inventory: ASSET_IDENTIFIER

None of the service accounts were enriched.

 Die Aktion wurde erfolgreich ausgeführt.
Error executing action "List Service Account Roles". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Ping

Verwenden Sie die Aktion Ping, um die Verbindung zu Cloud Asset Inventory zu testen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Ausgabenachrichten

Die Aktion Ping kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung
Successfully connected to the Google Cloud Asset Inventory server with the provided connection parameters! Die Aktion wurde erfolgreich ausgeführt.
Failed to connect to the Google Cloud Asset Inventory server! Die Aktion ist fehlgeschlagen.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping aufgeführt:

Name des Scriptergebnisses Wert
is_success True oder False

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten