Cloud Asset Inventory in Google SecOps einbinden

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

Anwendungsfälle

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

  • Google Cloud -Ressourcen anreichern: Ruft automatisch detaillierte Metadaten für Cloud-Ressourcen mithilfe vollständiger Ressourcennamen ab, um Kontext für Sicherheitswarnungen bereitzustellen.

  • Ressourcen-Snapshots abrufen: Sie erhalten eine zeitpunktbezogene Ansicht der Ressourcenkonfigurationen und des Status, um forensische Untersuchungen und Änderungsanalysen zu unterstützen.

  • Dienstkontoberechtigungen prüfen: Listen Sie Rollen und eindeutige Berechtigungen auf, 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 Ihrer Assets bei Prüfungen zu zentralisieren.

Hinweis

Bevor Sie die Cloud Asset Inventory-Integration in Google SecOps konfigurieren, müssen Sie die folgenden Voraussetzungen erfüllen:

  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 verwendet, die über die Identitätsübernahme des Dienstkontos generiert werden. Es müssen keine Secrets gespeichert werden.

    • Option 2: JSON-Schlüssel für Dienstkonto: Diese Methode basiert auf einer statischen, langlebigen Secret-Schlüsseldatei. 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 die Seite Anmeldedaten auf.

    Zu den Anmeldedaten

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

  3. Geben Sie im Feld Dienstkontoname einen Namen ein und klicken Sie auf Erstellen und fortfahren.

  4. Überspringen Sie die optionalen Bildschirme für die Rollenzuweisung und den Hauptkontozugriff, 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 die Integration mit den erforderlichen Suchfunktionen bereitzustellen:

  1. Rufen Sie in der Google Cloud Console 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 ein.

  3. Legen Sie die Rollenstartphase auf Allgemeine Verfügbarkeit fest.

  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. Rufen Sie in der Google Cloud Console IAM & Verwaltung > IAM auf.

  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 im vorherigen Schritt erstellte benutzerdefinierte IAM-Rolle.

    • Cloud Asset Viewer.

    • Service Usage Consumer (nur erforderlich, wenn Sie einen 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 hier kurzlebige, temporäre Zugriffstokens verwendet werden, die die Identitätsübernahme des Dienstkontos nutzen. Dadurch müssen keine langlebigen Secrets gespeichert oder rotiert werden.

Eindeutige Instanzidentität identifizieren

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. Dadurch kann die Instanz sicher auf Google Cloud -Ressourcen zugreifen.

  1. Rufen Sie in Google SecOps Content Hub > Antwortintegrationen 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 > Testen. Der Test schlägt erwartungsgemäß fehl.

  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 für den Zugriff auf IhreGoogle Cloud -Ressourcen autorisieren. In diesem Schritt wird die Identitätsübernahme des Dienstkontos aktiviert. Dadurch kann die Plattform kurzlebige Tokens generieren und in Ihrem Namen agieren, ohne dass statische Schlüssel erforderlich sind.

  1. Rufen Sie in der Google Cloud Console IAM und Verwaltung > Dienstkonten auf.

    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 eine Quota Project ID angeben, um die API-Nutzung und die Abrechnung zu verfolgen.

Dazu müssen Sie Ihrem Dienstkonto die folgende Rolle für das festgelegte 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 die empfohlene und sicherere Methode. Diese Methode basiert auf einer statischen, langlebigen Secret-Schlüsseldatei, die manuell verwaltet und rotiert werden muss.

Gehen Sie so vor, um die JSON-Schlüsseldatei zu generieren, die für die Authentifizierung der Integration erforderlich ist:

  1. Wechseln Sie in der Google Cloud Console zu IAM und Verwaltung > Dienstkonten und wählen Sie das von Ihnen 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 als Schlüsseltyp JSON 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 Integrationskonfiguration 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-Stamm 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, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum Cloud Asset Inventory-Server hergestellt wird.

Standardmäßig aktiviert.

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

Sie können später bei Bedarf Ä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 Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Ressource anreichern

Verwenden Sie die Aktion Ressource anreichern, um Informationen zu einer Google Cloud-Ressource mit Cloud Asset Inventory anzureichern.

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:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit 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 Sie bei Verwendung der Aktion Ressource anreichern erhalten:

[
  {
    "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 Beschreibung der Nachricht

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 war erfolgreich.
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 sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Ressource anreichern verwendet wird:

Name des Skriptergebnisses Wert
is_success True oder False

Ressourcen-Snapshot abrufen

Verwenden Sie die Aktion 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 zum Konfigurieren 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:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit 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 Ressourcen-Snapshot abrufen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht
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 war erfolgreich.
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 Ressourcen-Snapshot abrufen verwendet wird:

Name des Skriptergebnisses Wert
is_success True oder False

Dienstkontorollen auflisten

Verwenden Sie die Aktion Dienstkontorollen auflisten, um Rollen aufzulisten, 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 Dienstkontorollen auflisten zu konfigurieren:

Parameter Beschreibung
Service Accounts Erforderlich

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

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

Eine durch Kommas getrennte Liste von 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 im Zusammenhang mit der Ressource zurück.

Standardmäßig nicht ausgewählt.
Max Roles To Return Erforderlich

Die Anzahl der Rollen im Zusammenhang mit dem Dienstkonto, die zurückgegeben werden sollen.

Der Standardwert ist 100.
Max Permissions To Return Erforderlich

Die Anzahl der Berechtigungen im Zusammenhang mit dem Dienstkonto, die zurückgegeben werden sollen.

Aktionsausgaben

Die Aktion Dienstkontorollen auflisten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit 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 Dienstkontorollen auflisten kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

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 war erfolgreich.
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 liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit 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 Beschreibung der Nachricht
Successfully connected to the Google Cloud Asset Inventory server with the provided connection parameters! Die Aktion war erfolgreich.
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 Skriptergebnisses Wert
is_success True oder False

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