Einzelne Ergebnisse ausblenden

Mit der statischen Ausblendung im Security Command Center können Sie einzelne Ergebnisse oder Gruppen von Ergebnissen aus Abfrageergebnissen ausblenden, ohne ihren aktiven Status zu ändern. Mit dieser Funktion können Sie die Anzahl der Ergebnisse in der Ergebnisansicht reduzieren, entsprechende Fälle mit schädlichen Kombinationen schließen und stummgeschaltete Ergebnisse von Benachrichtigungen ausschließen. Sie können auch die Stummschaltung von Ergebnissen aufheben, dynamische Ausblendungsregeln überschreiben oder Ausblendungsüberschreibungen zurücksetzen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für die Organisation, den Ordner oder das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausblenden oder Einblenden von Ergebnissen benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Einzelnes Ergebnis ausblenden

Sie können ein einzelnes Ergebnis mithilfe derGoogle Cloud Console, der gcloud CLI oder der Security Command Center API statisch ausblenden.

Das statische Ausblenden eines Ergebnisses hat keinen Einfluss darauf, ob es aktiv ist oder nicht. Wenn ein aktives Ergebnis ausgeblendet wird, bleibt das Attribut state unverändert: state="ACTIVE". Das Ergebnis wird ausgeblendet, bleibt aber aktiv, bis die zugrunde liegende Sicherheitslücke, Fehlkonfiguration oder Bedrohung behoben ist. Wenn Sie ein Ergebnis statisch ausblenden, werden alle dynamischen Ausblendungsregeln, die für das Ergebnis gelten, überschrieben.

Wenn Sie ein Ergebnis zu einer schädlichen Kombination ausblenden, wird der entsprechende Fall geschlossen.

Informationen zum Ausblenden aller zukünftigen Ergebnisse, die den von Ihnen angegebenen Kriterien entsprechen, finden Sie unter Ausblendungsregeln verwalten.

Beispielcode zum Ausblenden eines Ergebnisses finden Sie unter Ergebnis ausblenden.

Klicken Sie auf den Tab für das Verfahren, das Sie verwenden möchten, um ein einzelnes Ergebnis statisch auszublenden:

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 das Ergebnis, das Sie ausblenden möchten, nicht im Bereich Ergebnisse der Ergebnisabfrage angezeigt wird, wählen Sie im Bereich Schnellfilter im Abschnitt Kategorie die Kategorie des Ergebnisses aus.
  4. Wählen Sie das Ergebnis aus, das Sie ausblenden möchten. Sie können ein oder mehrere Ergebnisse auswählen.
  5. Klicken Sie in der Aktionsleiste Ergebnisse der Ergebnisabfrage auf Ausblendungsoptionen und wählen Sie dann Ausblendungsüberschreibung anwenden aus.

    Das Attribut mute für die ausgewählten Ergebnisse wird auf MUTED gesetzt und das Ergebnis wird aus dem Bereich Ergebnisse der Ergebnisabfrage entfernt. Alternativ können Sie ein Ergebnis über den Detailbereich ausblenden:

  6. Klicken Sie auf der Seite Ergebnisse im Bereich Ergebnisse der Ergebnisabfrage in der Spalte Kategorie auf den Namen eines einzelnen Ergebnisses. Der Detailbereich des Ergebnisses wird geöffnet.

  7. Klicken Sie auf Maßnahmen ergreifen.

  8. Wählen Sie im Menü Maßnahme ergreifen die Option Überschreibung der Stummschaltung anwenden aus.

    Wenn Sie stattdessen Ergebnisse wie dieses ausblenden auswählen, wird die Seite Ausblendungsregel erstellen geöffnet. Dort 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), Groß-/Kleinschreibung beachten

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

    • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert global.

    • SOURCE_ID: die Quell-ID.

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

Go

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv2"
	"cloud.google.com/go/securitycenter/apiv2/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


