Benutzerdefinierte Module für Security Health Analytics verwenden

Dienststufen für Premium und Enterprise (eingestellt)

Die Dienststufe Security Command Center Enterprise wird am 21. Mai 2027 eingestellt. Wenn Ihre Organisation die Enterprise-Dienststufe verwendet, wird sie am oder nach dem 21. Mai 2027 automatisch auf die Premium-Dienststufe umgestellt. Wenden Sie sich bei Fragen an Ihren Kundenbetreuer oder einen Google Cloud -Vertriebsspezialisten.

Auf dieser Seite wird beschrieben, wie Sie benutzerdefinierte Module für Security Health Analytics mit der Google Cloud Console oder der Google Cloud CLI erstellen, ansehen, aktualisieren und löschen.

Weitere einführende Informationen finden Sie unter Benutzerdefinierte Module für Security Health Analytics – Übersicht.

Hinweis

Bevor Sie mit benutzerdefinierten Modulen arbeiten können, müssen die folgenden Voraussetzungen erfüllt sein:

• Security Health Analytics muss aktiviert sein. Informationen zum Aktivieren von Security Health Analytics finden Sie unter Integrierte Dienste aktivieren oder deaktivieren.
• Ihrem Nutzerkonto müssen eine oder mehrere IAM-Rollen (Identity and Access Management) zugewiesen sein, die die erforderlichen Berechtigungen enthalten. Weitere Informationen finden Sie unter Erforderliche IAM-Berechtigungen.
• Wenn Sie eigene benutzerdefinierte Module schreiben und mit gcloud-Befehlen in Security Command Center hochladen möchten, benötigen Sie die Google Cloud CLI. Informationen zur Installation der gcloud CLI finden Sie unter gcloud CLI installieren.
• Wenn die Security Command Center API noch nicht aktiviert ist, müssen Sie sie aktivieren, bevor Sie benutzerdefinierte Module für Security Health Analytics verwenden können. Sie können die Security Command Center API auf der Seite „API-Bibliothek“ in der Google Cloud Console aktivieren.
• Informationen zu den Nutzungslimits für Security Health Analytics finden Sie unter Kontingente für benutzerdefinierte Module.

Erforderliche IAM-Berechtigungen

Für die Arbeit mit benutzerdefinierten Modulen benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management):

Berechtigung	Rolle
securitycentermanagement.securityhealthanalyticscustommodules.create securitycentermanagement.securityhealthanalyticscustommodules.update securitycentermanagement.securityhealthanalyticscustommodules.delete	roles/securitycenter.settingsEditor roles/securitycenter.admin
securitycentermanagement.securityhealthanalyticscustommodules.get securitycentermanagement.securityhealthanalyticscustommodules.list	roles/securitycenter.settingsViewer roles/securitycenter.adminViewer roles/securitycenter.admin
securitycentermanagement.securityhealthanalyticscustommodules.test	roles/securitycenter.securityHealthAnalyticsCustomModulesTester roles/securitycenter.adminViewer roles/securitycenter.adminEditor roles/securitycenter.admin

Weitere Informationen zu IAM-Berechtigungen und -Rollen sowie zum Zuweisen dieser Berechtigungen finden Sie unter IAM-Rolle über die Google Cloud Console zuweisen.

Benutzerdefiniertes Modul erstellen

In diesem Abschnitt wird beschrieben, wie Sie benutzerdefinierte Module mit derGoogle Cloud Console, der gcloud CLI oder Terraform erstellen.

Wenn Sie Ihr benutzerdefiniertes Modul als Schritt im Erstellungsprozess testen möchten, müssen Sie Testressourcendefinitionen in einer YAML-Datei vorbereiten. Eine Anleitung finden Sie unter Testressourcen in einer YAML-Datei erstellen.

Wählen Sie auf den folgenden Tabs die Methode aus, die Sie zum Erstellen eines benutzerdefinierten Moduls verwenden möchten:

Google Cloud Console

So erstellen Sie ein benutzerdefiniertes Modul in der Google Cloud Console:

1. Rufen Sie in derGoogle Cloud Console die Seite Einstellungen des Security Command Center auf.

   Einstellungen aufrufen

2. Wählen Sie bei Aufforderung die Organisation, den Ordner oder das Projekt aus, in dem Sie das benutzerdefinierte Modul erstellen müssen.

3. Klicken Sie auf der Karte Security Health Analytics auf Einstellungen verwalten.

4. Klicke auf den Tab Module.

5. Klicken Sie auf Modul erstellen. Die Seite Modul für Security Health Analytics erstellen wird geöffnet.

6. Legen Sie im Bereich Modul konfigurieren den Anzeigenamen, die zu scannenden Ressourcen und die Erkennungslogik fest:

   1. Geben Sie im Feld Modulname einen Namen für das Modul an. Der Name muss zwischen 1 und 128 Zeichen lang sein und mit einem Kleinbuchstaben beginnen. Er darf nur alphanumerische Zeichen oder Unterstriche enthalten. Dieser Name wird zur Ergebniskategorie der Ergebnisse, die dieser Detektor erzeugt. Sie können den Namen nach dem Erstellen des Moduls nicht mehr ändern.

   2. Geben Sie unter Ressourcentyp hinzufügen ein bis fünf Ressourcentypen an, die gescannt werden sollen. Sie können einen Ressourcentyp nicht mehrmals angeben.

      Eine Liste der unterstützten Ressourcentypen finden Sie unter Unterstützte Ressourcentypen.

   3. Schreiben Sie im Ausdruckseditor CEL-Ausdrücke, um boolesche Prüfungen für eine oder mehrere Attribute der Ressource auszuführen, die Sie im letzten Schritt angegeben haben. Damit ein Ergebnis ausgelöst wird, muss der Ausdruck zu TRUE aufgelöst werden. Der folgende Ausdruck löst beispielsweise ein Ergebnis aus, wenn für eine CryptoKey-Ressource ein Rotationszeitraum definiert ist und dieser länger als 2.592.000 Sekunden (30 Tage) ist:

      has(resource.rotationPeriod) && (resource.rotationPeriod > duration('2592000s'))
      

      Hier finden Sie weitere Informationen:

      • CEL-Ausdrücke schreiben
      • Ressourcen- und Richtlinienattribute in benutzerdefinierten Modulen referenzieren
      • Liste der Standard-CEL-Definitionen

   4. Klicken Sie auf Weiter. Der Bereich Ergebnisdetails definieren wird geöffnet.

