Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Ausblendungsregeln verwalten

In diesem Dokument wird beschrieben, wie Sie Ausblendungsregeln erstellen und verwalten, um Ergebnisse in Security Command Center automatisch auszublenden.

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 Ausblendungsregeln benötigen:

Ausblendungsregeln ansehen:
- Sicherheitscenter-Admin-Betrachter (roles/securitycenter.adminViewer)
- Betrachter für Sicherheitscenter-Einstellungen (roles/securitycenter.settingsViewer)
- Betrachter von Konfigurationen für Ausblendungen im Sicherheitscenter (roles/securitycenter.muteConfigsViewer)
Ausblendungsregeln ansehen, erstellen, aktualisieren und löschen:
- Sicherheitscenter-Administrator (roles/securitycenter.admin)
- Sicherheitscenter-Administratorbearbeiter (roles/securitycenter.adminEditor)
- Bearbeiter von Sicherheitscenter-Einstellungen (roles/securitycenter.settingsEditor)
- Bearbeiter von Konfigurationen für Ausblendungen im Sicherheitscenter (roles/securitycenter.muteConfigsEditor)

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 Ausblendungsregeltypen finden Sie unter Arten von Ausblendungsregeln.

Klicken Sie zum Erstellen einer Ausblendungsregel auf den Tab für die gewünschte Vorgehensweise:

Console

Ausblendungsregel definieren

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

Zu Ergebnissen
Wählen Sie eine Organisation oder ein Projekt aus.
Klicken Sie auf Ausblendungsoptionen und wählen Sie dann Ausblendungsregeln verwalten aus.
Klicken Sie auf Ausblendungsregel erstellen.
Geben Sie eine ID für eine Ausblendungs-Regel ein.
Empfohlen: Geben Sie eine Beschreibung ein, die Kontext dafür liefert, warum Ergebnisse stummgeschaltet werden.
Wenn Sie den Umfang der Ausblendungsregel bestätigen möchten, sehen Sie sich den Wert Übergeordnete Ressource an.

Optional: Ablaufdatum hinzufügen

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

Wählen Sie Übereinstimmende Ergebnisse vorübergehend ausblenden aus.
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 Ausblendungsregel keine Auswirkungen mehr.

Optional: Ausblendungsregel mit einer Abfrage einschränken

Wenn Sie eine Abfrage hinzufügen, wird die Ausblendungsregel nur auf Ergebnisse angewendet, die der Abfrage entsprechen.

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

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

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 Unterattribute wird angezeigt.
Wählen Sie ein Unterattribut aus. Ein Auswahlfeld wird angezeigt, in dem Sie die Abfrageanweisung mit dem ausgewählten Unterattribut, einem Abfrageoperator und einem oder mehreren Werten für das Unterattribut erstellen können.
Wählen Sie im Bereich den Operator und einen oder mehrere Werte für das Unterattribut aus. Weitere Informationen zu Abfrageoperatoren und den Funktionen, die sie verwenden, finden Sie unter Abfrageoperatoren im Menü Filter hinzufügen.

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

Das Menü wird geschlossen und Ihre Abfrage wird aktualisiert.
Wiederholen Sie diesen Vorgang, bis die Ergebnisabfrage alle gewünschten Attribute enthält.

Klicken Sie auf Übereinstimmende Ergebnisse in der Vorschau ansehen, um die Abfrageergebnisse zu prüfen. In einer Tabelle werden Ergebnisse aufgeführt, die Ihrer Anfrage 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 -Console wird eine Liste Ihrer Ausblendungsregeln angezeigt.

gcloud

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.
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: Security Command Center-Standort, an dem Ausblendungsregeln 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 Ausblendungs-Regel, 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. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes. Wenn eine dynamische Ausblendungsregel abläuft, wird sie aus allen übereinstimmenden Ergebnissen entfernt. Wenn die dynamische Ausblendungsregel unbegrenzt auf übereinstimmende Ergebnisse angewendet werden soll, lassen Sie dieses Feld weg.
Die Antwort enthält die ID der Ausblendungsregel, mit der Sie Ausblendungsregeln aufrufen, aktualisieren und löschen können, wie unter Ausblendungsregeln 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());
    }
  }
}

Python

def create_mute_rule(parent_path: str, location_id: str, mute_config_id: str) -> Dict:
    """
    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}
        location_id: Gcp location id; example: 'global'
        mute_config_id: Set a unique id; max of 63 chars.
    Returns:
        Dict: returns the mute rule details
    """

    from google.cloud import securitycenter_v2

    client = securitycenter_v2.SecurityCenterClient()

    mute_config = securitycenter_v2.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"'
    )
    mute_config.type = "STATIC"

    request = securitycenter_v2.CreateMuteConfigRequest()
    request.parent = parent_path + "/locations/" + location_id
    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}")
    return mute_config

