Ausblendungsregeln verwalten

In diesem Dokument wird beschrieben, wie Sie Regeln zum Stummschalten erstellen und verwalten, um Ergebnisse in Security Command Center automatisch stummzuschalten.

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 Verwalten von Stummschaltungsregeln 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.

Ausblendungsregel erstellen

Ihre Organisation kann maximal 1.000 Ausblendungsregeln erstellen.

Wir empfehlen, ausschließlich dynamische Ausblendungsregeln in Ihren Ausblendungsregelkonfigurationen zu verwenden, da sie flexibler als statische Ausblendungsregeln sind. Einen Vergleich der verschiedenen Arten von Ausblendungsregeln finden Sie unter Arten von Ausblendungsregeln.

So erstellen Sie eine Ausblendungsregel:

Console

Ausblendungsregel definieren

  1. Rufen Sie in der Google Cloud Console die Seite Ergebnisse auf.

    Zu Ergebnissen

  2. Wählen Sie eine Organisation oder ein Projekt aus.

  3. Klicken Sie auf Ausblendungs-Optionen und wählen Sie dann Ausblenden-Regeln verwalten aus.

  4. Klicken Sie auf Ausblendungsregel erstellen.

  5. Geben Sie eine ID für eine Ausblendungs-Regel ein.

  6. Empfohlen: Geben Sie eine Beschreibung ein, die den Kontext dafür enthält, warum die Ergebnisse ausgeblendet werden.

  7. Prüfen Sie den Wert Übergeordnete Ressource, um den Umfang der Ausblendungsregel zu bestätigen.

Optional: Ablaufdatum hinzufügen

Sie können dynamischen Ausblendungsregeln ein Ablaufdatum hinzufügen.

  1. Wählen Sie Übereinstimmende Ergebnisse vorübergehend ausblenden aus.
  2. Wenn Sie das Ablaufdatum für die dynamische Ausblendungsregel konfigurieren möchten, wählen Sie den Kalender aus und legen Sie ein Datum und eine Uhrzeit fest, die mindestens 24 Stunden in der Zukunft liegen.

    Nach dem Ablaufdatum hat die Stummschaltungsregel keine Auswirkungen mehr.

Optional: Ausblendungsregel mit einer Abfrage einschränken

Wenn Sie eine Abfrage hinzufügen, gilt die Ausblendungsregel nur für Ergebnisse, die mit der Abfrage übereinstimmen.

Wenn Sie die Ausblendungsregel mit einer Abfrage einschränken möchten, klicken Sie im Bereich Abfrage für Ergebnisse auf  Filter hinzufügen.

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

  1. Wählen Sie im Menü Filter auswählen ein Ergebnisattribut aus oder geben Sie seinen Namen in das Feld Ergebnisattribute suchen ein. Eine Liste der verfügbaren untergeordneten Attribute wird angezeigt.
  2. Wählen Sie ein Unterattribut aus. In einem Auswahlfeld können Sie die Abfrageanweisung mit dem ausgewählten Unterattribut, einem Abfrageoperator und einem oder mehreren Werten für das Unterattribut erstellen.
  3. Wählen Sie im Bereich den Operator und einen oder mehrere Werte für das Unterattribut aus. Weitere Informationen zu Abfrageoperatoren und den zugehörigen Funktionen finden Sie unter Abfrageoperatoren im Menü Filter hinzufügen.

    Wenn Sie von vorn beginnen möchten, klicken Sie auf Zurücksetzen.

  4. Klicken Sie auf Übernehmen.

    Das Menü wird geschlossen und Ihre Abfrage wird aktualisiert.

  5. Wiederholen Sie diesen Vorgang, bis die Ergebnisabfrage alle gewünschten Attribute enthält.
Klicken Sie auf Vorschau der übereinstimmenden Ergebnisse anzeigen, um die Abfrageergebnisse zu prüfen. In einer Tabelle werden Ergebnisse aufgeführt, die Ihrer Abfrage entsprechen.

Wenn die Abfrage nicht mit den richtigen Ergebnissen übereinstimmt, überarbeiten Sie sie nach Bedarf und sehen Sie sich die Ergebnisse noch einmal in der Vorschau an. Wiederholen Sie diesen Schritt, bis Sie mit den Ergebnissen zufrieden sind.

Ausblendungsregel speichern