7. Beschreiben Sie im Bereich Ergebnisdetails definieren das Problem, das das benutzerdefinierte Modul erkennt, einschließlich des Schweregrads, des Problems, der Behebung des Problems und aller Daten, die Sie als benutzerdefinierte Quellattribute in die Ergebnisse aufnehmen möchten:

   1. Geben Sie im Feld Schweregrad den Schweregrad des Problems an. Sie können Low, Medium, High oder Critical angeben. Medium ist der Standardwert.

      Informationen zu Schweregraden finden Sie unter Schweregradklassifizierungen für Ergebnisse.

   2. Erläutern Sie im Feld Ergebnisbeschreibung das Problem, das vom benutzerdefinierten Modul erkannt wird. Diese Erklärung wird in jeder Ergebnisinstanz angezeigt, damit Sicherheitsteams das erkannte Problem verstehen und beheben können.

   3. Erläutern Sie im Feld Nächste Schritte, welche Schritte Ihr Sicherheitsteam unternehmen kann, um das erkannte Problem zu beheben oder anderweitig zu beheben.

      Die Schritte werden für jede Ergebnisinstanz angezeigt. Geben Sie konkrete Schritte an, die das Sicherheitsteam unternehmen kann, um das Problem so schnell wie möglich zu beheben.

   4. Optional: Geben Sie im Feld Benutzerdefinierte Ergebnisattribute bis zu 10 Name/Wert-Paare an, um benutzerdefinierte Quellattribute zu definieren, die mit jeder Ergebnisinstanz zurückgegeben werden sollen. Die Informationen werden als Quellattribute im JSON-Ergebnis zurückgegeben und auf dem Tab Quellattribute in den Ergebnisdetails in derGoogle Cloud Console angezeigt. Geben Sie die Text- oder Attributwerte als Schlüssel/Wert-Paare an:

      • Geben Sie im Feld Attributname einen Namen für das benutzerdefinierte Quellattribut an. Der Name muss den folgenden Regeln entsprechen:
        • Der Name muss mit einem Kleinbuchstaben beginnen.
        • Der Name darf nur alphanumerische Zeichen oder Unterstriche enthalten.
        • Der Name muss zwischen 1 und 128 Zeichen lang sein.
        • Jeder Name muss unter den anderen Quell-Properties eindeutig sein.
      • Geben Sie im Feld Attributwert einen der folgenden Werte mit maximal 1.024 Zeichen an:
        • Eine Textzeichenfolge in Anführungszeichen. Die Anführungszeichen sind in der Zeichenbeschränkung von 1.024 Zeichen enthalten. Beispiel: "This string provides additional useful information.".
        • Jedes Attribut der Ressource, die gescannt wird. Wenn Sie beispielsweise die Ressource CryptoKey prüfen, können Sie resource.rotationPeriod angeben. Der Wert des Attributs rotationPeriod wird zurückgegeben.

   5. Klicken Sie auf Weiter. Der Bereich Modul aktivieren wird geöffnet.

8. Optional: Geben Sie im Drop-down-Menü des Bereichs Modul aktivieren an, ob das benutzerdefinierte Modul bei der Erstellung aktiviert oder deaktiviert werden soll. Benutzerdefinierte Module sind standardmäßig aktiviert, wenn sie erstellt werden. Wenn Sie Deaktivieren angeben, können Sie das Modul später auf der Seite mit den Security Health Analytics-Einstellungen auf dem Tab Module aktivieren.

9. Klicken Sie auf Weiter. Der Bereich Modul testen wird geöffnet.

10. Optional: Bevor Sie Ihr benutzerdefiniertes Modul erstellen, sollten Sie es testen.

    So testen Sie ein benutzerdefiniertes Modul:

    1. Erstellen Sie eine YAML-Datei, die Testressourcendefinitionen für die Ressourcen enthält, die Ihr benutzerdefiniertes Modul prüft.

       Informationen zum Erstellen einer Testdatendatei finden Sie unter Testressourcen in einer YAML-Datei erstellen.

    2. Klicken Sie unter YAML-Datei hochladen auf Durchsuchen, um die YAML-Datei mit den Definitionen der Testressourcen hochzuladen. Der Test wird automatisch gestartet, wenn die Datei hochgeladen wird.

    3. Prüfen Sie die Ergebnisse unter Vorschau der Testergebnisse.

       • Wenn Ihre YAML-Datei Syntax- oder andere Fehler enthält, wird unten auf der Browserseite eine schwebende Fehlermeldung angezeigt.

       • Wenn der Test erfolgreich ist, werden die folgenden Informationen zurückgegeben:

         • Der Anzeigename des benutzerdefinierten Moduls.
         • Der beliebige Name, den Sie in der Testdatendatei für das Attribut resource angegeben haben.
         • Die Organisation, der Ordner oder das Projekt, in dem das benutzerdefinierte Modul erstellt wurde oder wird.

    Testergebnisse werden nicht gespeichert oder in Security Command Center geschrieben.

    Weitere Informationen finden Sie unter Benutzerdefinierte Module testen.

11. Klicken Sie auf Erstellen. Sie werden zur Seite Module zurückgeleitet. Dort sollte das von Ihnen erstellte Modul mit dem Status Aktiviert angezeigt werden.