REST

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

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

  {
    "description": "RULE_DESCRIPTION",
    "filter": "FILTER",
    "type": "MUTE_TYPE",
    "expiryTime": "TIMESTAMP"
  }

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 übergeordneten Projekts
LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert global.
MUTE_CONFIG_ID: der Name der Ausblendungsregel (zwischen 1 und 63 Zeichen)
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.
MUTE_TYPE: Der Typ der Ausblendungs-Regel, die Sie erstellen möchten. Gültige Typen für Ausblendungsregeln sind DYNAMIC und STATIC. Sie können den Typ einer Ausblendungsregel nach dem Erstellen nicht mehr ändern.
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. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes. Wenn eine dynamische Ausblendungsregel abläuft, wird sie aus allen übereinstimmenden Ergebnissen entfernt. Wenn die dynamische Ausblendungsregel unbegrenzt auf übereinstimmende Ergebnisse angewendet werden soll, lassen Sie dieses Feld weg.

Die Antwort enthält die ID der Ausblendungs-Konfiguration, mit der Sie Ausblendungsregeln aufrufen, aktualisieren und löschen können, wie unter Ausblendungsregeln 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 Ausblendungs-Regeln

Nicht alle Ergebnisattribute in Filtern werden von Ausblendungs-Regeln unterstützt. Maximieren Sie den folgenden Abschnitt, um die Liste der Attribute aufzurufen, die in Filtern für Ausblendungs-Regeln nicht unterstützt werden.

Nicht unterstützte Eigenschaften für Ergebnisse

caiResource
canonicalName
createTime
description
eventTime
externalUri
gcpMetadata.folders¹
libraryPaths
mute
muteAnnotation
muteInfo
muteInitiator
muteUpdateTime
name
nextSteps
originalProviderId
parent
processes.binaryPath
processes.libraryPaths
propertyDataTypes
resource.tags
resourceName
securityMarks
sourceProperties
state
workflowState

¹ Die Property gcpMetadata.folders enthält Unterfelder, die in Stummschaltungsfiltern unterstützt werden.

Ausblendungs-Regeln auflisten

Sie können die Ausblendungsregeln in einer Organisation, einem Ordner oder einem Projekt mit der Google Cloud Console, der gcloud CLI oder der 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 Befehls „list“ auch auf den ausgewählten Security Command Center-Standort beschränkt.

Beispielcode zum Auflisten von Ausblendungsregeln finden Sie unter Ausblendungsregeln auflisten.

Klicken Sie auf den Tab für die gewünschte Methode, um die Ausblendungsregeln für eine Organisation, einen Ordner oder ein Projekt aufzulisten:

Console

Rufen Sie in der Google Cloud Console auf der Seite Einstellungen des Security Command Center den Tab Ausblendungsregeln auf.
Zu den Ausblendungsregeln
Wählen Sie bei Bedarf Ihr Google Cloud Projekt oder Ihre Organisation aus.
Im Abschnitt Ausblendungsregeln finden Sie Details zu aktiven Ausblendungsregeln, darunter:
- 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

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.
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: Das übergeordnete organization, folder oder project, für das Ausblendungsregeln aufgeführt werden sollen
- PARENT_ID: die ID der übergeordneten Organisation, des übergeordneten Ordners oder des übergeordneten Projekts
- LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert global.

Go

import (
	"context"
	"fmt"
	"io"

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


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

public class ListMuteRules {

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

    // Specify the location to list mute configs.
    String location = "global";

    listMuteRules(projectId, location);
  }

  // Lists all mute rules present under the resource type in the given location.
  public static void listMuteRules(String projectId, String location) 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()) {

      // Parent can also be one of:
      //  * "organizations/{org_id}/locations/{location}"
      //  * "folders/{folder_id}/locations/{location}"
      ListMuteConfigsRequest listMuteConfigsRequest = ListMuteConfigsRequest.newBuilder()
          .setParent(String.format("projects/%s/locations/%s", projectId, location))
          .build();

      // List all mute configs present in the resource.
      for (MuteConfig muteConfig : client.listMuteConfigs(listMuteConfigsRequest).iterateAll()) {
        System.out.println(muteConfig.getName());
      }
    }
  }
}

Python

