Ergebnisse in Security Command Center ausblenden

Auf dieser Seite wird erläutert, wie Sie die Anzahl der Ergebnisse, die Sie in Security Command Center erhalten, durch Ausblenden reduzieren.

Überblick

Wenn Sie ein Ergebnis ausblenden, wird es in der Standardansicht der Ergebnisse in der Google Cloud Console ausgeblendet. Sie können Ergebnisse manuell oder programmatisch ausblenden und Filter erstellen, um vorhandene und zukünftige Ergebnisse anhand der von Ihnen angegebenen Kriterien automatisch unterdrückt zu lassen.

Anbieter von Security Command Center-Ergebnissen bieten umfassende Sicherheitsbewertungen für Ihre Google Cloud-Bereitstellung. Möglicherweise finden Sie jedoch, dass bestimmte Ergebnisse für Ihre Organisation oder Projekte nicht geeignet oder relevant sind. Eine große Anzahl von Ergebnissen kann Ihren Sicherheitsanalysten außerdem die effektive Identifizierung und Behebung der größten Risiken erschweren. Durch das Ausblenden von Ergebnissen sparen Sie Zeit, wenn Sie Sicherheitsergebnisse für Assets, die isoliert sind oder in akzeptable Geschäftsparameter fallen, nicht überprüfen oder beantworten.

Ergebnisse im Vergleich zu Zulassungslisten ausblenden

Das Ausblenden von Ergebnissen funktioniert anders als vorhandene Lösungen zur Volume-Verwaltung. Mit Security Health Analytics können Sie spezielle Sicherheitsmarkierungen verwenden, um Assets zu Zulassungslisten hinzuzufügen. Dadurch wird verhindert, dass Detektoren Sicherheitsergebnisse für bestimmte Assets erstellen. In Security Command Center können Sie auch Detektoren deaktivieren.

Das Ausblenden von Ergebnissen hat jedoch mehrere Vorteile gegenüber Zulassungslisten und dem Deaktivieren von Detektoren:

• Sie können Ergebnisse ausblenden, ohne die zugrunde liegenden Assets zu suchen.
• Ergebnisse, die keiner Ressource zugeordnet sind, können ausgeblendet werden.
• Sie können benutzerdefinierte Filter erstellen, um die Ausblendungsfunktion zu optimieren.
• Auch beim Ausblenden von Ergebnissen werden die zugrunde liegenden Assets weiterhin gescannt. Die Ergebnisse werden weiterhin generiert, bleiben jedoch ausgeblendet, bis Sie sie aufrufen.

Berechtigungen

Zum Ausblenden von Ergebnissen benötigen Sie eine der folgenden IAM-Rollen (Identity and Access Management) auf Organisationsebene, Ordner oder Projekt:

• Ausblendungsregeln ansehen:
  • Sicherheitscenter-Admin-Betrachter (roles/securitycenter.adminViewer)
  • Sicherheitscenter-Einstellungsbetrachter (roles/securitycenter.settingsViewer)
  • Betrachter von Konfigurationen für Ausblendungen im Sicherheitscenter (roles/securitycenter.muteConfigsViewer)
• Ausblendungsregeln anzeigen, erstellen, aktualisieren und löschen:
  • Sicherheitscenter-Administrator (roles/securitycenter.admin)
  • Sicherheitscenter-Administratorbearbeiter (roles/securitycenter.adminEditor)
  • Sicherheitscenter-Einstellungsbearbeiter (roles/securitycenter.settingsEditor)
  • Bearbeiter von Konfigurationen für Ausblendungen im Sicherheitscenter (roles/securitycenter.muteConfigsEditor)
• Ergebnisse manuell ausblenden:
  • Sicherheitscenter-Ergebnisbearbeiter (roles/securitycenter.findingsEditor)

Sie können auch benutzerdefinierte Rollen mit einigen oder allen der folgenden Berechtigungen erstellen und zuweisen:

• Leseberechtigungen für Ausblendungsregeln
  • securitycenter.muteconfigs.get
  • securitycenter.muteconfigs.list
• Schreibberechtigungen für Ausblendungsregeln
  • securitycenter.muteconfigs.create
  • securitycenter.muteconfigs.update
  • securitycenter.muteconfigs.delete
• Ergebnis-Schreibberechtigungen
  • securitycenter.findings.setMute
  • securitycenter.findings.bulkMuteUpdate

Die Möglichkeit, Ergebnisse auszublenden, entspricht den Rollen, die auf Organisations-, Ordner- oder Projektebene gewährt wurden. Sie können Ergebnisse in bestimmten Ordnern oder Projekten ausblenden und die Möglichkeit anderer Personen, Ergebnisse je nach gewährtem Zugriff auszublenden. Wenn Sie beispielsweise Zugriff auf ein einzelnes Projekt haben, können Sie nur Ergebnisse in diesem Projekt ausblenden. Wenn Sie Zugriff auf einen Ordner haben, können Sie die Ergebnisse in jedem Unterordner oder Projekt in diesem Ordner ausblenden.

Weitere Informationen zu Security Command Center-Rollen finden Sie unter Zugriffssteuerung.

Ergebnisse ausblenden

Sie können einzelne Ergebnisse manuell ausblenden, mehrere Ergebnisse gleichzeitig mit Bulk-Ausblendungs-Filtern ausblenden oder zukünftige Ergebnisse basierend auf von Ihnen definierten Filtern automatisch unterdrücken mit von Ihnen erstellten Ausblendungsregeln.

Achtung: Gehen Sie beim Ausblenden von Ergebnissen mit hohem und kritischem Schweregrad vorsichtig vor. Sie sollten sicher sein, dass die Bedrohungen, Fehlkonfigurationen oder Sicherheitslücken kein Risiko darstellen oder Risiken beseitigt werden.

Ergebnisse enthalten das Attribut mute, das auf MUTED oder UNMUTED gesetzt sein kann. Wenn Sie Ergebnisse ausblenden und einblenden, ändern Sie dabei den Wert des Attributs. Weitere Informationen finden Sie unter Attribute für das Ausblenden von Ergebnissen.

Das Ausblenden von Ergebnissen ist für viele Anwendungsfälle relevant, einschließlich der folgenden:

• Assets in Nicht-Produktionsumgebungen, in denen einige strengere Anforderungen nicht anwendbar sind.
• Empfehlungen zur Verwendung von vom Kunden verwalteten Verschlüsselungsschlüsseln in Projekten, die keine kritischen Daten enthalten.
• Gewähren eines breiten Zugriffs auf einen Datenspeicher, der absichtlich öffentlich zugänglich ist und öffentliche Informationen bereitstellt.
• Ergebnisse, die auf der Grundlage der Richtlinien Ihres Unternehmens für Ihre Organisation oder Ihr Projekt nicht relevant sind

Ausgeblendete Ergebnisse werden weiterhin zu Prüf- und Compliance-Zwecken protokolliert und können bei Bedarf angezeigt werden. Standardmäßig werden sie jedoch nicht in der Google Cloud Console angezeigt. Außerdem können Sie mit dem Attribut mute des Ergebnisses ausgeblendete Ergebnisse aus Pub/Sub-Benachrichtigungen und Security Command Center API-Aufrufen filtern.

Hinweis: Ergebnisse, die zur Ergebnisklasse SCC errors gehören, melden Probleme, die verhindern, dass Security Command Center wie erwartet funktioniert. Aus diesem Grund können Fehlerergebnisse nicht ausgeblendet werden. Weitere Informationen finden Sie in der Übersicht über Security Command Center-Fehler.

Einzelne Ergebnisse ausblenden

Sie können ein einzelnes Ergebnis mit der Google Cloud Console, der gcloud CLI oder der Security Command Center API stummschalten.

Beispielcode zum Ausblenden eines Ergebnisses finden Sie unter Ergebnis ausblenden.

Wenn Sie ein einzelnes Ergebnis ausblenden möchten, klicken Sie auf den Tab für das gewünschte Verfahren:

Console

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

   Zu Ergebnissen

2. Wählen Sie gegebenenfalls Ihr Google Cloud-Projekt oder Ihre Organisation aus.

3. Wenn der Datenstandort für Security Command Center aktiviert ist, verwenden Sie die Standortauswahl direkt unter der Projektauswahl, um den Security Command Center-Speicherort des Ergebnisses auszuwählen. Beispiel:

   

4. Wenn Sie das Ergebnis, das Sie ausblenden möchten, im Bereich Ergebnisse der Ergebnisabfrage nicht sehen, wählen Sie im Bereich Schnellfilter im Abschnitt Kategorie die Kategorie des Ergebnisses aus.

5. Klicken Sie das Kästchen neben dem Ergebnis an, das Sie stummschalten möchten. Sie können ein oder mehrere Ergebnisse auswählen.

6. Klicken Sie in der Aktionsleiste Ergebnisse der Abfrageergebnisse auf Optionen zum Ausblenden und wählen Sie dann Ausblenden aus.

   Das Attribut mute für die ausgewählten Ergebnisse ist auf MUTED festgelegt und das Ergebnis wird aus dem Bereich Ergebnisse der Ergebnisabfrage entfernt.

Alternativ können Sie ein Ergebnis über den Detailbereich ausblenden:

1. Klicken Sie auf der Seite Ergebnisse im Bereich Abfrageergebnisse finden in der Spalte Kategorie auf den Namen eines einzelnen Ergebnisses. Der Detailbereich des Ergebnisses wird geöffnet.
2. Klicken Sie auf Maßnahmen ergreifen.

3. Wählen Sie im Menü Aktionen die Option Stummschalten aus.

   Wenn Sie stattdessen Ergebnisse wie diese ausblenden auswählen, wird die Seite Ausblendungsregel erstellen geöffnet. Hier können Sie eine Ausblendungsregel für Ergebnisse desselben Typs oder mit demselben Indicator-Attribut erstellen.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Verwenden Sie den Befehl set-mute in der gcloud CLI, um den Ausblendungsstatus eines Ergebnisses auf MUTED zu setzen:

   gcloud scc findings set-mute FINDING_ID \
    --PARENT=PARENT_ID \
    --location=LOCATION --source=SOURCE_ID \
    --mute=MUTED
   

   Ersetzen Sie Folgendes:

   • FINDING_ID: die ID des Ergebnisses, das Sie ausblenden möchten

     Beim Abrufen von Ergebnis-IDs verwenden Sie die Security Command Center API zum Auflisten der Ergebnisse. Die Ergebnis-ID ist der letzte Teil des Attributs canonicalName, z. B. projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

   • PARENT: die übergeordnete Ressource (project, folder oder organization), wobei die Groß-/Kleinschreibung beachtet wird

   • PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Speicherort von Security Command Center an, in dem das Ergebnis gespeichert wird.

     Wenn der Datenstandort nicht aktiviert ist, wird durch Angabe des Flags --location das Ergebnis mit der Security Command Center API v2 stummgeschaltet. Der einzige gültige Wert für das Flag ist global.

   • SOURCE_ID: die Quell-ID.

     Eine Anleitung zum Abrufen einer Quell-ID finden Sie unter Quell-ID abrufen.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
)