Neue benutzerdefinierte Module sind nicht sofort für Security Health Analytics-Scans verfügbar. Weitere Informationen finden Sie unter Erkennungslatenz.

gcloud-CLI

Wenn Sie ein benutzerdefiniertes Modul mit gcloud-Befehlen erstellen möchten, müssen Sie zuerst die Definition des benutzerdefinierten Moduls in einer YAML-Datei codieren, die CEL-Ausdrücke für die Erkennungslogik und die Ausgabeeigenschaften enthält.

Nachdem die Definition abgeschlossen ist, laden Sie sie mit gcloud CLI-Befehlen in Security Command Center hoch.

1. Erstellen Sie eine benutzerdefinierte Moduldefinition in einer YAML-Datei gemäß der Anleitung unter Benutzerdefiniertes Modul für Security Health Analytics erstellen.
2. Speichern Sie die YAML-Datei an einem Speicherort, auf den Ihre gcloud CLI-Instanz zugreifen kann.

3. Laden Sie die benutzerdefinierte Definition in das Security Command Center hoch:

   gcloud scc custom-modules sha create \
       PARENT_FLAG=PARENT_ID \
       --display-name="MODULE_DISPLAY_NAME" \
       --enablement-state="ENABLEMENT_STATE" \
       --custom-config-from-file=MODULE_FILE_NAME.yaml
   

   Ersetzen Sie Folgendes:

   • PARENT_FLAG: die Ebene, auf der Sie das benutzerdefinierte Modul erstellen, entweder --organization, --folder oder --project.
   • PARENT_ID: die ID der Organisation, des Ordners oder des Projekts, in dem Sie das benutzerdefinierte Modul erstellen.
   • ENABLEMENT_STATE: entweder enabled oder disabled.
   • MODULE_DISPLAY_NAME: Der Name der Ergebniskategorie, die angezeigt werden soll, wenn das benutzerdefinierte Modul ein Ergebnis zurückgibt. Der Name muss zwischen 1 und 128 Zeichen lang sein und mit einem Kleinbuchstaben beginnen. Er darf nur alphanumerische Zeichen oder Unterstriche enthalten.
   • MODULE_FILE_NAME: der Pfad und der Dateiname der YAML-Datei, die die Definition des benutzerdefinierten Moduls enthält.

Terraform

So erstellen Sie ein benutzerdefiniertes Modul für eine Organisation:

resource "google_scc_management_organization_security_health_analytics_custom_module" "example" {
  organization = "123456789"
  display_name = "basic_custom_module"
  location = "global"
  enablement_state = "ENABLED"
  custom_config {
    predicate {
      expression = "resource.rotationPeriod > duration(\"2592000s\")"
    }
    resource_selector {
      resource_types = [
        "cloudkms.googleapis.com/CryptoKey",
      ]
    }
    description = "The rotation period of the identified cryptokey resource exceeds 30 days."
    recommendation = "Set the rotation period to at most 30 days."
    severity = "MEDIUM"
  }
}

Erstellen Sie ein benutzerdefiniertes Modul für einen Ordner:

resource "google_folder" "folder" {
  parent       = "organizations/123456789"
  display_name = "folder-name"
  deletion_protection = false
}

resource "google_scc_management_folder_security_health_analytics_custom_module" "example" {
  folder = google_folder.folder.folder_id
  location = "global"
  display_name = "basic_custom_module"
  enablement_state = "ENABLED"
  custom_config {
    predicate {
      expression = "resource.rotationPeriod > duration(\"2592000s\")"
    }
    resource_selector {
      resource_types = [
        "cloudkms.googleapis.com/CryptoKey",
      ]
    }
    description = "The rotation period of the identified cryptokey resource exceeds 30 days."
    recommendation = "Set the rotation period to at most 30 days."
    severity = "MEDIUM"
  }
}

So erstellen Sie ein benutzerdefiniertes Modul für ein Projekt:

resource "google_scc_management_project_security_health_analytics_custom_module" "example" {
  location = "global"
  display_name = "basic_custom_module"
  enablement_state = "ENABLED"
  custom_config {
    predicate {
      expression = "resource.rotationPeriod > duration(\"2592000s\")"
    }
    resource_selector {
      resource_types = [
        "cloudkms.googleapis.com/CryptoKey",
      ]
    }
    description = "The rotation period of the identified cryptokey resource exceeds 30 days."
    recommendation = "Set the rotation period to at most 30 days."
    severity = "MEDIUM"
  }
}

Erkennungslatenz

Nachdem Sie die Definition eines benutzerdefinierten Moduls erstellt oder aktualisiert haben, kann es bis zu mehrere Stunden dauern, bis das neue oder aktualisierte benutzerdefinierte Modul für Scans verfügbar ist.

Das Erstellen oder Ändern eines benutzerdefinierten Moduls löst keinen Scan aus. Nachdem ein benutzerdefiniertes Modul verfügbar ist, verwendet Security Health Analytics es erst, wenn entweder der erste Batch-Scan oder eine Änderung an der Konfiguration der Zielressource einen Echtzeit-Scan auslöst.

Weitere Informationen zu den Scantypen von Security Health Analytics finden Sie unter Scantypen von Security Health Analytics.

Benutzerdefiniertes Modul aktualisieren

Sie können die meisten Attribute von benutzerdefinierten Security Health Analytics-Modulen aktualisieren.

Die folgenden Attribute eines benutzerdefinierten Moduls können nicht geändert werden:

• Der Anzeigename.
• Die ID des benutzerdefinierten Moduls.
• Der vollständige Ressourcenname des benutzerdefinierten Moduls.

Wenn Sie ein benutzerdefiniertes Modul aktualisieren, werden alle Ergebnisse, die das benutzerdefinierte Modul zuvor generiert hat, nicht gleichzeitig aktualisiert. Wenn die Änderungen am Modul zu Änderungen an den generierten Ergebnissen führen, werden die Änderungen erst nach dem nächsten Batch- oder Echtzeitscan von Security Health Analytics berücksichtigt.

Sie können ein benutzerdefiniertes Modul entweder über die Google Cloud Console oder die gcloud CLI ändern. Klicken Sie auf einen der folgenden Tabs, um die Anleitung aufzurufen.

Google Cloud Console

So aktualisieren Sie ein vorhandenes benutzerdefiniertes Modul in der Google Cloud Console:

1. Rufen Sie in derGoogle Cloud Console die Seite Einstellungen des Security Command Center auf.

   Einstellungen aufrufen

2. Wählen Sie in der Projektauswahl die Organisation, den Ordner oder das Projekt aus, in dem das benutzerdefinierte Modul ursprünglich erstellt wurde. Sie können ein benutzerdefiniertes Modul nirgendwo anders bearbeiten.

3. Klicken Sie auf der Karte Security Health Analytics auf Einstellungen verwalten.

4. Wählen Sie den Tab Module aus. Alle Security Health Analytics-Erkennungsmodule werden angezeigt.

5. Verwenden Sie das Filterfeld oben in der Liste der Module oder scrollen Sie, um das benutzerdefinierte Modul zu finden, das Sie ändern möchten.

6. Klicken Sie rechts in der Zeile Ihres benutzerdefinierten Moduls auf das Symbol Aktionsmenü .

7. Klicken Sie im Aktionsmenü auf das Symbol Bearbeiten (). Die Seite Modul ansehen wird geöffnet und der Tab Modul konfigurieren wird angezeigt.

8. Bearbeiten Sie die benutzerdefinierten Modulfelder der einzelnen Tabs auf der Seite Modul ansehen nach Bedarf.