def list_mute_rules(parent: str, location_id: str) -> Dict:
    """
    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}
        location_id: Gcp location id; example: 'global'
    Returns:
         Dict: returns the mute rule details
    """
    from google.cloud import securitycenter_v2

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.ListMuteConfigsRequest()
    request.parent = parent + "/locations/" + location_id
    response = client.list_mute_configs(request)
    # List all Mute Configs present in the resource.
    for mute_config in response:
        print(mute_config.name)
    return response

REST

Verwenden Sie in der Security Command Center API die Methode muteConfigs.list, um Ausblendungsregeln aufzulisten:

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 übergeordneten Projekts
LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert 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 einer Ausblendungsregelkonfiguration finden Sie unter Ausblendungsregel aufrufen.

Klicken Sie auf den Tab für die gewünschte Vorgehensweise, um die Konfiguration einer Ausblendungsregel aufzurufen:

Console

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

Zu den Ausblendungsregeln
Wählen Sie bei Bedarf Ihr Google Cloud Projekt oder Ihre Organisation aus.
Im Abschnitt Ausblendungsregeln sehen Sie eine Liste der Ausblendungsregeln.
Klicken Sie auf den Namen der Regel, die Sie aufrufen möchten.

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

gcloud

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.
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 der Ausblendungsregel
- PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organization, folder oder project)
- PARENT_ID: die ID der Organisation, des Ordners oder des Projekts
- LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert global.

Go

import (
	"context"
	"fmt"
	"io"

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


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

public class GetMuteRule {

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

    // Specify the location of the mute config. If the mute config was
    // created with v1 API, it can be accessed with "global".
    String location = "global";

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

    getMuteRule(projectId, location, muteConfigId);
  }

  // Retrieves a mute configuration given its resource name.
  public static MuteConfig getMuteRule(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()) {
      // Use appropriate `MuteConfigName` methods depending on the parent type.
      //  * organization -> MuteConfigName.ofOrganizationLocationMuteConfigName()
      //  * folder -> MuteConfigName.ofFolderLocationMuteConfigName()

      MuteConfigName muteConfigName = MuteConfigName.ofProjectLocationMuteConfigName(projectId,
          location, muteConfigId);
      return client.getMuteConfig(muteConfigName);
    }
  }
}

Python

def get_mute_rule(parent_path: str, location_id: str, mute_config_id: str) -> Dict:
    """
    Retrieves a mute configuration given its resource name.
    Args:
        parent_path: use any one of the following options:
                     - organizations/{organization_id}
                     - folders/{folder_id}
                     - projects/{project_id}
        location_id: Gcp location id; example: 'global'
        mute_config_id: Set a unique id; max of 63 chars.
    Returns:
         Dict: returns the mute rule details
    """
    from google.cloud import securitycenter_v2

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.GetMuteConfigRequest()
    request.name = (
        parent_path + "/locations/" + location_id + "/muteConfigs/" + mute_config_id
    )

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

REST

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

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: die ID der Organisation, des Ordners oder des Projekts
LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert global.
CONFIG_ID: Die numerische ID der Ausblendungs-Regel

Ausblendungs-Regeln aktualisieren

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

Sie können die ID, die übergeordnete Organisation, den übergeordneten Ordner oder das übergeordnete Projekt sowie den Standort 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 Einzelne Ergebnisse wieder einblenden.

Beispielcode zum Aktualisieren einer Ausblendungsregel finden Sie unter Ausblendungsregel aktualisieren.

Klicken Sie zum Aktualisieren einer Ausblendungsregel auf den Tab für die gewünschte Vorgehensweise:

Console

Rufen Sie in der Google Cloud Console auf der Seite Einstellungen des Security Command Center den Tab Ausblendungsregeln auf.
Zu den Ausblendungsregeln
Wählen Sie das Google Cloud Projekt oder die Organisation aus, das bzw. die die übergeordnete Ressource für die Ausblendungsregel ist, die Sie ändern möchten.
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.
Nehmen Sie Änderungen an der Ausblendungsregel vor.
Optional: Nachdem Sie den Filter aktualisiert haben, klicken Sie auf Übereinstimmende Ergebnisse in der Vorschau ansehen, um Ergebnisse aufzurufen, die dem aktualisierten Filter entsprechen. Eine Tabelle mit Ergebnissen, die der neuen Abfrage entsprechen, wird geladen.
Klicken Sie auf Speichern.

gcloud

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.
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 \
    --type=MUTE_TYPE \
    --expiry-time=TIMESTAMP