Klicken Sie auf Speichern. In der Google Cloud -Konsole wird eine Liste Ihrer Ausblendungsregeln angezeigt.

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 gcloud scc muteconfigs create-Befehl aus, um Ausblendungsregeln zu erstellen:

    gcloud scc muteconfigs create CONFIG_ID \
      --PARENT=PARENT_ID \
      --location=LOCATION \
      --description="RULE_DESCRIPTION" \
      --filter="FILTER" \
      --type=MUTE_TYPE \
      --expiry-time=TIMESTAMP

    Ersetzen Sie Folgendes:

    • CONFIG_ID: Der Name der Ausblendungsregel. Die ID muss alphanumerische Zeichen und Bindestriche enthalten und zwischen 1 und 63 Zeichen lang sein.
    • PARENT: Der Bereich in der Ressourcenhierarchie, auf den die Ausblendungsregel angewendet wird: 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 Stummschaltungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert global.
    • RULE_DESCRIPTION: eine Beschreibung der Ausblendungsregel mit maximal 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 FILTER="category=\"OPEN_FIREWALL\"" sein.
    • MUTE_TYPE: Der Typ der Ausblendungsregel, die Sie erstellen möchten. Gültige Typen für Ausblendungsregeln sind DYNAMIC und STATIC. Der Typ der Ausblendungsregel ist standardmäßig auf STATIC festgelegt. Der Typ einer Ausblendungsregel kann nach dem Erstellen nicht mehr geändert werden.
    • TIMESTAMP: Gilt nur, wenn Sie eine dynamische Ausblendungsregel erstellen. Der Datums- und Zeitstring, der angibt, wann die dynamische Ausblendungsregel abläuft. Der Wert muss auf mindestens einen Tag in der Zukunft festgelegt werden, da die Anfrage sonst abgelehnt wird. Weitere Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes. Wenn eine dynamische Stummschaltungsregel abläuft, wird sie aus allen übereinstimmenden Ergebnissen entfernt. Wenn die dynamische Ausblendungsregel unbefristet auf übereinstimmende Ergebnisse angewendet werden soll, lassen Sie dieses Feld weg.

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

Terraform

So erstellen Sie eine Ausblendungsregel für eine Organisation:

resource "google_scc_v2_organization_mute_config" "default" {
  mute_config_id    = "my-config"
  organization = "123456789"
  location     = "global"
  description  = "My custom Cloud Security Command Center Finding Organization mute Configuration"
  filter = "severity = \"HIGH\""
  type = "STATIC"
}

So erstellen Sie eine Ausblendungsregel für einen Ordner:

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

resource "google_scc_v2_folder_mute_config" "default" {
  mute_config_id    = "my-config"
  folder = google_folder.folder.folder_id
  location     = "global"
  description  = "My custom Cloud Security Command Center Finding Folder mute Configuration"
  filter = "severity = \"HIGH\""
  type = "STATIC"
}

So erstellen Sie eine Ausblendungsregel für ein Projekt:

resource "google_scc_v2_project_mute_config" "default" {
  mute_config_id    = "my-config"
  project = "my-project-name"
  location     = "global"
  description  = "My custom Cloud Security Command Center Finding Project mute Configuration"
  filter = "severity = \"HIGH\""
  type = "STATIC"
}

Go


import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv2"
	"cloud.google.com/go/securitycenter/apiv2/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\"",
		Type: securitycenterpb.MuteConfig_STATIC,
	}

	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


import com.google.cloud.securitycenter.v2.LocationName;
import com.google.cloud.securitycenter.v2.MuteConfig;
import com.google.cloud.securitycenter.v2.MuteConfig.MuteConfigType;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import java.io.IOException;
import java.util.UUID;

public class CreateMuteRule {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the following variables.
    // projectId: Google Cloud Project id.
    String projectId = "google-cloud-project-id";

    // Specify the location of the mute config.
    String location = "global";

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

    createMuteRule(projectId, location, muteConfigId);
  }

  // Creates a mute configuration in a project under a given location.
  public static void createMuteRule(String projectId, String location, String muteConfigId)
      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()) {

      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\"")
              .setType(MuteConfigType.STATIC)
              .build();

      // You can also create mute rules in an organization/ folder.
      // Construct the parameters according to the parent resource.
      //  * Organization -> client.createMuteConfig(OrganizationLocationName.of(...
      //  * Folder -> client.createMuteConfig(FolderLocationName.of(...
      MuteConfig response = client.createMuteConfig(
          LocationName.of(projectId, location), muteConfig, muteConfigId);
      System.out.println("Mute rule created successfully: " + response.getName