9. Optional: Bevor Sie die Änderungen speichern, sollten Sie sie testen.

   So testen Sie ein benutzerdefiniertes Modul:

   1. Erstellen Sie eine YAML-Datei, die Testressourcendefinitionen für die Ressourcen enthält, die Ihr benutzerdefiniertes Modul prüft.

      Informationen zum Erstellen einer Testdatendatei finden Sie unter Testressourcen in einer YAML-Datei erstellen.

   2. Klicken Sie unter YAML-Datei hochladen auf Durchsuchen, um die YAML-Datei mit den Definitionen der Testressourcen hochzuladen. Der Test wird automatisch gestartet, wenn die Datei hochgeladen wird.

   3. Prüfen Sie die Ergebnisse unter Vorschau der Testergebnisse.

      • Wenn Ihre YAML-Datei Syntax- oder andere Fehler enthält, wird unten auf der Browserseite eine schwebende Fehlermeldung angezeigt.

      • Wenn der Test erfolgreich ist, werden die folgenden Informationen zurückgegeben:

        • Der Anzeigename des benutzerdefinierten Moduls.
        • Der beliebige Name, den Sie in der Testdatendatei für das Attribut resource angegeben haben.
        • Die Organisation, der Ordner oder das Projekt, in dem das benutzerdefinierte Modul erstellt wurde oder wird.

   Testergebnisse werden nicht gespeichert oder in Security Command Center geschrieben.

   Weitere Informationen finden Sie unter Benutzerdefinierte Module testen.

10. Klicken Sie unten auf der Seite auf Speichern. Ihre Änderungen werden auf das benutzerdefinierte Modul angewendet.

gcloud-CLI

Wenn Sie ein benutzerdefiniertes Modul mithilfe der gcloud CLI aktualisieren möchten, bearbeiten Sie zuerst die YAML-Definition des benutzerdefinierten Moduls und verwenden dann gcloud-Befehle, um das benutzerdefinierte Modul in Security Health Analytics zu aktualisieren.

1. Bearbeiten Sie die Definition des benutzerdefinierten Moduls. Informationen zum Codieren einer benutzerdefinierten Moduldefinition finden Sie unter Benutzerdefiniertes Modul für Security Health Analytics codieren.

2. Speichern Sie die bearbeitete YAML-Datei an einem Speicherort, auf den die gcloud CLI zugreifen kann.

3. Aktualisieren Sie das benutzerdefinierte Modul in Security Health Analytics mit dem folgenden Befehl:

   gcloud scc custom-modules sha update MODULE_ID \
      PARENT_FLAG=PARENT_ID \
      --enablement-state="ENABLED" \
      --custom-config-from-file=MODULE_FILE_NAME.yaml
   

   Ersetzen Sie Folgendes:

   • MODULE_ID: die ID oder der vollständige Ressourcenname des benutzerdefinierten Moduls.
   • PARENT_FLAG: die Ebene, auf der das benutzerdefinierte Modul erstellt wurde, entweder --organization, --folder oder --project.
   • PARENT_ID: Die ID der Organisation, des Ordners oder des Projekts, in dem das benutzerdefinierte Modul erstellt wurde.
   • MODULE_FILE_NAME: der Pfad und der Dateiname der YAML-Datei, die die Definition des benutzerdefinierten Moduls enthält.

Benutzerdefiniertes Modul ansehen

Wählen Sie einen Tab aus, um zu erfahren, wie Sie eine benutzerdefinierte Moduldefinition aufrufen.

Google Cloud Console

So rufen Sie benutzerdefinierte Module in der Google Cloud Console auf:

1. Rufen Sie in den Security Command Center-Einstellungen die Seite Security Health Analytics auf.

   Einstellungen aufrufen

2. Klicke auf den Tab Module. Der Bereich Module wird geöffnet.

3. Verwenden Sie bei Bedarf das Filterfeld oben in der Liste der Module, um das benutzerdefinierte Modul zu finden, das Sie ändern möchten.

