Sie können die Security Command Center API und das gcloud CLI-Befehlszeilentool verwenden, um Sicherheitsergebnisse programmatisch zu verwalten. Hier erfahren Sie, wie Sie aktive Sicherheitsergebnisse für eine bestimmte Quelle erstellen und ihren Status aktualisieren (z. B. von ACTIVE zu INACTIVE), wenn Probleme erkannt und behoben werden.
Hinweis
Bevor Sie Ergebnisse erstellen und aktualisieren, müssen Sie die folgenden Schritte ausführen:
Zum Durcharbeiten dieser Anleitung benötigen Sie die IAM-Rolle (Identity and Access Management) Security Center Findings Editor (securitycenter.findingsEditor) auf Organisationsebene. Weitere Informationen zu Rollen im Security Command Center finden Sie unter Zugriffssteuerung.
Wenn Sie Ergebnisse mit Sicherheitsmarkierungen erstellen möchten, benötigen Sie außerdem eine IAM-Rolle, die Berechtigungen für die Art der zu verwendenden Markierung enthält:
- Autor für Asset-Sicherheitsmarkierungen (
securitycenter.assetSecurityMarksWriter) - Autor von Sicherheitsmarkierungen suchen (
securitycenter.findingSecurityMarksWriter)
Weitere Informationen zu Markierungen finden Sie unter Ergebnisse mit Sicherheitsmarkierungen versehen.
Ergebnis erstellen
Erstellen Sie ein aktives Ergebnis für eine Quelle.
gcloud
gcloud scc findings create FINDING_NAME \ --organization=PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --state=STATE \ --category=CATEGORY \ --event-time=EVENT_TIME \ --resource-name=RESOURCE_NAME
Ersetzen Sie Folgendes:
FINDING_NAME: der Name des Ergebnisses.PARENT_ID: die numerische ID der übergeordneten Organisation.LOCATION: Der Security Command Center-Standort, an dem ein Ergebnis erstellt werden soll. Wenn der Datenstandort aktiviert ist, verwenden Sieeu,saoderus. Verwenden Sie andernfalls den Wertglobal.SOURCE_ID: die numerische ID der Quelle für das Ergebnis.STATE: der Status des Ergebnisses. Verwenden SieACTIVE, wenn das Ergebnis Aufmerksamkeit erfordert, oderINACTIVE, wenn das Ergebnis behoben wurde.CATEGORY: die Taxonomiegruppe, zu der das Ergebnis gehört, z. B.AUDIT_LOGGING_DISABLED.EVENT_TIME: der Zeitpunkt, zu dem das Ereignis aufgetreten ist, formatiert als RFC 822-Zeitstempel oder ein anderes Zeitstempelformat, das von der gcloud CLI unterstützt wird.RESOURCE_NAME: der vollständige Ressourcenname der Ressource, auf die sich das Ergebnis bezieht.
Go
Java
Node.js
Python
Informationen dazu, wie lange Ergebnisdaten im Security Command Center gespeichert werden, finden Sie unter Aufbewahrung von Ergebnissen.
Ergebniszustand aktualisieren
Security Command Center stellt auch eine API zur Verfügung, mit der sich der Zustand eines Ergebnisses lediglich aktualisieren lässt. Im folgenden Beispiel wird gezeigt, wie Sie den Status eines Ergebnisses in „Inaktiv“ ändern.
gcloud
gcloud scc findings update \ PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_NAME \ --state=STATE
Ersetzen Sie Folgendes:
PARENT: die Ebene der Ressourcenhierarchie, auf der sich das Ergebnis befindet. Verwenden Sieorganizations,foldersoderprojects.PARENT_ID: die numerische ID der übergeordneten Organisation, des übergeordneten Ordners oder des übergeordneten Projekts oder die alphanumerische ID des übergeordneten Projekts.SOURCE_ID: die numerische ID der Quelle für das Ergebnis.LOCATION: Der Security Command Center-Standort, an dem ein Ergebnis aktualisiert werden soll. Wenn der Datenstandort aktiviert ist, verwenden Sieeu,saoderus. Verwenden Sie andernfalls den Wertglobal.FINDING_NAME: das zu aktualisierende Ergebnis.STATE: der Status des Ergebnisses. Verwenden SieACTIVE, wenn das Ergebnis Aufmerksamkeit erfordert, oderINACTIVE, wenn das Ergebnis behoben wurde.
Go
Java
Node.js
Nächste Schritte
Mit Clientbibliotheken auf Security Command Center zugreifen