import com.google.cloud.securitycenter.v2.Finding;
import com.google.cloud.securitycenter.v2.Finding.Mute;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.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/{org_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/locations/{location}/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.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      SetMuteRequest setMuteRequest =
          SetMuteRequest.newBuilder()
              // Relative path for the finding.
              .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

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_v2

    client = securitycenter_v2.SecurityCenterClient()

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

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

REST

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

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 übergeordneten Projekts.
  • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert global.
  • SOURCE_ID: die numerische ID der Quelle.

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

  • 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.

Nachdem Sie ein Ergebnis ausgeblendet haben, wird das Attribut mute auf MUTED gesetzt.

Stummschaltung einzelner Ergebnisse aufheben

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

Das Aufheben der Stummschaltung eines Ergebnisses ist nützlich, wenn Sie verhindern möchten, dass ein Ergebnis durch eine zu weit gefasste Ausblendungsregel oder durch eine Regel ausgeblendet wird, die möglicherweise zu komplex ist, um sie so zu ändern, dass Ergebnisse, die Sie für wichtig halten, ausgeschlossen werden.

Wieder eingeblendete Ergebnisse werden nur dann wieder ausgeblendet, wenn sie manuell ausgeblendet werden. 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.

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

Console

Wenn Sie die Stummschaltung eines einzelnen Ergebnisses über die Google Cloud Console aufheben möchten, klicken Sie auf den Tab für Ihre Dienststufe:

  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 Bereich Abfragevorschau angezeigt. Mit der Standardabfrage werden ausgeblendete Ergebnisse herausgefiltert. Sie müssen die Abfrage also bearbeiten, damit ausgeblendete Ergebnisse im Bereich Ergebnisse der Suche nach Sicherheitslücken angezeigt werden.
  3. Klicken Sie rechts neben dem Abschnitt Abfragevorschau auf Abfrage bearbeiten, um den Abfrageeditor zu öffnen.
  4. Ersetzen Sie im Feld Abfrageeditor die vorhandene Ausblendungsanweisung durch Folgendes:
    mute="MUTED"
  5. Klicken Sie auf Übernehmen. Im Bereich Ergebnisse der Ergebnisabfrage werden nur die ausgeblendeten Ergebnisse angezeigt.
  6. Filtern Sie bei Bedarf 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.
  7. Wählen Sie das Ergebnis aus, dessen Stummschaltung Sie aufheben möchten. Sie können ein oder mehrere Ergebnisse auswählen.
  8. Klicken Sie in der Aktionsleiste Ergebnisse der Ergebnisabfrage auf Ausblendungsoptionen und wählen Sie dann Überschreibung zum Aufheben der Ausblendung anwenden aus. Das Attribut mute für die ausgewählten Ergebnisse wird auf UNMUTED gesetzt und das Ergebnis wird aus dem Bereich Ergebnisse der Ergebnisabfrage entfernt. Alternativ können Sie die Stummschaltung eines Ergebnisses über den Detailbereich aufheben:
  9. Klicken Sie auf der Seite Ergebnisse im Bereich Ergebnisse der Ergebnisabfrage in der Spalte Kategorie auf den Namen eines einzelnen Ergebnisses. Der Detailbereich des Ergebnisses wird geöffnet.
  10. Klicken Sie auf Maßnahmen ergreifen.
  11. Wählen Sie im Menü Aktion ausführen die Option Überschreibung der Stummschaltung anwenden 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), Groß-/Kleinschreibung beachten

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

    • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert global.

    • SOURCE_ID: die Quell-ID.

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

Go


import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv2"
	"cloud.google.com/go/securitycenter/apiv2/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