```
Ersetzen Sie Folgendes:
- MUTE_CONFIG_ID: Die ID der Ausblendungsregel.
- PARENT: Die übergeordnete Ressource für Ihre Ausblendungsregel (organization, folder oder project).
- PARENT_ID: die ID für die Organisation, den Ordner oder das Projekt.
- LOCATION: Security Command Center-Standort, an dem Ausblendungsregeln 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 (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 FILTER="category=\"OPEN_FIREWALL\"" sein.
- MUTE_TYPE: Der Typ der Ausblendungsregel, die Sie aktualisieren. Gültige Typen für Ausblendungsregeln sind DYNAMIC und STATIC. Sie können den Typ einer Ausblendungsregel nicht mehr ändern, nachdem Sie sie erstellt haben.
- TIMESTAMP: Gilt nur, wenn Sie eine dynamische Ausblendungsregel aktualisieren. 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. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes. Wenn eine dynamische Ausblendungsregel abläuft, wird sie aus allen übereinstimmenden Ergebnissen entfernt. Wenn die dynamische Ausblendungsregel unbegrenzt auf übereinstimmende Ergebnisse angewendet werden soll, lassen Sie dieses Feld weg.

Go


import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv2"
	"cloud.google.com/go/securitycenter/apiv2/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! %w", err)
	}
	fmt.Fprintf(w, "Mute rule updated %s", response.Name)
	return nil
}

Java


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

public class UpdateMuteRule {

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

    // Specify the location of the mute config to update. If the mute config was
    // created with v1 API, it can be accessed with "global".
    String location = "global";

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

    updateMuteRule(projectId, location, muteConfigId);
  }

  // Updates an existing mute configuration.
  // The following can be updated in a mute config: description and filter.
  public static void updateMuteRule(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 securityCenterClient = SecurityCenterClient.create()) {

      MuteConfig updateMuteConfig =
          MuteConfig.newBuilder()
              // Construct the name according to the parent type of the mute rule.
              // Parent can also be one of:
              //  * "organizations/{org_id}/locations/{location}/muteConfigs/{muteConfig_id}"
              //  * "folders/{folder_id}/locations/{location}/muteConfigs/{muteConfig_id}"
              .setName(String.format("projects/%s/locations/%s/muteConfigs/%s", projectId, location,
                  muteConfigId))
              .setDescription("Updated mute config description")
              .build();

      UpdateMuteConfigRequest updateMuteConfigRequest =
          UpdateMuteConfigRequest.newBuilder()
              .setMuteConfig(updateMuteConfig)
              // Make sure that the mask fields match the properties changed in
              // 'updateMuteConfig' object.
              // For more info on constructing update mask path, see the proto or:
              // https://cloud.google.com/security-command-center/docs/reference/rest/v2/folders.muteConfigs/patch?hl=en#query-parameters
              .setUpdateMask(FieldMask.newBuilder().addPaths("description").build())
              .build();

      MuteConfig response = securityCenterClient.updateMuteConfig(updateMuteConfigRequest);
      System.out.println(response);
    }
  }
}

Python

def update_mute_rule(parent_path: str, location_id: str, mute_config_id: str) -> Dict:
    """
    Updates an existing mute configuration.
    The following can be updated in a mute config: description, and filter/ mute rule.
    Args:
        parent: Use any one of the following resource paths to list mute configurations:
                - organizations/{organization_id}
                - folders/{folder_id}
                - projects/{project_id}
        location_id: Gcp location id; example: 'global'
        mute_config_id: Set a unique id; max of 63 chars.
    Returns:
         Dict: returns the mute rule details
    """
    from google.cloud import securitycenter_v2
    from google.protobuf import field_mask_pb2

    client = securitycenter_v2.SecurityCenterClient()

    update_mute_config = securitycenter_v2.MuteConfig()
    update_mute_config.name = (
        parent_path + "/locations/" + location_id + "/muteConfigs/" + mute_config_id
    )
    update_mute_config.description = "Updated mute config description"

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

    request = securitycenter_v2.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}")
    return mute_config

REST

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

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

  {
    "description": "RULE_DESCRIPTION",
    "filter": "FILTER",
    "type": "MUTE_TYPE",
    "expiryTime": "TIMESTAMP"
  }

Ersetzen Sie Folgendes:

PARENT: die übergeordnete Ressource für Ihre Ausblendungsregel (organizations, folders oder projects)
PARENT_ID: die ID der Organisation, des Ordners oder des Projekts
LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert 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
MUTE_TYPE: Der Typ der Ausblendungsregel, die Sie aktualisieren. Gültige Typen für Ausblendungsregeln sind DYNAMIC und STATIC. Sie können den Typ einer Ausblendungsregel nicht mehr ändern, nachdem Sie sie erstellt haben.
TIMESTAMP: Gilt nur, wenn Sie eine dynamische Ausblendungsregel aktualisieren. 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. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes. Wenn eine dynamische Ausblendungsregel abläuft, wird sie aus allen übereinstimmenden Ergebnissen entfernt. Wenn die dynamische Ausblendungsregel unbegrenzt auf übereinstimmende Ergebnisse angewendet werden soll, lassen Sie dieses Feld weg.

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.
Wenn Sie statische Ausblendungsregeln löschen, werden dadurch nicht automatisch Ergebnisse wieder eingeblendet, die ausgeblendet sind. Sie müssen Ergebnisse manuell oder programmatisch reaktivieren.
Wenn Sie dynamische Ausblendungsregeln löschen, werden sie automatisch aus allen zuvor übereinstimmenden Ergebnissen entfernt und die Ergebnisse werden wieder eingeblendet, sofern sie nicht mit anderen Regeln übereinstimmen.
Zukünftige Ergebnisse, die mit Filtern in gelöschten Ausblendungsregeln übereinstimmen, werden nicht ausgeblendet.

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

Wenn Sie eine Ausblendungsregel löschen möchten, klicken Sie auf den Tab für die gewünschte Methode:

Console

Rufen Sie in der Google Cloud Console auf der Seite Einstellungen des Security Command Center den Tab Ausblendungsregeln auf.
Zu den Ausblendungsregeln
Wählen Sie bei Bedarf Ihr Google Cloud Projekt oder Ihre Organisation aus.
Klicken Sie auf den Namen der Ausblendungsregel, die Sie löschen möchten.
Klicken Sie auf Löschen.
Lesen Sie das Dialogfeld und klicken Sie, wenn Sie zufrieden sind, auf Löschen.

gcloud

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.
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: die ID der Organisation, des Ordners oder des Projekts
- LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert global.
Bestätigen Sie Ihre Anfrage zum Löschen der Ausblendungsregel.

Go


import (
	"context"
	"fmt"
	"io"

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


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

public class DeleteMuteRule {

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

    // Specify the location of the mute config. If the mute config was
    // created with v1 API, it can be accessed with "global".
    String location = "global";

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

    deleteMuteRule(projectId, location, 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 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()) {
      // Use appropriate `MuteConfigName` methods depending on the parent type.
      // folder -> MuteConfigName.ofFolderLocationMuteConfigName()
      // organization -> MuteConfigName.ofOrganizationLocationMuteConfigName()
      client.deleteMuteConfig(
          MuteConfigName.ofProjectLocationMuteConfigName(projectId, location, muteConfigId));

      System.out.println("Mute rule deleted successfully: " + muteConfigId);
    }
  }
}

Python

def delete_mute_rule(parent_path: str, location_id: str, mute_config_id: str) -> None:
    """
    Deletes a mute configuration given its resource name.
    Note: Previously muted findings are not affected when a mute config is deleted.
    Args:
         parent_path: use any one of the following options:
                     - organizations/{organization_id}
                     - folders/{folder_id}
                     - projects/{project_id}
        location_id: Gcp location id; example: 'global'
        mute_config_id: Set a unique id; max of 63 chars.
    Returns:
         None: returns none mute rule is deleted
    """
    from google.cloud import securitycenter_v2

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.DeleteMuteConfigRequest()
    request.name = (
        parent_path + "/locations/" + location_id + "/muteConfigs/" + mute_config_id
    )

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

REST

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

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: die ID der Organisation, des Ordners oder des Projekts
LOCATION: Der Security Command Center-Standort, an dem Ausblendungsregeln verwaltet werden sollen. Wenn der Datenstandort aktiviert ist, verwenden Sie eu, sa oder us. Andernfalls verwenden Sie den Wert global.
CONFIG_ID: Die numerische ID der Ausblendungs-Regel

Ausblendungsregeln verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Erforderliche Rollen

Ausblendungsregel erstellen

Console

Ausblendungsregel definieren

Optional: Ablaufdatum hinzufügen

Optional: Ausblendungsregel mit einer Abfrage einschränken

Ausblendungsregel speichern

gcloud

Terraform

Go

Java

Python

REST

Nicht unterstützte Ergebnisattribute für Ausblendungs-Regeln

Nicht unterstützte Eigenschaften für Ergebnisse

Ausblendungs-Regeln auflisten

Console

gcloud

Go

Java

Python

REST

Konfiguration einer Ausblendungsregel ansehen

Console

gcloud

Go

Java

Python

REST

Ausblendungs-Regeln aktualisieren

Console

gcloud

Go

Java

Python

REST

Ausblendungs-Regeln löschen

Console

gcloud

Go

Java

Python

REST

Ausblendungsregeln verwalten