4. Klicken Sie rechts in der Zeile des benutzerdefinierten Moduls auf das Symbol für das Aktionsmenü , um die Details der Definition des benutzerdefinierten Moduls aufzurufen.

5. Klicken Sie im Aktionsmenü auf das Symbol Bearbeiten . Die Seite Modul ansehen wird geöffnet und der Tab Modul konfigurieren wird angezeigt.

6. Klicken Sie auf der Seite Modul ansehen durch die Tabs, um alle Felder der benutzerdefinierten Moduldefinition aufzurufen.

gcloud-CLI

Geben Sie den folgenden Befehl ein, um die Details eines benutzerdefinierten Moduls aufzurufen:

gcloud scc custom-modules sha get MODULE_ID \
      PARENT_FLAG=PARENT_ID

Ersetzen Sie Folgendes:

• MODULE_ID: die ID oder der vollständige Ressourcenname des benutzerdefinierten Moduls.
• PARENT_FLAG: die Ebene, auf der das benutzerdefinierte Modul erstellt wurde, entweder --organization, --folder oder --project.
• PARENT_ID: Die ID der Organisation, des Ordners oder des Projekts, in dem das benutzerdefinierte Modul erstellt wurde.

Benutzerdefinierte Module auflisten

Wählen Sie einen Tab aus, um zu erfahren, wie Sie eine Liste der benutzerdefinierten Module aufrufen.

Google Cloud Console

1. Rufen Sie in den Security Command Center-Einstellungen die Seite Security Health Analytics auf.

   Einstellungen aufrufen

2. Klicke auf den Tab Module. Der Bereich Module wird geöffnet.

3. Klicken Sie oben in der Liste der Module in das Filterfeld, um die Liste der Filtertypen aufzurufen.

4. Wählen Sie Typ aus und geben Sie Custom ein. Die Liste der Module wird aktualisiert und zeigt nur benutzerdefinierte Module an.

gcloud-CLI

Geben Sie den folgenden Befehl ein, um eine Liste der benutzerdefinierten Module aufzurufen:

gcloud scc custom-modules sha list \
    PARENT_FLAG=PARENT_ID

Ersetzen Sie Folgendes:

• PARENT_FLAG: die Ebene, auf der das benutzerdefinierte Modul erstellt wurde, entweder --organization, --folder oder --project.
• PARENT_ID: Die ID der Organisation, des Ordners oder des Projekts, in dem das benutzerdefinierte Modul erstellt wurde.

Benutzerdefiniertes Modul löschen

Sie können ein benutzerdefiniertes Modul aus der Organisation, dem Ordner oder dem Projekt löschen, in dem es erstellt wurde, oder aus einer übergeordneten Organisation oder einem übergeordneten Ordner. Sie können ein benutzerdefiniertes Modul nicht aus einem Ordner oder Projekt löschen, der bzw. das es übernimmt.

Hinweis: Gelöschte Module können nicht wiederhergestellt werden.

Wählen Sie einen der folgenden Tabs aus, um zu erfahren, wie Sie ein benutzerdefiniertes Modul löschen.

Google Cloud Console

1. Rufen Sie in derGoogle Cloud Console die Seite Einstellungen des Security Command Center auf.

   Einstellungen aufrufen

2. Wählen Sie Ihre Organisation, Ihren Ordner oder Ihr Projekt aus, wenn Sie dazu aufgefordert werden.

3. Klicken Sie auf der Karte Security Health Analytics auf Einstellungen verwalten.

4. Wählen Sie den Tab Module aus. Alle Security Health Analytics-Erkennungsmodule werden angezeigt.

5. Verwenden Sie das Filterfeld oben in der Liste der Module oder scrollen Sie, um das benutzerdefinierte Modul zu finden, das Sie ändern möchten.

6. Klicken Sie rechts in der Zeile Ihres benutzerdefinierten Moduls auf das Symbol Aktionsmenü .

7. Klicken Sie im Aktionsmenü auf Löschen. Das Dialogfeld Benutzerdefiniertes Modul löschen wird geöffnet.