import com.google.cloud.securitycenter.v2.Finding;
import com.google.cloud.securitycenter.v2.Finding.Mute;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.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/{org_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/locations/{location}/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.
    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

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_v2

    client = securitycenter_v2.SecurityCenterClient()

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

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

REST

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

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 übergeordneten Projekts
  • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert 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 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.

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

Überschreibung des Ausblendungsstatus für einzelne Ergebnisse entfernen

Sie wenden eine Überschreibung des Ausblendungsstatus an, wenn Sie den Ausblendungsstatus eines Ergebnisses absichtlich ändern, um das Ergebnis statisch auszublenden oder einzublenden. Beispielsweise können Sie einen Ausblendungsstatus überschreiben, um ein Ergebnis mit niedrigem Schweregrad auszublenden, für das es sich nicht lohnt, eine dynamische Ausblendungsregel zu erstellen.

Sie können eine Überschreibung des Ausblendungsstatus für ein einzelnes Ergebnis mithilfe der Google Cloud Console, der gcloud CLI oder der Security Command Center API entfernen.

Bevor Sie die Überschreibung des Status „Ausgeblendet“ für ein Ergebnis entfernen, sollten Sie Folgendes beachten:

  • Ein Ergebnis hat eine Überschreibung des Ausblendungsstatus, wenn es statisch ausgeblendet oder eingeblendet ist. Sie können den Ausblendungsstatus für jedes Ergebnis manuell oder automatisch mit statischen Ausblendungsregeln überschreiben.
  • Eine Überschreibung des Ausblendungsstatus gilt auf unbestimmte Zeit für ein Ergebnis und hat Vorrang vor allen übereinstimmenden Ausblendungsregeln.
  • Wenn Sie die Überschreibung des Ausblendungsstatus für ein Ergebnis entfernen, wird der Ausblendungsstatus des Ergebnisses zurückgesetzt, sodass es von statischen oder dynamischen Ausblendungsregeln verarbeitet werden kann.
  • Das Entfernen der Überschreibung des Ausblendungsstatus von einem Ergebnis unterscheidet sich vom Aufheben der Ausblendung eines Ergebnisses. Wenn Sie ein Ergebnis wieder einblenden (eine Überschreibung der Ausblendung anwenden), kann das Ergebnis durch Ausblendungsregeln erst wieder ausgeblendet werden, wenn Sie die Überschreibung des Ausblendungsstatus manuell entfernt haben.

So entfernen Sie die Ausblendungsüberschreibung für ein einzelnes Ergebnis:

Console

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

    Zu Ergebnissen

  2. Wählen Sie Ihr Google Cloud Projekt oder Ihre Organisation aus.
  3. Klicken Sie rechts neben dem Abschnitt Abfragevorschau auf Abfrage bearbeiten, um den Abfrageeditor zu öffnen.
  4. Ersetzen Sie im Feld Abfrageeditor die vorhandene Ausblendungsanweisung durch Folgendes:
    mute="MUTED" OR mute="UNMUTED"
  5. Klicken Sie auf Übernehmen. Die Ergebnisse im Bereich Ergebnisse der Ergebnisabfrage werden aktualisiert und enthalten jetzt statisch ausgeblendete und eingeblendete Ergebnisse.
  6. Filtern Sie bei Bedarf andere Ergebnisse heraus. Wählen Sie beispielsweise im Bereich Schnellfilter unter Kategorie den Namen des Ergebnisses aus, das Sie zurücksetzen möchten, um alle anderen Ergebniskategorien herauszufiltern.
  7. Wählen Sie das Ergebnis aus, das Sie zurücksetzen möchten. Sie können ein oder mehrere Ergebnisse auswählen.
  8. Klicken Sie in der Aktionsleiste Ergebnisse der Ergebnisabfrage auf Ausblendungsoptionen und wählen Sie dann Ausblendungsüberschreibungen entfernen aus. Das Attribut mute für die ausgewählten Ergebnisse wird auf UNDEFINED gesetzt und das Ergebnis wird aus dem Bereich Ergebnisse der Ergebnisabfrage entfernt. Alternativ können Sie die Stummschaltung eines Ergebnisses über den Detailbereich aufheben:
  9. Klicken Sie auf der Seite Ergebnisse im Bereich Ergebnisse der Ergebnisabfrage in der Spalte Kategorie auf den Namen eines einzelnen Ergebnisses. Der Detailbereich des Ergebnisses wird geöffnet.
  10. Klicken Sie auf Aktiv werden.
  11. Wählen Sie im Menü Maßnahme ergreifen die Option Überschreibungen der Stummschaltung entfernen 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 UNDEFINED zu setzen:

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

    Ersetzen Sie Folgendes:

    • FINDING_ID: die ID des Ergebnisses, das Sie zurücksetzen 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), Groß-/Kleinschreibung beachten

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

    • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert global.

    • SOURCE_ID: die Quell-ID.

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