// setMute mutes an individual finding.
// If a finding is already muted, muting it again has no effect.
// Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
func setMute(w io.Writer, findingPath string) error {
	// findingPath: The relative resource name of the finding. See:
	// https://cloud.google.com/apis/design/resource_names#relative_resource_name
	// Use any one of the following formats:
	//  - organizations/{organization_id}/sources/{source_id}/finding/{finding_id}
	//  - folders/{folder_id}/sources/{source_id}/finding/{finding_id}
	//  - projects/{project_id}/sources/{source_id}/finding/{finding_id}
	// findingPath := fmt.Sprintf("projects/%s/sources/%s/finding/%s", "your-google-cloud-project-id", "source", "finding-id")
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.SetMuteRequest{
		Name: findingPath,
		Mute: securitycenterpb.Finding_MUTED}

	finding, err := client.SetMute(ctx, req)
	if err != nil {
		return fmt.Errorf("failed to set the specified mute value: %w", err)
	}
	fmt.Fprintf(w, "Mute value for the finding: %s is %s", finding.Name, finding.Mute)
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.Finding;
import com.google.cloud.securitycenter.v1.Finding.Mute;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import com.google.cloud.securitycenter.v1.SetMuteRequest;
import java.io.IOException;

public class SetMuteFinding {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the variables within {}

    // findingPath: The relative resource name of the finding. See:
    // https://cloud.google.com/apis/design/resource_names#relative_resource_name
    // Use any one of the following formats:
    //  - organizations/{organization_id}/sources/{source_id}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/finding/{finding_id}
    String findingPath = "{path-to-the-finding}";
    setMute(findingPath);
  }

  // Mute an individual finding.
  // If a finding is already muted, muting it again has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
  public static Finding setMute(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      SetMuteRequest setMuteRequest =
          SetMuteRequest.newBuilder().setName(findingPath).setMute(Mute.MUTED).build();

      Finding finding = client.setMute(setMuteRequest);
      System.out.println(
          "Mute value for the finding " + finding.getName() + " is: " + finding.getMute());
      return finding;
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def set_mute_finding(finding_path: str) -> None:
    """
      Mute an individual finding.
      If a finding is already muted, muting it again has no effect.
      Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
    Args:
        finding_path: The relative resource name of the finding. See:
        https://cloud.google.com/apis/design/resource_names#relative_resource_name
        Use any one of the following formats:
        - organizations/{organization_id}/sources/{source_id}/finding/{finding_id},
        - folders/{folder_id}/sources/{source_id}/finding/{finding_id},
        - projects/{project_id}/sources/{source_id}/finding/{finding_id}.
    """
    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

    request = securitycenter.SetMuteRequest()
    request.name = finding_path
    request.mute = securitycenter.Finding.Mute.MUTED

    finding = client.set_mute(request)
    print(f"Mute value for the finding: {finding.mute.name}")

REST API

Verwenden Sie in der Security Command Center API die Methode setMute, um ein Ergebnis auszublenden. Der Anfragetext ist ein Enum, das den resultierenden Ausblendungsstatus angibt.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, rufen Sie über den Endpunkt v1 setMute auf:

POST https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/sources/SOURCE_ID/findings/FINDING_ID:setMute

{
  "mute": "MUTED"
}

Wenn Sie die Security Command Center API v2 verwenden, rufen Sie über den Endpunkt v2 setMute auf:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_ID:setMute

{
  "mute": "MUTED"
}

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource (organizations, folders oder projects).
• PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts.
• LOCATION: Gibt für V2 den Speicherort von Security Command Center an, an dem das Ergebnis gespeichert wird. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.

• SOURCE_ID: die numerische ID für die Quelle.

  Eine Anleitung zum Abrufen einer Quell-ID finden Sie unter Quell-ID abrufen.

• FINDING_ID: die ID des Ergebnisses, das Sie stummschalten möchten.

  Beim Abrufen von Ergebnis-IDs verwenden Sie die Security Command Center API zum Auflisten der Ergebnisse. Die Ergebnis-ID ist der letzte Teil des Attributs canonicalName, z. B. projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Nachdem Sie ein Ergebnis ausgeblendet haben, wird das zugehörige mute-Attribut auf MUTED gesetzt.

Das Ausblenden eines Ergebnisses hat keinen Einfluss darauf, ob es aktiv ist oder nicht. Wenn ein aktives Ergebnis ausgeblendet ist, bleibt das Attribut state unverändert: state="ACTIVE". Das Ergebnis ist verborgen, bleibt aber aktiv, bis die zugrunde liegende Sicherheitslücke, Fehlkonfiguration oder Bedrohung beseitigt wurde.

Weitere Informationen zu Ausblendungsregeln finden Sie unter Ausblendungsregeln erstellen.

Ausgeblendete Ergebnisse in der Google Cloud Console ansehen

Sie können ausgeblendete Ergebnisse in der Google Cloud Console ansehen. Bearbeiten Sie dazu die Ergebnisabfrage und wählen Sie Ergebnisse aus, die den Attributwert mute="MUTED" enthalten.

Die folgende Ergebnisabfrage zeigt beispielsweise nur aktive Ergebnisse an, die ausgeblendet sind:

state="ACTIVE"
AND mute="MUTED"

Wenn Sie alle aktiven Ergebnisse, sowohl stummgeschaltet als auch ohne Ton, anzeigen lassen möchten, lassen Sie das Attribut mute vollständig aus der Abfrage weg:

state="ACTIVE"

Standardmäßig zeigt die Ergebnisabfrage in der Google Cloud Console nur Ergebnisse an, die nicht ausgeblendet sind.

Weitere Informationen zum Bearbeiten von Ergebnisabfragen finden Sie unter Ergebnisabfrage im Dashboard erstellen oder bearbeiten.

Einzelne Ergebnisse wieder einblenden

Sie können die Stummschaltung eines einzelnen Ergebnisses mithilfe der Google Cloud Console, der gcloud CLI oder der Security Command Center API aufheben.

Beispielcode zum Aufheben der Stummschaltung eines Ergebnisses finden Sie unter Stummschaltung eines Ergebnisses aufheben.

Wenn Sie die Stummschaltung eines einzelnen Ergebnisses aufheben möchten, klicken Sie auf den Tab für das gewünschte Verfahren:

Console

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

   Zu Ergebnissen

2. Wählen Sie gegebenenfalls Ihr Google Cloud-Projekt oder Ihre Organisation aus.

   Die Seite Ergebnisse wird geöffnet und die Standardabfrage wird im Abschnitt Abfragevorschau angezeigt. Die Standardabfrage filtert ausgeblendete Ergebnisse heraus. Daher müssen Sie die Abfrage bearbeiten, bevor ausgeblendete Ergebnisse im Bereich Ergebnisse der Abfrageergebnisse angezeigt werden.

3. Wenn der Datenstandort für Security Command Center aktiviert ist, verwenden Sie die Standortauswahl direkt unter der Projektauswahl, um den Security Command Center-Speicherort des Ergebnisses auszuwählen. Beispiel:

   

4. Klicken Sie rechts neben dem Abschnitt Abfragevorschau auf Abfrage bearbeiten, um den Abfrageeditor zu öffnen.

5. Ersetzen Sie im Feld Abfrageeditor die vorhandene Stummschaltungsanweisung durch Folgendes:

   mute="MUTED"

6. Klicken Sie auf Anwenden. Die Ergebnisse im Bereich Ergebnisse der Abfrageergebnisse werden aktualisiert, sodass sie nur ausgeblendete Ergebnisse enthalten.

7. Filtern Sie gegebenenfalls andere ausgeblendete Ergebnisse heraus. Wählen Sie beispielsweise im Bereich Schnellfilter unter Kategorie den Namen des Ergebnisses aus, dessen Stummschaltung Sie aufheben möchten, um alle anderen Ergebniskategorien herauszufiltern.

8. Klicken Sie das Kästchen neben dem Ergebnis an, für das Sie die Stummschaltung aufheben möchten. Sie können ein oder mehrere Ergebnisse auswählen.

9. Klicken Sie in der Aktionsleiste Ergebnisse der Ergebnisabfrage auf Optionen zum Ausblenden und wählen Sie dann Nicht mehr ignorieren aus.

   Das Attribut mute für die ausgewählten Ergebnisse ist auf UNMUTED festgelegt und das Ergebnis wird aus dem Bereich Ergebnisse der Ergebnisabfrage entfernt.

Alternativ können Sie die Stummschaltung eines Ergebnisses über den Detailbereich aufheben:

1. Klicken Sie auf der Seite Ergebnisse im Bereich Abfrageergebnisse finden in der Spalte Kategorie auf den Namen eines einzelnen Ergebnisses. Der Detailbereich des Ergebnisses wird geöffnet.
2. Klicken Sie auf Maßnahmen ergreifen.
3. Wählen Sie im Menü Maßnahme ergreifen die Option Nicht mehr ignorieren aus.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Verwenden Sie den Befehl set-mute in der gcloud CLI, um den Ausblendungsstatus eines Ergebnisses auf UNMUTED zu setzen:

   gcloud scc findings set-mute FINDING_ID \
    --PARENT=PARENT_ID \
    --location=LOCATION --source=SOURCE_ID \
    --mute=UNMUTED
   

   Ersetzen Sie Folgendes:

   • FINDING_ID: die ID des Ergebnisses, das Sie ausblenden möchten

     Beim Abrufen von Ergebnis-IDs verwenden Sie die Security Command Center API zum Auflisten der Ergebnisse. Die Ergebnis-ID ist der letzte Teil des Attributs canonicalName, z. B. projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

   • PARENT: die übergeordnete Ressource (project, folder oder organization), wobei die Groß- und Kleinschreibung berücksichtigt wird

   • PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Speicherort von Security Command Center an, in dem das Ergebnis gespeichert wird.

     Wenn der Datenstandort nicht aktiviert ist, wird durch Angabe des Flags --location die Stummschaltung des Ergebnisses mithilfe der Security Command Center API v2 aufgehoben. Der einzige gültige Wert für das Flag ist global.

   • SOURCE_ID: die Quell-ID.

     Eine Anleitung zum Abrufen einer Quellen-ID finden Sie unter Quell-ID abrufen.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
)

// setUnmute unmutes an individual finding.
// Unmuting a finding that isn't muted has no effect.
// Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
func setUnmute(w io.Writer, findingPath string) error {
	// findingPath: The relative resource name of the finding. See:
	// https://cloud.google.com/apis/design/resource_names#relative_resource_name
	// Use any one of the following formats:
	//  - organizations/{organization_id}/sources/{source_id}/finding/{finding_id}
	//  - folders/{folder_id}/sources/{source_id}/finding/{finding_id}
	//  - projects/{project_id}/sources/{source_id}/finding/{finding_id}
	// findingPath := fmt.Sprintf("projects/%s/sources/%s/finding/%s", "your-google-cloud-project-id", "source", "finding-id")
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.SetMuteRequest{
		Name: findingPath,
		Mute: securitycenterpb.Finding_UNMUTED}

	finding, err := client.SetMute(ctx, req)
	if err != nil {
		return fmt.Errorf("failed to set the specified mute value: %w", err)
	}
	fmt.Fprintf(w, "Mute value for the finding: %s is %s", finding.Name, finding.Mute)
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.Finding;
import com.google.cloud.securitycenter.v1.Finding.Mute;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import com.google.cloud.securitycenter.v1.SetMuteRequest;
import java.io.IOException;

public class SetUnmuteFinding {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the variables within {}

    // findingPath: The relative resource name of the finding. See:
    // https://cloud.google.com/apis/design/resource_names#relative_resource_name
    // Use any one of the following formats:
    //  - organizations/{organization_id}/sources/{source_id}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/finding/{finding_id}
    String findingPath = "{path-to-the-finding}";
    setUnmute(findingPath);
  }

  // Unmute an individual finding.
  // Unmuting a finding that isn't muted has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
  public static Finding setUnmute(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      SetMuteRequest setMuteRequest =
          SetMuteRequest.newBuilder().setName(findingPath).setMute(Mute.UNMUTED).build();

      Finding finding = client.setMute(setMuteRequest);
      System.out.println(
          "Mute value for the finding " + finding.getName() + " is: " + finding.getMute());
      return finding;
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def set_unmute_finding(finding_path: str) -> None:
    """
      Unmute an individual finding.
      Unmuting a finding that isn't muted has no effect.
      Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
    Args:
        finding_path: The relative resource name of the finding. See:
        https://cloud.google.com/apis/design/resource_names#relative_resource_name
        Use any one of the following formats:
        - organizations/{organization_id}/sources/{source_id}/finding/{finding_id},
        - folders/{folder_id}/sources/{source_id}/finding/{finding_id},
        - projects/{project_id}/sources/{source_id}/finding/{finding_id}.
    """
    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

    request = securitycenter.SetMuteRequest()
    request.name = finding_path
    request.mute = securitycenter.Finding.Mute.UNMUTED

    finding = client.set_mute(request)
    print(f"Mute value for the finding: {finding.mute.name}")

REST API

Verwenden Sie in der Security Command Center API die Methode setMute, um die Stummschaltung eines Ergebnisses aufzuheben. Der Anfragetext ist ein Enum, das den resultierenden Ausblendungsstatus angibt.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, rufen Sie über den Endpunkt v1 setMute auf:

POST https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/sources/SOURCE_ID/findings/FINDING_ID:setMute

{
  "mute": "UNMUTED"
}

Wenn Sie die Security Command Center API v2 verwenden, rufen Sie über den Endpunkt v2 setMute auf:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_ID:setMute

{
  "mute": "UNMUTED"
}

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource (organizations, folders oder projects)
• PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts
• LOCATION: Gibt für V2 den Speicherort von Security Command Center an, an dem das Ergebnis gespeichert wird. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.

• SOURCE_ID: die numerische ID für die Quelle

  Eine Anleitung zum Abrufen einer Quellen-ID finden Sie unter Quell-ID abrufen.

• FINDING_ID: die ID des Ergebnisses, das Sie stummschalten möchten.

  Beim Abrufen von Ergebnis-IDs verwenden Sie die Security Command Center API zum Auflisten der Ergebnisse. Die Ergebnis-ID ist der letzte Teil des Attributs canonicalName, z. B. projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Die ausgewählten Ergebnisse sind nicht mehr ausgeblendet und das Attribut mute für die Ergebnisse wurde auf UNMUTED gesetzt.

Wieder eingeblendete Ergebnisse überschreiben Ausblendungsregeln

Wenn ein Nutzer die Ergebnisse wieder eingeblendet, bleiben sie weiterhin eingeblendet, auch wenn vorhandene Ausblendungsregeln dennoch mit den Ergebnissen übereinstimmen. Wieder-Einblendungs-Aktionen durch Nutzer überschreiben Ausblendungsregeln.

Wieder eingeblendete Ergebnisse werden nur dann wieder ausgeblendet, wenn ein Nutzer die Ergebnisse manuell ausblendet oder eine neue übereinstimmende Ausblendungsregel in der Google Cloud Console erstellt. Ausblendungsregeln, die mit der gcloud-CLI oder der Security Command Center API erstellt wurden, haben keine Auswirkungen auf Ergebnisse, die von Nutzern wieder eingeblendet wurden.

Mehrere vorhandene Ergebnisse ausblenden

Mit dem gcloud CLI-Befehl gcloud scc findings bulk-mute oder der Methode bulkMute der Security Command Center API können Sie mehrere vorhandene Ergebnisse gleichzeitig stummschalten. Wenn Sie ähnliche zukünftige Ergebnisse ausblenden möchten, erstellen Sie eine Ausblendungsregel.

Geben Sie die Ergebnisse an, die ausgeblendet werden sollen, indem Sie einen Ergebnisfilter definieren. Bulk-Ausblenden-Filter unterstützen nicht alle Ergebnisattribute. Eine Liste der nicht unterstützten Attribute finden Sie unter Nicht unterstützte Ergebnisattribute für Ausblendungsregeln.

Wenn der Datenstandort für Security Command Center aktiviert ist, sind Bulk-Stummschaltungsvorgänge auf den Security Command Center-Standort beschränkt, an dem sie ausgeführt werden.

Achtung :Bei Bulk-Stummschaltungsvorgängen kann es zu einer Zeitüberschreitung kommen, wenn Sie versuchen, mehr als 4.000.000 vorhandene Ergebnisse auszublenden, oder der Vorgang länger als 6 Stunden dauert. Wenn Sie Millionen von vorhandenen Ergebnissen ausblenden möchten, können Sie die Stummschaltung mithilfe mehrerer Ergebnisabfragen aufteilen, die mit einer kleineren Anzahl von Ergebnissen übereinstimmen.

Hinweis: Bei Ergebnissen, die zur Ergebnisklasse SCC errors gehören, werden Probleme gemeldet, die verhindern, dass Security Command Center wie erwartet funktioniert. Aus diesem Grund können Fehlerergebnisse nicht ausgeblendet werden. Weitere Informationen finden Sie in der Übersicht über Security Command Center-Fehler.

Beispielcode, mit dem Ergebnisse im Bulk-Verfahren ausgeblendet werden, finden Sie unter Ergebnisse im Bulk ausblenden.

Um mehrere Ergebnisse gleichzeitig auszublenden, klicken Sie auf den Tab für das Verfahren, das Sie verwenden möchten:

Console

In der Google Cloud Console können Sie Ergebnisse nur im Bulk ausblenden, indem Sie Ausblendungsregeln erstellen. In der Google Cloud Console werden durch das Erstellen von Ausblendungsregeln vorhandene und zukünftige Ergebnisse ausgeblendet.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud scc findings bulk-mute aus, um mehrere Ergebnisse gleichzeitig auszublenden:

   gcloud scc findings bulk-mute --PARENT=PARENT_ID \
   --location=LOCATION --filter="FILTER" \
   

   Ersetzen Sie Folgendes:

   • PARENT: der Bereich in der Ressourcenhierarchie, für den die Ausblendungsregel gilt, organization, folder oder project.
   • PARENT_ID: Die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts im Format organizations/123, folders/456 oder projects/789.

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Standort von Security Command Center an, an dem die Ergebnisse im Bulk stummgeschaltet werden sollen. Nur Ergebnisse an diesem Ort werden ausgeblendet.

     Wenn der Datenstandort nicht aktiviert ist, werden durch Angabe des Flags --location die Ergebnisse mit der Security Command Center API v2 ausgeblendet. Der einzige gültige Wert für das Flag ist global.

   • FILTER: Ausdruck, den Sie zum Filtern von Ergebnissen definieren

   Wenn Sie beispielsweise alle vorhandenen Ergebnisse der Typen OPEN_FIREWALL und PUBLIC_IP_ADDRESS mit niedrigem Schweregrad im Projekt internal-test ausblenden möchten, kann der Filter "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.project_display_name=\"internal-test\"" sein.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
)

// bulkMute kicks off a long-running operation (LRO) to bulk mute findings for a parent based on a filter.
// The parent can be either an organization, folder, or project. The findings
// matched by the filter will be muted after the LRO is done.
func bulkMute(w io.Writer, parent string, muteRule string) error {
	// parent: Use any one of the following options:
	//             - organizations/{organization_id}
	//             - folders/{folder_id}
	//             - projects/{project_id}
	// parent := fmt.Sprintf("projects/%s", "your-google-cloud-project-id")
	// muteRule: Expression that identifies findings that should be muted.
	// To create mute rules, see:
	// https://cloud.google.com/security-command-center/docs/how-to-mute-findings#create_mute_rules
	// muteRule := "filter-condition"
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.BulkMuteFindingsRequest{
		Parent: parent,
		Filter: muteRule,
	}

	op, err := client.BulkMuteFindings(ctx, req)
	if err != nil {
		return fmt.Errorf("failed to bulk mute findings: %w", err)
	}
	response, err := op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("failed to bulk mute findings: %w", err)
	}
	fmt.Fprintf(w, "Bulk mute findings completed successfully! %s", response)
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.BulkMuteFindingsRequest;
import com.google.cloud.securitycenter.v1.BulkMuteFindingsResponse;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;

public class BulkMuteFindings {

  public static void main(String[] args) {
    // TODO: Replace the variables within {}

    // parentPath: Use any one of the following options:
    //             - organizations/{organization_id}
    //             - folders/{folder_id}
    //             - projects/{project_id}
    String parentPath = String.format("projects/%s", "your-google-cloud-project-id");

    // muteRule: Expression that identifies findings that should be muted.
    // eg: "resource.project_display_name=\"PROJECT_ID\""
    String muteRule = "{filter-condition}";

    bulkMute(parentPath, muteRule);
  }

  // Kicks off a long-running operation (LRO) to bulk mute findings for a parent based on a filter.
  // The parent can be either an organization, folder, or project. The findings
  // matched by the filter will be muted after the LRO is done.
  public static void bulkMute(String parentPath, String muteRule) {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      BulkMuteFindingsRequest bulkMuteFindingsRequest =
          BulkMuteFindingsRequest.newBuilder()
              .setParent(parentPath)
              // To create mute rules, see:
              // https://cloud.google.com/security-command-center/docs/how-to-mute-findings#create_mute_rules
              .setFilter(muteRule)
              .build();

      // ExecutionException is thrown if the below call fails.
      BulkMuteFindingsResponse response =
          client.bulkMuteFindingsAsync(bulkMuteFindingsRequest).get();
      System.out.println("Bulk mute findings completed successfully! " + response);
    } catch (IOException | InterruptedException | ExecutionException e) {
      System.out.println("Bulk mute findings failed! \n Exception: " + e);
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def bulk_mute_findings(parent_path: str, mute_rule: str) -> None:
    """
      Kicks off a long-running operation (LRO) to bulk mute findings for a parent based on a filter.
      The parent can be either an organization, folder, or project. The findings
      matched by the filter will be muted after the LRO is done.
    Args:
        parent_path: use any one of the following options:
                     - organizations/{organization}
                     - folders/{folder}
                     - projects/{project}
        mute_rule: Expression that identifies findings that should be updated.
    """
    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

    request = securitycenter.BulkMuteFindingsRequest()
    request.parent = parent_path
    # To create mute rules, see:
    # https://cloud.google.com/security-command-center/docs/how-to-mute-findings#create_mute_rules
    request.filter = mute_rule

    response = client.bulk_mute_findings(request)
    print(f"Bulk mute findings completed successfully! : {response}")

REST API

Verwenden Sie in der Security Command Center API die Methode bulkMute, um mehrere vorhandene Ergebnisse auszublenden. Der Anfragetext enthält den Ausdruck, der zum Filtern von Ergebnissen verwendet wird.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, rufen Sie über den Endpunkt v1 bulkMute auf:

POST https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/findings:bulkMute -d

{
  "filter": "FILTER"
}

Wenn Sie die Security Command Center API v2 verwenden, rufen Sie über den Endpunkt v2 bulkMute auf:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/locations/LOCATION/findings:bulkMute -d

{
  "filter": "FILTER"
}

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource (organizations, folders oder projects).
• PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts.
• LOCATION: Gibt nur für v2 den Speicherort von Security Command Center an, an dem die Ergebnisse gespeichert werden. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.

• FILTER: Ausdruck, den Sie zum Filtern von Ergebnissen definieren.

  Wenn Sie beispielsweise alle vorhandenen Ergebnisse der Typen OPEN_FIREWALL und PUBLIC_IP_ADDRESS mit niedrigem Schweregrad im Projekt internal-test ausblenden möchten, kann der Filter "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.project_display_name=\"internal-test\"" sein.

Alle vorhandenen Ergebnisse in der ausgewählten Ressource, die genau mit dem Filter übereinstimmen, werden ausgeblendet. Das Attribut mute für die Ergebnisse ist auf MUTED gesetzt.

Das Ausblenden von Ergebnissen ändert nicht ihren Status. Wenn aktive Ergebnisse ausgeblendet werden, bleiben sie aktiv, bis die zugrunde liegenden Sicherheitslücken, Fehlkonfigurationen oder Bedrohungen behoben sind.

Ausblendungs-Regeln erstellen

Ausblendungsregeln sind Security Command Center-Konfigurationen, die von Ihnen erstellte Filter verwenden, um zukünftige Ergebnisse anhand der von Ihnen angegebenen Kriterien automatisch auszublenden. Neue Ergebnisse, die den Ausblendungsfiltern entsprechen, werden kontinuierlich automatisch ausgeblendet. Wenn Sie auch ähnliche vorhandene Ergebnisse ausblenden möchten, verwenden Sie dieselben Filter, um Ergebnisse im Bulk auszublenden.

Umfang der Ausblendungsregeln

Berücksichtigen Sie beim Erstellen von Filtern den Umfang einer Ausblendungsregel.

Wenn beispielsweise ein Filter geschrieben wird, um Ergebnisse in Project A auszublenden, der Filter selbst aber unter Project B erstellt wird, stimmt der Filter möglicherweise mit keinen Ergebnissen überein.

Ebenso ist bei aktiviertem Datenstandort der Bereich einer Ausblendungsregel auf den Security Command Center-Standort beschränkt, an dem die Ausblendungsregel erstellt wurde. Wenn Sie beispielsweise eine Ausblendungsregel am Standort USA (us) erstellen, werden durch sie keine Ergebnisse ausgeblendet, die an den Standorten Europäische Union (eu) oder Global (global) gespeichert sind. Weitere Informationen zu Datenstandort- und Ausblendungsregeln finden Sie unter Ausblendungsregeln, kontinuierliche Exporte und Datenstandort.

Weitere Informationen zum Erstellen von Filtern finden Sie unter Benachrichtigungen filtern.

Einschränkungen für Ausblendungsregel

Ausblendungs-Regeln unterstützen nicht alle Ergebnisattribute. Eine Liste der Attribute, die Ausblendungsregeln nicht unterstützen, finden Sie unter Nicht unterstützte Ergebnisattribute für Ausblendungsregeln.

Hinweis: Ergebnisse, die zur Ergebnisklasse SCC errors gehören, melden Probleme, die verhindern, dass Security Command Center wie erwartet funktioniert. Aus diesem Grund können Fehlerergebnisse nicht ausgeblendet werden. Weitere Informationen finden Sie in der Übersicht über Security Command Center-Fehler.

Ihre Organisation kann maximal 1.000 Ausblendungsregeln erstellen.

Regeln für Datenstandort und Ausblendung

Vorschau — Data residency

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Wenn der Datenstandort aktiviert ist, unterliegen die Konfigurationen, die Ausblendungsregeln definieren (muteConfig-Ressourcen), der Datenstandortkontrolle und werden an einem von Ihnen ausgewählten Security Command Center-Speicherort gespeichert.

Wenn Sie eine Ausblendungsregel auf die Ergebnisse an einem Security Command Center-Standort anwenden möchten, müssen Sie die Ausblendungsregel am selben Ort wie die Ergebnisse erstellen, auf die sie angewendet wird.

Da die in Ausblendungsregeln verwendeten Filter Daten enthalten können, die Standortkontrollen unterliegen, müssen Sie vor dem Erstellen unbedingt den richtigen Speicherort angeben. Security Command Center schränkt nicht den Standort ein, an dem Sie Ausblendungsregeln oder Streamingexporte erstellen.

Ausblendungsregeln werden nur an dem Ort gespeichert, an dem sie erstellt wurden. Sie können an anderen Orten nicht angezeigt oder bearbeitet werden.

Nachdem Sie eine Ausblendungsregel erstellt haben, können Sie ihre Position nicht mehr ändern. Wenn Sie den Standort ändern möchten, müssen Sie die Ausblendungsregel löschen und am neuen Speicherort neu erstellen.

Wenn Sie Ausblendungsregeln in der Google Cloud Console aufrufen möchten, müssen Sie zuerst in der Google Cloud Console-Ansicht den Ort festlegen, an dem sie erstellt wurden.

Dieselben Regeln gelten für die API-Darstellung der Ausblendungsregel MuteConfig.

Wenn Sie ein MuteConfig mithilfe von API-Aufrufen abrufen möchten, müssen Sie den Standort im vollständigen Ressourcennamen von MuteConfig angeben. Beispiel:

GET https://securitycenter.googleapis.com/v2/{name=organizations/123/locations/eu/muteConfigs/my-mute-rule-01}

Wenn Sie ein muteConfig über die gcloud CLI abrufen möchten, können Sie den Speicherort mit dem Flag --locations angeben. Beispiel:

gcloud scc muteconfigs list --organizations=123
--location=us

Ausblendungsregel erstellen

Sie können eine Ausblendungsregel mit der Google Cloud Console, der gcloud CLI oder der Security Command Center API erstellen.

Beispielcode zum Erstellen einer Ausblendungsregel finden Sie unter Ausblendungsregel erstellen.

Klicken Sie zum Erstellen einer Ausblendungsregel auf den Tab für die Prozedur, die Sie verwenden möchten:

Console

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

   Zu Ergebnissen

2. Wählen Sie gegebenenfalls Ihr Google Cloud-Projekt oder Ihre Organisation aus.

   

3. Wenn der Datenstandort für Security Command Center aktiviert ist, verwenden Sie die Standortauswahl direkt unter der Projektauswahl, um den Security Command Center-Standort auszuwählen, an dem die Ausblendungsregel erstellt werden soll. Beispiel:

   

4. Klicken Sie auf Ausblendungsoptionen und wählen Sie Ausblendungsregel erstellen aus.

5. Geben Sie eine ID für eine Ausblendungs-Regel ein. Dieser Wert ist erforderlich.

6. Geben Sie eine Beschreibung der Ausblendungsregel ein, die den Kontext dafür enthält, warum die Ergebnisse ausgeblendet werden. Dieser Wert ist optional, wird aber empfohlen.

7. Übergeordnete Ressource gibt den Bereich an, in dem die Ausblendungs-Regel erstellt und angewendet wird.

8. Erstellen Sie im Feld Ergebnisabfrage Ihre Abfrageanweisungen, indem Sie auf Filter hinzufügen klicken. Alternativ können Sie die Abfrageanweisungen manuell eingeben.

   Im Dialogfeld Filter auswählen können Sie unterstützte Ergebnisattribute und -werte auswählen.

   1. Wählen Sie ein Ergebnisattribut aus oder geben Sie seinen Namen in das Feld Ergebnisattribute suchen ein. Eine Liste der verfügbaren Unterattribute wird angezeigt.
   2. Wählen Sie ein Unterattribut aus. Über einer Liste der Unterattributwerte aus den Ergebnissen im Bereich Ergebnisse der Abfrageergebnisse wird ein Auswahlfeld für die Bewertungsoptionen angezeigt.
   3. Wählen Sie eine Bewertungsoption für die Werte des ausgewählten Unterattributs aus. Weitere Informationen zu den Bewertungsoptionen sowie den von ihnen verwendeten Operatoren und Funktionen finden Sie unter Abfrageoperatoren im Menü „Filter hinzufügen“.
   4. Klicken Sie auf Apply (Anwenden).

      Das Dialogfeld wird geschlossen und Ihre Abfrage wird aktualisiert.

   5. Wiederholen Sie diesen Vorgang, bis die Ergebnisabfrage alle gewünschten Attribute enthält.

9. Prüfen Sie den Filter auf Korrektheit. Wenn Sie Änderungen vornehmen möchten, löschen Sie Attribute oder fügen Sie welche hinzu und filtern Sie Werte nach Bedarf.

10. Klicken Sie auf Vorschau übereinstimmender Ergebnisse.

    Eine Tabelle zeigt Ergebnisse an, die Ihrer Abfrage entsprechen.

11. Klicken Sie auf Speichern.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud scc muteconfigs create aus, um Ausblendungsregeln zu erstellen:

   gcloud scc muteconfigs create CONFIG_ID \
   --PARENT=PARENT_ID \
   --location=LOCATION
   --description="RULE_DESCRIPTION" \
   --filter="FILTER"
   

   Ersetzen Sie Folgendes:

   • CONFIG_ID: der Name der Ausblendungsregel. Die ID muss alphanumerische Zeichen und Bindestriche enthalten und kann zwischen 1 und 63 Zeichen lang sein.
   • PARENT: der Bereich in der Ressourcenhierarchie, für den die Ausblendungsregel gilt, organization, folder oder project.
   • PARENT_ID: Die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts im Format organizations/123, folders/456 oder projects/789.

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Standort von Security Command Center an, in dem die Ausblendungsregel erstellt werden soll. Die Konfiguration der Ausblendungsregel wird gespeichert und gilt nur für Ergebnisse an diesem Ort.

     Wenn der Datenstandort nicht aktiviert ist, wird durch Angabe des Flags --location die Ausblendungsregel mithilfe der Security Command Center API v2 erstellt. Der einzige gültige Wert für das Flag ist global.

   • RULE_DESCRIPTION: eine Beschreibung der Ausblendungsregel mit maximal 1.024 Zeichen.

   • FILTER: Ausdruck, den Sie zum Filtern von Ergebnissen definieren. Wenn Sie beispielsweise OPEN_FIREWALL-Ergebnisse ausblenden möchten, kann der Filter FILTER="category=\"OPEN_FIREWALL\"" sein.

   Die Antwort enthält die Ausblendungsregel-ID, mit der Sie Ausblendungsregeln aufrufen, aktualisieren und löschen können, wie unter Ausblendungsregeln verwalten beschrieben.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
)

// createMuteRule: Creates a mute configuration under a given scope that will mute
// all new findings that match a given filter.
// Existing findings will not be muted.
func createMuteRule(w io.Writer, parent string, muteConfigId string) error {
	// parent: Use any one of the following options:
	//             - organizations/{organization_id}
	//             - folders/{folder_id}
	//             - projects/{project_id}
	// parent := fmt.Sprintf("projects/%s", "your-google-cloud-project-id")
	// muteConfigId: Set a random id; max of 63 chars.
	// muteConfigId := "random-mute-id-" + uuid.New().String()
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	muteConfig := &securitycenterpb.MuteConfig{
		Description: "Mute low-medium IAM grants excluding 'compute' ",
		// Set mute rule(s).
		// To construct mute rules and for supported properties, see:
		// https://cloud.google.com/security-command-center/docs/how-to-mute-findings#create_mute_rules
		Filter: "severity=\"LOW\" OR severity=\"MEDIUM\" AND " +
			"category=\"Persistence: IAM Anomalous Grant\" AND " +
			"-resource.type:\"compute\"",
	}

	req := &securitycenterpb.CreateMuteConfigRequest{
		Parent:       parent,
		MuteConfigId: muteConfigId,
		MuteConfig:   muteConfig,
	}

	response, err := client.CreateMuteConfig(ctx, req)
	if err != nil {
		return fmt.Errorf("failed to create mute rule: %w", err)
	}
	fmt.Fprintf(w, "Mute rule created successfully: %s", response.Name)
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.CreateMuteConfigRequest;
import com.google.cloud.securitycenter.v1.MuteConfig;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import java.io.IOException;
import java.util.UUID;

public class CreateMuteRule {

  public static void main(String[] args) {
    // TODO: Replace the variables within {}

    // parentPath: Use any one of the following options:
    //             - organizations/{organization_id}
    //             - folders/{folder_id}
    //             - projects/{project_id}
    String parentPath = String.format("projects/%s", "your-google-cloud-project-id");

    // muteConfigId: Set a random id; max of 63 chars.
    String muteConfigId = "random-mute-id-" + UUID.randomUUID();
    createMuteRule(parentPath, muteConfigId);
  }

  // Creates a mute configuration under a given scope that will mute
  // all new findings that match a given filter.
  // Existing findings will not be muted.
  public static void createMuteRule(String parentPath, String muteConfigId) {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      MuteConfig muteConfig =
          MuteConfig.newBuilder()
              .setDescription("Mute low-medium IAM grants excluding 'compute' ")
              // Set mute rule(s).
              // To construct mute rules and for supported properties, see:
              // https://cloud.google.com/security-command-center/docs/how-to-mute-findings#create_mute_rules
              .setFilter(
                  "severity=\"LOW\" OR severity=\"MEDIUM\" AND "
                      + "category=\"Persistence: IAM Anomalous Grant\" AND "
                      + "-resource.type:\"compute\"")
              .build();

      CreateMuteConfigRequest request =
          CreateMuteConfigRequest.newBuilder()
              .setParent(parentPath)
              .setMuteConfigId(muteConfigId)
              .setMuteConfig(muteConfig)
              .build();

      // ExecutionException is thrown if the below call fails.
      MuteConfig response = client.createMuteConfig(request);
      System.out.println("Mute rule created successfully: " + response.getName());
    } catch (IOException e) {
      System.out.println("Mute rule creation failed! \n Exception: " + e);
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def create_mute_rule(parent_path: str, mute_config_id: str) -> None:
    """
    Creates a mute configuration under a given scope that will mute
    all new findings that match a given filter.
    Existing findings will NOT BE muted.
    Args:
        parent_path: use any one of the following options:
                     - organizations/{organization_id}
                     - folders/{folder_id}
                     - projects/{project_id}
        mute_config_id: Set a unique id; max of 63 chars.
    """

    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

    mute_config = securitycenter.MuteConfig()
    mute_config.description = "Mute low-medium IAM grants excluding 'compute' "
    # Set mute rule(s).
    # To construct mute rules and for supported properties, see:
    # https://cloud.google.com/security-command-center/docs/how-to-mute-findings#create_mute_rules
    mute_config.filter = (
        'severity="LOW" OR severity="MEDIUM" AND '
        'category="Persistence: IAM Anomalous Grant" AND '
        '-resource.type:"compute"'
    )

    request = securitycenter.CreateMuteConfigRequest()
    request.parent = parent_path
    request.mute_config_id = mute_config_id
    request.mute_config = mute_config

    mute_config = client.create_mute_config(request=request)
    print(f"Mute rule created successfully: {mute_config.name}")

REST API

Verwenden Sie in der Security Command Center API die Methode muteConfigs create, um eine Ausblendungsregel zu erstellen. Der Anfragetext ist eine Instanz von MuteConfig.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, verwenden Sie den Endpunkt der Version 1, um muteConfigs create aufzurufen. Verwenden Sie im Anfragetext die MuteConfig-Definition für Version 1:

POST https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/muteConfigs?muteConfigId=MUTE_CONFIG_ID -d

  {
    "description": "RULE_DESCRIPTION",
    "filter": FILTER
  }

Wenn Sie die Security Command Center API v2 verwenden, verwenden Sie den Endpunkt der Version 2, um muteConfigs create aufzurufen. Verwenden Sie im Anfragetext die MuteConfig-Definition von Version 2:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/locations/LOCATION/muteConfigs?muteConfigId=MUTE_CONFIG_ID -d

  {
    "description": "RULE_DESCRIPTION",
    "filter": FILTER
    "type": "STATIC"
  }

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organizations, folders oder projects)
• PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts
• LOCATION: Gibt für V2 den Standort von Security Command Center an, an dem die Ausblendungsregel gilt. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.
• MUTE_CONFIG_ID: der Name der Ausblendungsregel (zwischen 1 und 63 Zeichen)
• RULE_DESCRIPTION: eine Beschreibung der Ausblendungsregel (max. 1.024 Zeichen)

• FILTER: Ausdruck, den Sie zum Filtern von Ergebnissen definieren

  Wenn Sie beispielsweise Ergebnisse des Typs OPEN_FIREWALL ausblenden möchten, kann der Filter "category=\"OPEN_FIREWALL\"" sein.

Die Antwort enthält die ID der Ausblendungs-Konfiguration, mit der Sie Regeln zum Ausblenden aufrufen, aktualisieren und löschen können, wie unter Regeln zum Ausblenden verwalten beschrieben.

Neue Ergebnisse, die genau mit dem Filter übereinstimmen, werden ausgeblendet. Das Attribut mute für die Ergebnisse wird auf MUTED gesetzt.

Nicht unterstützte Ergebnisattribute für Ausblendungsregeln

Ausblendungsregeln unterstützen nicht alle Ergebniseigenschaften in Filtern. Die folgenden Eigenschaften werden in Ausblendungsregelfiltern nicht unterstützt.

• createTime
• eventTime
• mute
• mute_initiator
• mute_update_time
• name
• parent
• security_marks
• source_properties
• state

Attribute für das Ausblenden von Ergebnissen

In diesem Abschnitt werden die Attribute der ausgeblendeten Ergebnisse aufgelistet. Außerdem wird beschrieben, wie sie durch Vorgänge zum Ausblenden betroffen sind:

• mute: Wird auf UNDEFINED gesetzt, wenn Ergebnisse erstellt werden, und ändert sich in den folgenden Szenarien:
  • MUTED: Ein Ergebnis wird manuell oder durch eine Ausblendungs-Regel ausgeblendet.
  • UNMUTED: Ein Nutzer hebt die Ausblendung eines Ergebnisses auf.
• mute_update_time: die Zeit, zu der ein Ergebnis ausgeblendet oder wieder eingeblendet wird
• mute_initiator: die Kennung für das Hauptkonto oder die Ausblendungs-Regel, mit der ein Ergebnis ausgeblendet wurde

Benachrichtigungen für ausgeblendete Ergebnisse beenden

Wenn Sie Benachrichtigungen für Ergebnisse aktivieren, lösen ausgeblendete Ergebnisse, die Ihren Benachrichtigungsfiltern entsprechen, dennoch Benachrichtigungen in Pub/Sub aus.

Wenn Sie Benachrichtigungen für ausgeblendete Ergebnisse beenden möchten, verwenden Sie das Attribut mute, um ausgeblendete Ergebnisse im NotificationConfig-Filter auszuschließen. Der folgende Filter sendet beispielsweise nur Benachrichtigungen für aktive Ergebnisse, die nicht ausgeblendet wurden oder bei denen das Ausblendungsattribut nicht festgelegt ist:

FILTER="state=\"ACTIVE\" AND -mute=\"MUTED\""

Ausblendungs-Regeln verwalten

Sie können Ausblendungsregeln basierend auf dem Bereich Ihrer IAM-Rollen anzeigen, aktualisieren und löschen. Mit Rollen auf Organisationsebene werden Ausblendungsregeln für alle Ordner und Projekte innerhalb der Organisation angezeigt. Wenn Sie Rollen auf Ordnerebene haben, können Sie auf Ausblendungsregeln für bestimmte Ordner sowie für alle Unterordner und Projekte in diesen Ordnern zugreifen und diese verwalten. Mit Rollen auf Projektebene können Sie Ausblendungsregeln in bestimmten Projekten verwalten.

Security Command Center Premium unterstützt die Zuweisung von Rollen auf Organisations-, Ordner- und Projektebene. Security Command Center Standard unterstützt nur die Rollenzuweisung auf Organisationsebene. Weitere Informationen finden Sie unter Zugriffssteuerung.

Ausblendungs-Regeln auflisten

Sie können die Ausblendungsregeln in einer Organisation, einem Ordner oder einem Projekt über die Google Cloud Console, die gcloud CLI oder die Security Command Center API auflisten.

Ob Sie Ausblendungsregeln für einen bestimmten Bereich auflisten können, hängt von den Berechtigungen ab, die Ihren IAM-Rollen gewährt werden.

Wenn der Datenstandort für Security Command Center aktiviert ist, ist der Bereich des list-Befehls auch auf den ausgewählten Security Command Center-Standort beschränkt.

Beispielcode mit Ausblendungsregeln finden Sie unter Regeln für die Ausblendung von Ausblendungen auflisten.

Klicken Sie zum Auflisten der Ausblendungsregeln für eine Organisation, einen Ordner oder ein Projekt auf den Tab für die Prozedur, die Sie verwenden möchten:

Console

1. Rufen Sie in der Google Cloud Console auf der Seite Einstellungen des Security Command Center den Tab Stummschaltungsregeln auf.

   Zu Ausblendungsregeln

2. Wählen Sie gegebenenfalls Ihr Google Cloud-Projekt oder Ihre Organisation aus.

   

3. Wenn der Datenstandort für Security Command Center aktiviert ist, verwenden Sie die Standortauswahl direkt unter der Projektauswahl, um den Security Command Center-Standort auszuwählen, an dem die Ausblendungsregel gespeichert ist. Beispiel:

   

4. Im Abschnitt Ausblendungsregeln finden Sie unter anderem folgende Details zu aktiven Ausblendungsregeln:

   • Name: ID der Ausblendungsregel
   • Übergeordnete Ressource: die Ressource, auf der sich die Ausblendungs-Regel befindet
   • Beschreibung: Die Beschreibung der Ausblendungsregel, falls verfügbar
   • Zuletzt aktualisiert von: Das Hauptkonto, das zuletzt die Regel aktualisiert hat
   • Zuletzt aktualisiert: Das Datum und die Uhrzeit der letzten Aktualisierung der Regel

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud scc muteconfigs list aus, um Ausblendungsregeln aufzulisten:

   gcloud scc muteconfigs list --PARENT=PARENT_ID --location=LOCATION
   

   Ersetzen Sie Folgendes:

   • PARENT: die übergeordnete organization, folder oder project, für die die Ausblendungsregeln aufgelistet werden sollen
   • PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Standort von Security Command Center an, in dem die Ausblendungsregeln aufgelistet werden sollen.

     Wenn der Datenstandort nicht aktiviert ist, werden durch Angabe des Flags --location Ausblendungsregeln mithilfe der Security Command Center API v2 aufgelistet. Der einzige gültige Wert für das Flag ist global.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
	"google.golang.org/api/iterator"
)

// listMuteRules lists mute configs at the organization level will return all the configs
// at the org, folder, and project levels.
// Similarly, listing configs at folder level will list all the configs
// at the folder and project levels.
func listMuteRules(w io.Writer, parent string) error {
	// Use any one of the following resource paths to list mute configurations:
	//         - organizations/{organization_id}
	//         - folders/{folder_id}
	//         - projects/{project_id}
	// parent := fmt.Sprintf("projects/%s", "your-google-cloud-project-id")
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.ListMuteConfigsRequest{Parent: parent}

	// List all mute configs present in the resource.
	it := client.ListMuteConfigs(ctx, req)
	for {
		muteconfig, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return fmt.Errorf("it.Next: %w", err)
		}
		fmt.Fprintf(w, "Muteconfig Name: %s, ", muteconfig.Name)
	}
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.ListMuteConfigsRequest;
import com.google.cloud.securitycenter.v1.MuteConfig;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import java.io.IOException;

public class ListMuteRules {

  public static void main(String[] args) {
    // TODO: Replace variables enclosed within {}

    // parent: Use any one of the following resource paths to list mute configurations:
    //         - organizations/{organization_id}
    //         - folders/{folder_id}
    //         - projects/{project_id}
    String parentPath = String.format("projects/%s", "your-google-cloud-project-id");
    listMuteRules(parentPath);
  }

  // Listing mute configs at the organization level will return all the configs
  // at the org, folder, and project levels.
  // Similarly, listing configs at folder level will list all the configs
  // at the folder and project levels.
  public static void listMuteRules(String parent) {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      ListMuteConfigsRequest listMuteConfigsRequest =
          ListMuteConfigsRequest.newBuilder().setParent(parent).build();

      // List all mute configs present in the resource.
      for (MuteConfig muteConfig : client.listMuteConfigs(listMuteConfigsRequest).iterateAll()) {
        System.out.println(muteConfig.getName());
      }
    } catch (IOException e) {
      System.out.println("Listing Mute rule failed! \n Exception: " + e);
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def list_mute_rules(parent: str) -> None:
    """
    Listing mute configs at organization level will return all the configs
    at the org, folder and project levels.
    Similarly, listing configs at folder level will list all the configs
    at the folder and project levels.
    Args:
        parent: Use any one of the following resource paths to list mute configurations:
                - organizations/{organization_id}
                - folders/{folder_id}
                - projects/{project_id}
    """
    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

    request = securitycenter.ListMuteConfigsRequest()
    request.parent = parent

    # List all Mute Configs present in the resource.
    for mute_config in client.list_mute_configs(request):
        print(mute_config.name)

REST API

Verwenden Sie in der Security Command Center API die Methode muteConfigs list, um Ausblendungsregeln aufzulisten. Der Anfragetext ist leer.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, rufen Sie muteConfigs list über den Endpunkt v1 auf:

GET https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/muteConfigs

Wenn Sie die Security Command Center API v2 verwenden, rufen Sie muteConfigs list über den Endpunkt v2 auf:

GET https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/locations/LOCATION/muteConfigs

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organizations, folders oder projects)
• PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des Projekts
• LOCATION: Gibt nur für V2 den Standort von Security Command Center an, für den die Ausblendungsregeln aufgelistet werden sollen. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.

Die Antwort enthält die Namen, Beschreibungen und Ausblendungs-Konfigurations-IDs für Ihre Ausblendungsregeln.

Konfiguration einer Ausblendungsregel ansehen

Sie können die Konfiguration einer Ausblendungsregel über die Google Cloud Console, die gcloud CLI oder die Security Command Center API aufrufen.

Beispielcode zum Abrufen der Konfiguration einer Ausblendungsregel finden Sie unter Ausblendungsregel ansehen.

Klicken Sie zum Ansehen der Konfiguration einer Ausblendungsregel auf den Tab für die Prozedur, die Sie verwenden möchten:

Console

1. Rufen Sie in der Google Cloud Console auf der Seite Einstellungen des Security Command Center den Tab Stummschaltungsregeln auf.

   Zu Ausblendungsregeln

2. Wählen Sie gegebenenfalls Ihr Google Cloud-Projekt oder Ihre Organisation aus.

   

3. Wenn der Datenstandort für Security Command Center aktiviert ist, verwenden Sie die Standortauswahl direkt unter der Projektauswahl, um den Security Command Center-Standort der Ausblendungsregel auszuwählen. Beispiel:

   

4. Im Abschnitt Ausblendungsregeln sehen Sie eine Liste der Ausblendungsregeln.

5. Klicken Sie auf den Namen der Regel, die Sie aufrufen möchten.

   Eine Seite mit der Konfiguration der Ausblendungs-Regel wird geöffnet.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud scc muteconfigs get aus, um die Konfiguration einer Ausblendungsregel aufzurufen:

   gcloud scc muteconfigs get MUTE_CONFIG_ID \
    --PARENT=PARENT_ID --location=LOCATION
   

   Ersetzen Sie Folgendes:

   • MUTE_CONFIG_ID: die ID für die Ausblendungsregel
   • PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organization, folder oder project)
   • PARENT_ID: ID der Organisation, des Ordners oder des Projekts

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Standort von Security Command Center an, in dem die Ausblendungsregel gespeichert ist. Der Standardwert ist global.

     Wenn der Datenstandort nicht aktiviert ist, wird durch Angabe des Flags --location die Ausblendungsregel mithilfe der Security Command Center API v2 abgerufen. Der einzige gültige Wert für das Flag ist global.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
)

// getMuteRule retrieves a mute configuration given its resource name.
func getMuteRule(w io.Writer, parent string, muteConfigId string) error {
	// Use any one of the following resource paths to get mute configuration:
	//         - organizations/{organization_id}
	//         - folders/{folder_id}
	//         - projects/{project_id}
	// parent := fmt.Sprintf("projects/%s", "your-google-cloud-project-id")
	//
	// Name of the mute config to retrieve.
	// muteConfigId := "mute-config-id"
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.GetMuteConfigRequest{
		Name: fmt.Sprintf("%s/muteConfigs/%s", parent, muteConfigId),
	}

	muteconfig, err := client.GetMuteConfig(ctx, req)
	if err != nil {
		return fmt.Errorf("Failed to retrieve Muteconfig: %w", err)
	}
	fmt.Fprintf(w, "Muteconfig Name: %s ", muteconfig.Name)
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.MuteConfig;
import com.google.cloud.securitycenter.v1.MuteConfigName;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import java.io.IOException;

public class GetMuteRule {

  public static void main(String[] args) {
    // TODO(Developer): Replace the following variables

    // parentPath: Use any one of the following options:
    //             - organizations/{organization_id}
    //             - folders/{folder_id}
    //             - projects/{project_id}
    String parentPath = String.format("projects/%s", "your-google-cloud-project-id");

    // muteConfigId: Name of the mute config to retrieve.
    String muteConfigId = "mute-config-id";

    getMuteRule(parentPath, muteConfigId);
  }

  // Retrieves a mute configuration given its resource name.
  public static void getMuteRule(String projectId, String muteConfigId) {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {
      // Use appropriate MuteConfigName methods depending on the type of parent.
      // (org -> MuteConfigName.ofOrganizationMuteConfigName()
      // folder -> MuteConfigName.ofFolderMuteConfigName()
      // project -> MuteConfigName.ofProjectMuteConfigName)
      MuteConfig muteConfig =
          client.getMuteConfig(MuteConfigName.ofProjectMuteConfigName(projectId, muteConfigId));

      System.out.println("Retrieved the mute config: " + muteConfig);
    } catch (IOException e) {
      System.out.println("Mute rule retrieval failed! \n Exception: " + e);
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def get_mute_rule(mute_config_name: str) -> None:
    """
    Retrieves a mute configuration given its resource name.
    Args:
        mute_config_name: Name of the mute config to retrieve.
                          Use any one of the following formats:
                          - organizations/{organization}/muteConfigs/{config_id}
                          - folders/{folder}/muteConfigs/{config_id}
                          - projects/{project}/muteConfigs/{config_id}
    """
    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

    request = securitycenter.GetMuteConfigRequest()
    request.name = mute_config_name

    mute_config = client.get_mute_config(request)
    print(f"Retrieved the mute rule: {mute_config.name}")

REST API

Verwenden Sie in der Security Command Center API die Methode muteConfigs get, um die Konfiguration einer Ausblendungsregel zurückzugeben. Der Anfragetext ist leer.

Wenn Sie die CONFIG_ID für eine Ausblendungsregel abrufen möchten, führen Sie zuerst einen API-Aufruf für Ausblendungsregeln auflisten aus. Die Antwort enthält Konfigurations-IDs für zurückgegebene Ausblendungs-Regeln.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, verwenden Sie den Endpunkt v1, um muteConfigs get aufzurufen:

GET https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/muteConfigs/CONFIG_ID

Wenn Sie die Security Command Center API v2 verwenden, verwenden Sie den Endpunkt v2, um muteConfigs get aufzurufen:

GET https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/locations/LOCATION/muteConfigs/CONFIG_ID

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organizations, folders oder projects)
• PARENT_ID: durch die ID der Organisation, des Ordners oder des Projekts
• LOCATION: Gibt für V2 den Speicherort von Security Command Center an, an dem die Ausblendungsregel gespeichert ist. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.
• CONFIG_ID: Die numerische ID der Ausblendungs-Regel

Ausblendungs-Regeln aktualisieren

Sie können die Beschreibung oder den Ergebnisfilter einer Ausblendungsregel mit der Google Cloud Console, der gcloud CLI oder der Security Command Center API aktualisieren.

Sie können die ID, die übergeordnete Organisation, den Ordner oder das Projekt sowie den Speicherort einer Ausblendungsregel nicht ändern. Wenn Sie einen dieser Werte ändern möchten, müssen Sie eine neue Ausblendungsregel erstellen.

Wenn Sie zuvor Ergebnisse wieder eingeblendet haben, werden sie wieder ausgeblendet, wenn sie mit einer in der Google Cloud Console aktualisierten Ausblendungsregel übereinstimmen. Weitere Informationen finden Sie unter Wieder eingeblendete Ergebnisse überschreiben Ausblendungsregeln.

Hinweis: Ergebnisse, die zur Ergebnisklasse SCC errors gehören, melden Probleme, die verhindern, dass Security Command Center wie erwartet funktioniert. Aus diesem Grund können Fehlerergebnisse nicht ausgeblendet werden. Weitere Informationen finden Sie in der Übersicht über Security Command Center-Fehler.

Beispielcode zum Aktualisieren einer Ausblendungsregel finden Sie unter Ausblendungsregel aktualisieren.

Klicken Sie zum Aktualisieren einer Ausblendungsregel auf den Tab für die Prozedur, die Sie verwenden möchten:

Console

1. Rufen Sie in der Google Cloud Console auf der Seite Einstellungen des Security Command Center den Tab Stummschaltungsregeln auf.

   Zu Ausblendungsregeln

2. Wählen Sie das Google Cloud-Projekt oder die Organisation aus, die die übergeordnete Ressource für die Ausblendungsregel ist, die Sie ändern möchten.

3. Wenn der Datenstandort für Security Command Center aktiviert ist, verwenden Sie die Standortauswahl direkt unter der Projektauswahl, um den Security Command Center-Standort der Ausblendungsregel auszuwählen. Beispiel:

   

4. Klicken Sie auf den Namen der Ausblendungsregel, die Sie ändern möchten.

   Wenn Sie nicht das entsprechende Projekt oder die entsprechende Organisation ausgewählt haben, werden Sie möglicherweise in einem Hinweis darauf hingewiesen, dass Sie nicht berechtigt sind, die Ausblendungsregel zu ändern.

5. Geben Sie eine neue Beschreibung ein und klicken Sie auf Speichern.

6. Aktualisieren oder ändern Sie den Filter.

   Eine Anleitung finden Sie unter Regeln zum Ausblenden erstellen.

7. Klicken Sie auf Vorschau der übereinstimmenden Ergebnisse anzeigen, um Ergebnisse anzuzeigen, die dem aktualisierten Filter entsprechen.

   Eine Tabelle mit Ergebnissen, die der neuen Abfrage entsprechen, wird geladen.

8. Klicken Sie auf Speichern.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud scc muteconfigs update aus, um Ausblendungsregeln zu aktualisieren:

     gcloud scc muteconfigs update MUTE_CONFIG_ID \
       --PARENT=PARENT_ID \
       --location=LOCATION
       --description=RULE_DESCRIPTION \
       --filter=FILTER
   

   Ersetzen Sie Folgendes:

   • MUTE_CONFIG_ID: die ID für die Ausblendungsregel.
   • PARENT: die übergeordnete Ressource für die Ausblendungsregel (organization, folder oder project).
   • PARENT_ID: durch die ID der Organisation, des Ordners oder des Projekts.

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Standort von Security Command Center an, in dem die Ausblendungsregel gespeichert ist. Der Standardwert ist global.

     Wenn der Datenstandort nicht aktiviert ist, wird durch Angabe des Flags --location die Konfiguration der Ausblendungsregel mithilfe der Security Command Center API v2 aktualisiert. Der einzige gültige Wert für das Flag ist global.

   • RULE_DESCRIPTION: eine Beschreibung der Ausblendungsregel (max. 1.024 Zeichen)

   • FILTER: Ausdruck, den Sie zum Filtern von Ergebnissen definieren.

     Wenn Sie beispielsweise OPEN_FIREWALL-Ergebnisse ausblenden möchten, könnte der Filter FILTER="category=\"OPEN_FIREWALL\"" lauten.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
	"google.golang.org/protobuf/types/known/fieldmaskpb"
)

// updateMuteRule Updates an existing mute configuration.
// The following can be updated in a mute config: description and filter.
func updateMuteRule(w io.Writer, muteConfigName string) error {
	// Specify the name of the mute config to delete.
	// muteConfigName: Use any one of the following formats:
	//                 - organizations/{organization}/muteConfigs/{config_id}
	//                 - folders/{folder}/muteConfigs/{config_id}
	//                 - projects/{project}/muteConfigs/{config_id}
	// muteConfigName := fmt.Sprintf("projects/%s/muteConfigs/%s", "project-id", "mute-config")
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	updateMuteConfig := &securitycenterpb.MuteConfig{
		Name:        muteConfigName,
		Description: "Updated mute config description",
	}

	req := &securitycenterpb.UpdateMuteConfigRequest{
		MuteConfig: updateMuteConfig,
		// Set the update mask to specify which properties of the mute config should be
		// updated.
		// If empty, all mutable fields will be updated.
		// Make sure that the mask fields match the properties changed in 'updateMuteConfig'.
		// For more info on constructing update mask path, see the proto or:
		// https://cloud.google.com/security-command-center/docs/reference/rest/v1/folders.muteConfigs/patch?hl=en#query-parameters
		UpdateMask: &fieldmaskpb.FieldMask{
			Paths: []string{
				"description",
			},
		},
	}

	response, err := client.UpdateMuteConfig(ctx, req)
	if err != nil {
		return fmt.Errorf("mute rule update failed! %v", err)
	}
	fmt.Fprintf(w, "Mute rule updated %s", response.Name)
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.MuteConfig;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import com.google.cloud.securitycenter.v1.UpdateMuteConfigRequest;
import com.google.protobuf.FieldMask;
import java.io.IOException;

public class UpdateMuteRule {

  public static void main(String[] args) {
    // TODO: Replace the variables within {}

    // Specify the name of the mute config to delete.
    // muteConfigName: Use any one of the following formats:
    //                 - organizations/{organization}/muteConfigs/{config_id}
    //                 - folders/{folder}/muteConfigs/{config_id}
    //                 - projects/{project}/muteConfigs/{config_id}
    String muteConfigName = "{any-one-of-the-above-formats}";
    updateMuteRule(muteConfigName);
  }

  // Updates an existing mute configuration.
  // The following can be updated in a mute config: description and filter.
  public static void updateMuteRule(String muteConfigName) {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient securityCenterClient = SecurityCenterClient.create()) {

      MuteConfig updateMuteConfig =
          MuteConfig.newBuilder()
              .setName(muteConfigName)
              .setDescription("Updated mute config description")
              .build();

      UpdateMuteConfigRequest updateMuteConfigRequest =
          UpdateMuteConfigRequest.newBuilder()
              .setMuteConfig(updateMuteConfig)
              // Set the update mask to specify which properties of the mute config should be
              // updated.
              // If empty, all mutable fields will be updated.
              // Make sure that the mask fields match the properties changed in 'updateMuteConfig'.
              // For more info on constructing update mask path, see the proto or:
              // https://cloud.google.com/security-command-center/docs/reference/rest/v1/folders.muteConfigs/patch?hl=en#query-parameters
              .setUpdateMask(FieldMask.newBuilder().addPaths("description").build())
              .build();

      MuteConfig response = securityCenterClient.updateMuteConfig(updateMuteConfigRequest);
      System.out.println(response);
    } catch (IOException e) {
      System.out.println("Mute rule update failed! \n Exception: " + e);
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def update_mute_rule(mute_config_name: str) -> None:
    """
    Updates an existing mute configuration.
    The following can be updated in a mute config: description, and filter/ mute rule.
    Args:
        mute_config_name: Specify the name of the mute config to delete.
                          Use any one of the following formats:
                          - organizations/{organization}/muteConfigs/{config_id}
                          - folders/{folder}/muteConfigs/{config_id}
                          - projects/{project}/muteConfigs/{config_id}
    """
    from google.cloud import securitycenter
    from google.protobuf import field_mask_pb2

    client = securitycenter.SecurityCenterClient()

    update_mute_config = securitycenter.MuteConfig()
    update_mute_config.name = mute_config_name
    update_mute_config.description = "Updated mute config description"

    field_mask = field_mask_pb2.FieldMask(paths=["description"])

    request = securitycenter.UpdateMuteConfigRequest()
    request.mute_config = update_mute_config
    # Set the update mask to specify which properties of the Mute Config should be updated.
    # If empty, all mutable fields will be updated.
    # Make sure that the mask fields match the properties changed in 'update_mute_config'.
    # For more info on constructing update mask path, see the proto or:
    # https://cloud.google.com/security-command-center/docs/reference/rest/v1/folders.muteConfigs/patch?hl=en#query-parameters
    request.update_mask = field_mask

    mute_config = client.update_mute_config(request)
    print(f"Updated mute rule : {mute_config}")

REST API

Verwenden Sie in der Security Command Center API die Methode muteConfigs patch, um eine Ausblendungsregel zu aktualisieren. Der Anfragetext ist eine Instanz von MuteConfig.

Wenn Sie die CONFIG_ID für eine Ausblendungsregel abrufen möchten, führen Sie einen API-Aufruf zum Auflisten der Ausblendungsregeln aus. Die Antwort enthält Konfigurations-IDs für zurückgegebene Ausblendungs-Regeln.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, rufen Sie muteConfigs patch über den Endpunkt v1 auf:

PATCH https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/muteConfigs/CONFIG_ID

  {
    "description": "RULE_DESCRIPTION",
    "filter": "FILTER",
    "type": "STATIC"
  }

Wenn Sie die Security Command Center API v2 verwenden, rufen Sie muteConfigs patch über den Endpunkt v2 auf:

PATCH https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/locations/LOCATION/muteConfigs/CONFIG_ID

  {
    "description": "RULE_DESCRIPTION",
    "filter": "FILTER",
  }

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organizations, folders oder projects)
• PARENT_ID: durch die ID der Organisation, des Ordners oder des Projekts
• LOCATION: Gibt für V2 den Speicherort von Security Command Center an, an dem die Ausblendungsregel gespeichert ist. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.
• CONFIG_ID: Die numerische ID der Ausblendungs-Regel
• RULE_DESCRIPTION: eine Beschreibung der Ausblendungsregel (max. 1.024 Zeichen)

• FILTER: der Ausdruck, den Sie zum Filtern von Ergebnissen definieren

  Wenn Sie beispielsweise Ergebnisse des Typs OPEN_FIREWALL ausblenden möchten, kann der Filter "category=\"OPEN_FIREWALL\"" sein.

Neue Ergebnisse, die genau mit dem Filter übereinstimmen, werden ausgeblendet. Das Attribut mute für die Ergebnisse wird auf MUTED gesetzt.

Durch die Aktualisierung von Ausblendungsregeln werden Ergebnisse, die von vorherigen Regeln ausgeblendet wurden, nicht automatisch wieder eingeblendet. Sie müssen Ergebnisse manuell wieder einblenden.

Ausblendungs-Regeln löschen

Sie können eine Ausblendungsregel mit der Google Cloud Console, der gcloud CLI oder der Security Command Center API löschen.

Bevor Sie Ausblendungs-Regeln löschen, sollten Sie Folgendes verstehen:

• Sie können gelöschte Ausblendungsregeln nicht wiederherstellen.
• Durch das Löschen von Ausblendungsregeln werden ausgeblendete Ergebnisse nicht automatisch wieder eingeblendet. Sie müssen die Stummschaltung von Ergebnissen manuell oder programmatisch aufheben.
• Zukünftige Ergebnisse, die mit Filtern in gelöschten Ausblendungsregeln übereinstimmen, werden nicht ausgeblendet.

Einen Beispielcode zum Löschen einer Ausblendungsregel finden Sie unter Ausblendungsregel löschen.

Klicken Sie zum Löschen einer Ausblendungsregel auf den Tab für die Prozedur, die Sie verwenden möchten:

Console

1. Rufen Sie in der Google Cloud Console auf der Seite Einstellungen des Security Command Center den Tab Stummschaltungsregeln auf.

   Zu Ausblendungsregeln

2. Wählen Sie gegebenenfalls Ihr Google Cloud-Projekt oder Ihre Organisation aus.

   

3. Wenn der Datenstandort für Security Command Center aktiviert ist, verwenden Sie die Standortauswahl direkt unter der Projektauswahl, um den Security Command Center-Standort auszuwählen, an dem die Ausblendungsregel gespeichert ist. Beispiel:

   

4. Klicken Sie auf den Namen der Ausblendungsregel, die Sie löschen möchten.

5. Klicken Sie auf Löschen.

6. Lesen Sie das Dialogfeld und klicken Sie, wenn Sie zufrieden sind, auf Löschen.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud scc muteconfigs delete aus, um Ausblendungsregeln zu löschen:

   gcloud scc muteconfigs delete MUTE_CONFIG_ID \
    --PARENT=PARENT_ID --location=LOCATION
   

   Ersetzen Sie Folgendes:

   • MUTE_CONFIG_ID: die ID der Ausblendungs-Konfiguration
   • PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organization, folder oder project)
   • PARENT_ID: durch die ID der Organisation, des Ordners oder des Projekts

   • LOCATION: Wenn der Datenstandort aktiviert ist, geben Sie den Standort von Security Command Center an, in dem die Konfiguration der Ausblendungsregel gespeichert ist. Der Standardwert ist global.

     Wenn der Datenstandort nicht aktiviert ist, wird durch Angabe des Flags --location die Ausblendungsregel mithilfe der Security Command Center API v2 gelöscht. Der einzige gültige Wert für das Flag ist global.

3. Bestätigen Sie Ihre Anfrage zum Löschen der Ausblendungsregel.

Einfach loslegen (Go)

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv1"
	"cloud.google.com/go/securitycenter/apiv1/securitycenterpb"
)

// deleteMuteRule deletes a mute configuration given its resource name.
// Note: Previously muted findings are not affected when a mute config is deleted.
func deleteMuteRule(w io.Writer, parent string, muteConfigId string) error {
	// parent: Use any one of the following options:
	//             - organizations/{organization_id}
	//             - folders/{folder_id}
	//             - projects/{project_id}
	// parent := fmt.Sprintf("projects/%s", "your-google-cloud-project-id")
	//
	// muteConfigId: Specify the name of the mute config to delete.
	// muteConfigId := "mute-config-id"
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.DeleteMuteConfigRequest{
		Name: fmt.Sprintf("%s/muteConfigs/%s", parent, muteConfigId),
	}

	if err := client.DeleteMuteConfig(ctx, req); err != nil {
		return fmt.Errorf("failed to delete Muteconfig: %w", err)
	}
	fmt.Fprintf(w, "Mute rule deleted successfully: %s", muteConfigId)
	return nil
}

Java

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

import com.google.cloud.securitycenter.v1.MuteConfigName;
import com.google.cloud.securitycenter.v1.SecurityCenterClient;
import java.io.IOException;

public class DeleteMuteRule {

  public static void main(String[] args) {
    // TODO(Developer): Replace the following variables
    // parentPath: Use any one of the following options:
    //             - organizations/{organization_id}
    //             - folders/{folder_id}
    //             - projects/{project_id}
    String parentPath = String.format("projects/%s", "your-google-cloud-project-id");

    // muteConfigId: Specify the name of the mute config to delete.
    String muteConfigId = "mute-config-id";

    deleteMuteRule(parentPath, muteConfigId);
  }

  // Deletes a mute configuration given its resource name.
  // Note: Previously muted findings are not affected when a mute config is deleted.
  public static void deleteMuteRule(String projectId, String muteConfigId) {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {
      // Use appropriate MuteConfigName methods depending on the type of parent.
      // org -> MuteConfigName.ofOrganizationMuteConfigName()
      // folder -> MuteConfigName.ofFolderMuteConfigName()
      // project -> MuteConfigName.ofProjectMuteConfigName)
      client.deleteMuteConfig(MuteConfigName.ofProjectMuteConfigName(projectId, muteConfigId));

      System.out.println("Mute rule deleted successfully: " + muteConfigId);
    } catch (IOException e) {
      System.out.println("Mute rule deletion failed! \n Exception: " + e);
    }
  }
}

Python

Im folgenden Beispiel wird die API V1 verwendet. Wenn Sie das Beispiel für v2 ändern möchten, ersetzen Sie v1 durch v2 und fügen Sie dem Ressourcennamen /locations/LOCATION hinzu.

Für die meisten Ressourcen fügen Sie dem Ressourcennamen nach /PARENT/PARENT_ID /locations/LOCATION hinzu, wobei PARENT entweder organizations, folders oder projects ist.

Fügen Sie für Ergebnisse /locations/LOCATION dem Ressourcennamen nach /sources/SOURCE_ID hinzu, wobei SOURCE_ID die ID des Security Command Center-Dienstes ist, der das Ergebnis ausgestellt hat.

def delete_mute_rule(mute_config_name: str) -> None:
    """
    Deletes a mute configuration given its resource name.
    Note: Previously muted findings are not affected when a mute config is deleted.
    Args:
        mute_config_name: Specify the name of the mute config to delete.
                          Use any one of the following formats:
                          - organizations/{organization}/muteConfigs/{config_id}
                          - folders/{folder}/muteConfigs/{config_id} or
                          - projects/{project}/muteConfigs/{config_id}
    """
    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

    request = securitycenter.DeleteMuteConfigRequest()
    request.name = mute_config_name

    client.delete_mute_config(request)
    print(f"Mute rule deleted successfully: {mute_config_name}")

REST API

Verwenden Sie in der Security Command Center API die Methode muteConfigs delete, um eine Ausblendungsregel zu löschen. Der Anfragetext ist leer.

Um die CONFIG_ID für eine Ausblendungsregel abzurufen, führen Sie einen API-Aufruf für Ausblendungsregeln auflisten aus. Die Antwort enthält Konfigurations-IDs für zurückgegebene Ausblendungs-Regeln.

Wenn der Datenstandort nicht aktiviert ist, können Sie entweder v1 oder v2 der Security Command Center API verwenden. API Version 2 ist als Vorabversion verfügbar. Wenn der Datenstandort aktiviert ist, ist API v2 die einzige verfügbare API.

Wenn Sie die Security Command Center API v1 verwenden, verwenden Sie den Endpunkt v1, um muteConfigs delete aufzurufen:

DELETE https://securitycenter.googleapis.com/v1/PARENT/PARENT_ID/muteConfigs/CONFIG_ID

Wenn Sie die Security Command Center API v2 verwenden, verwenden Sie den Endpunkt v2, um muteConfigs delete aufzurufen:

DELETE https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/locations/LOCATION/muteConfigs/CONFIG_ID

Ersetzen Sie Folgendes:

• PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organizations, folders oder projects)
• PARENT_ID: durch die ID der Organisation, des Ordners oder des Projekts
• LOCATION: Gibt für V2 den Speicherort von Security Command Center an, an dem die Ausblendungsregel gespeichert ist. Wenn das Standortfeld weggelassen wird, ist der Standardwert global.
• CONFIG_ID: Die numerische ID der Ausblendungs-Regel

Nächste Schritte

Weitere Informationen zum Filtern von Ergebnisbenachrichtigungen

Weitere Beispiele für Filter, die Sie verwenden können