8. Klicken Sie im Dialogfeld auf Löschen.

gcloud-CLI

Geben Sie den folgenden Befehl ein, um ein benutzerdefiniertes Modul zu löschen:

gcloud scc custom-modules sha delete MODULE_ID \
    PARENT_FLAG=PARENT_ID

Ersetzen Sie Folgendes:

• MODULE_ID: die ID oder der vollständige Ressourcenname des benutzerdefinierten Moduls.
• PARENT_FLAG: die Ebene, auf der das benutzerdefinierte Modul erstellt wurde, entweder --organization, --folder oder --project.
• PARENT_ID: Die ID der Organisation, des Ordners oder des Projekts, in dem das benutzerdefinierte Modul erstellt wurde.

Ergebnisse für gelöschte benutzerdefinierte Module werden von Security Health Analytics beim nächsten Batch-Scan als inaktiv markiert.

Ergebnisse prüfen

Ergebnisse, die von benutzerdefinierten Modulen generiert werden, können in derGoogle Cloud Console oder der Security Command Center API angezeigt werden.

Console

1. Rufen Sie in der Google Cloud Console die Seite Ergebnisse von Security Command Center auf.

   Zu Ergebnissen

2. Wählen Sie Ihr Google Cloud Projekt oder Ihre Organisation aus.
3. Wählen Sie im Abschnitt Schnellfilter im Unterabschnitt Anzeigename der Quelle die Option Security Health Analytics Custom aus. Die Ergebnisse der Ergebnisabfrage werden aktualisiert, sodass nur die Ergebnisse aus dieser Quelle angezeigt werden.
4. Klicken Sie in der Spalte Kategorie auf den Namen des Ergebnisses, um Details zu einem bestimmten Ergebnis aufzurufen. Der Detailbereich für das Ergebnis wird geöffnet und der Tab Zusammenfassung wird angezeigt.
5. Sehen Sie sich auf dem Tab Zusammenfassung die Details des Ergebnisses an, einschließlich Informationen dazu, was erkannt wurde, der betroffenen Ressource und – falls verfügbar – der Schritte, die Sie zur Behebung des Ergebnisses ausführen können.
6. Optional: Klicken Sie auf den Tab JSON, um die vollständige JSON-Definition des Ergebnisses aufzurufen.

gcloud-CLI

So rufen Sie Ergebnisse auf:

1. Öffnen Sie ein Terminalfenster.

2. Führen Sie den folgenden Befehl aus, um die Quell-ID für Security Health Analytics abzurufen:

   gcloud scc sources describe organizations/ORGANIZATION_ID \
   --source-display-name='Security Health Analytics Custom'
   

   Die Ausgabe sollte in etwa so aussehen: Im Beispiel ist SOURCE_ID eine vom Server zugewiesene ID für Sicherheitsquellen.

   description: ...
   displayName: Security Health Analytics Custom
   name: organizations/ORGANIZATION_ID/sources/SOURCE_ID
   

3. Führen Sie den folgenden Befehl aus, um alle von Ihren benutzerdefinierten Modulen generierten Ergebnisse aufzulisten:

   gcloud scc findings list ORGANIZATION_ID --source=SOURCE_ID
   

4. Führen Sie den folgenden Befehl aus, um die Ergebnisse für ein bestimmtes benutzerdefiniertes Modul aufzulisten:

   gcloud scc findings list ORGANIZATION_ID --source=SOURCE_ID --filter="category=\"MODULE_NAME\""
   

Nächste Schritte

Sie können die von benutzerdefinierten Modulen generierten Ergebnisse wie alle Ergebnisse im Security Command Center verwalten. Eine Anleitung finden Sie hier:

• In der Google Cloud Console mit Ergebnissen arbeiten
• Ergebnisse mit Sicherheitsmarkierungen annotieren
• Ergebnisbenachrichtigungen einrichten
• Security Command Center-Daten exportieren