REST

Verwenden Sie in der Security Command Center API die Methode findings.setMute, um den Ausblendungsstatus eines Ergebnisses zurückzusetzen. Der Anfragetext ist ein Enum, das den resultierenden Ausblendungsstatus angibt:

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

{
  "mute": "UNDEFINED"
}

Ersetzen Sie Folgendes:

  • PARENT: die übergeordnete Ressource (organizations, folders oder projects)
  • PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des übergeordneten Projekts
  • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert global.
  • SOURCE_ID: die numerische ID für die Quelle

Java


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

public class SetMuteUndefinedFinding {

  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}";
    setMuteUndefined(findingPath);
  }

  // Reset mute state of an individual finding.
  // If a finding is already reset, resetting it again has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE/UNDEFINED.
  public static Finding setMuteUndefined(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.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

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

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

Mehrere vorhandene Ergebnisse ausblenden oder zurücksetzen

Sie können die folgenden Bulk-Ausblendungsvorgänge für mehrere vorhandene Ergebnisse entweder mit dem gcloud CLI-Befehl gcloud scc findings bulk-mute oder der Methode bulkMute der Security Command Center API ausführen:

  • Mehrere vorhandene Ergebnisse ausblenden. Wenn Sie vorhandene Ergebnisse im Bulk-Vorgang ausblenden, werden sie statisch ausgeblendet und alle dynamischen Ausblendungsregeln, die für das Ergebnis gelten, werden überschrieben. Wenn Sie ähnliche zukünftige Ergebnisse ausblenden möchten, erstellen Sie eine Ausblendungsregel.

  • Entfernen Sie die Überschreibung des Ausblendungsstatus für mehrere vorhandene Ergebnisse. Wenn Sie die Überschreibung des Ausblendungsstatus für ein Ergebnis entfernen, wird der Ausblendungsstatus von MUTED (statisch ausgeblendet) oder UNMUTED (statisch eingeblendet) auf UNDEFINED zurückgesetzt. Diese Funktion kann nützlich sein, wenn Sie von statischen zu dynamischen Ausblendungsregeln migrieren.

Geben Sie die Ergebnisse an, die Sie ausblenden möchten, 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 Ausblendungs-Regeln.

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

Beispielcode zum Ausblenden von Ergebnissen im Bulk-Vorgang finden Sie unter Ergebnisse im Bulk-Vorgang ausblenden.

Wenn Sie Ergebnisse im Bulk ausblenden oder zurücksetzen möchten, klicken Sie auf den Tab für das gewünschte Verfahren:

Console

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

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 im Bulk auszublenden oder zurückzusetzen:

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

    Ersetzen Sie Folgendes:

    • PARENT: der Bereich in der Ressourcenhierarchie, für den die Ausblendungsregel gilt, organization, folder oder project.
    • PARENT_ID: die numerische ID der übergeordneten Organisation, des übergeordneten Ordners oder des übergeordneten Projekts oder die alphanumerische ID des übergeordneten Projekts.
    • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert global.
    • FILTER: der 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.projectDisplayName=\"internal-test\"" sein.

    • MUTE_STATE: Der Wert, der angibt, ob das Ergebnis statisch ausgeblendet ist oder nicht. Gültige Werte sind MUTED und UNDEFINED. Der Wert ist standardmäßig auf MUTED festgelegt. Legen Sie diesen Wert nur dann auf UNDEFINED fest, wenn Sie den Status „Ausgeblendet“ mehrerer vorhandener Ergebnisse zurücksetzen.

REST

Verwenden Sie in der Security Command Center API die Methode findings.bulkMute, um den Ausblendungsstatus mehrerer vorhandener Ergebnisse auszublenden oder zurückzusetzen. Der Anfragetext enthält den Ausdruck, der zum Filtern von Ergebnissen verwendet wird:

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

{
  "filter": "FILTER",
  "muteState": "MUTE_STATE"
}

Ersetzen Sie Folgendes:

  • PARENT: die übergeordnete Ressource (organizations, folders oder projects).
  • PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des übergeordneten Projekts.
  • LOCATION: Der Security Command Center-Standort, an dem Ergebnisse ausgeblendet oder eingeblendet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Verwenden Sie andernfalls den Wert global.
  • FILTER: der 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.projectDisplayName=\"internal-test\"" sein.

  • MUTE_STATE: Der Wert, der angibt, ob das Ergebnis ausgeblendet ist oder nicht. Gültige Werte sind MUTED und UNDEFINED. Der Wert ist standardmäßig auf MUTED festgelegt. Legen Sie diesen Wert nur auf UNDEFINED fest, wenn Sie den Ausblendungsstatus mehrerer vorhandener Ergebnisse zurücksetzen.

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.

Ausgeblendete Ergebnisse in der Google Cloud Console ansehen

Sie können ausgeblendete Ergebnisse in der Google Cloud -Konsole aufrufen, indem Sie die Abfrage für die Ergebnisse bearbeiten und Ergebnisse mit dem Attributwert mute="MUTED" auswählen.

Mit der folgenden Ergebnisabfrage werden beispielsweise nur aktive Ergebnisse angezeigt, die ausgeblendet sind:

state="ACTIVE"
AND mute="MUTED"

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

state="ACTIVE"

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

Nach Ausblendungsregeltyp ausgeblendete Ergebnisse ansehen

In den folgenden Abschnitten wird beschrieben, wie Sie aktive Ergebnisse nach Typ der Ausblendungsregel abfragen.

Weitere Informationen zum Auflisten bestimmter Ergebnisse finden Sie unter Ergebnisse filtern.

Ergebnisse abfragen, die durch statische Ausblendungsregeln ausgeblendet wurden

Wenn Sie aktive Ergebnisse anzeigen möchten, die nach einer bestimmten Zeit durch eine statische Ausblendungsregel ausgeblendet wurden, verwenden Sie die folgende Abfrage und prüfen Sie das Attribut muteInitiator, um festzustellen, ob das Ergebnis durch eine statische Ausblendungsregel ausgeblendet wurde.

state="ACTIVE" AND
muteInfo.staticMute.applyTime>=TIMESTAMP AND
muteInfo.staticMute.state="MUTED"

Ersetzen Sie TIMESTAMP durch den Datums- und Zeitstring, der den Beginn des Zeitraums angibt, den Sie abfragen möchten. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.

Durch dynamische Ausblendungsregeln ausgeblendete Ergebnisse abfragen

Verwenden Sie die folgende Abfrage, um aktive Ergebnisse anzuzeigen, die nach einer bestimmten Zeit durch eine dynamische Ausblendungsregel ausgeblendet wurden:

state="ACTIVE" AND
muteUpdateTime>=TIMESTAMP AND
contains(muteInfo.dynamicMuteRecords, muteConfig="PARENT_ID/muteConfigs/CONFIG_ID")

Ersetzen Sie Folgendes:

  • TIMESTAMP: der Datums- und Zeitstring, der den Beginn des Zeitraums angibt, den Sie abfragen möchten. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.
  • PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des übergeordneten Projekts im Format organizations/123, folders/456 oder projects/789.
  • CONFIG_ID: der Name der Ausblendungsregel. Die ID muss alphanumerische Zeichen und Bindestriche enthalten und zwischen 1 und 63 Zeichen lang sein.

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

Benachrichtigungen und Exporte ausgeblendeter Ergebnisse beenden

Wenn Sie Ergebnisbenachrichtigungen aktivieren, werden neue oder aktualisierte ausgeblendete Ergebnisse, die Ihren Benachrichtigungsfiltern entsprechen, weiterhin nach Pub/Sub exportiert.

Wenn Sie Exporte und Benachrichtigungen für ausgeblendete Ergebnisse beenden möchten, verwenden Sie das Attribut mute, um ausgeblendete Ergebnisse in Ihrem 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\""