Disattivazione dei risultati in Security Command Center

Questa pagina spiega come ridurre il volume dei risultati che ricevi in Security Command Center disattivando i risultati.

La disattivazione di un risultato lo nasconde dalla visualizzazione predefinita dei risultati nella nella console Google Cloud. Puoi disattivare manualmente o tramite programmazione i risultati e creare filtri per disattivare automaticamente i risultati esistenti e futuri in base ai criteri specificati.

I servizi di rilevamento di Security Command Center forniscono ampie valutazioni di sicurezza del deployment di Google Cloud, ma potresti scoprire che alcuni risultati appropriati o pertinenti per la tua organizzazione o i tuoi progetti. Un volume elevato di possono inoltre rendere difficoltoso per gli analisti della sicurezza identificare e correggere i rischi più critici. La disattivazione dei risultati ti consente di risparmiare tempo per esaminare o rispondere ai risultati relativi alla sicurezza per gli asset isolati o che rientrano nei parametri aziendali accettabili.

La disattivazione dei risultati ha diversi vantaggi rispetto Disattivazione dei rilevatori:

  • Puoi creare filtri personalizzati per ottimizzare i risultati disattivati.
  • Puoi utilizzare le regole di disattivazione per disattivare temporaneamente o indefinitamente i risultati.
  • La disattivazione dei risultati non impedisce l'analisi degli asset sottostanti. I risultati vengono comunque generati, ma rimangono nascosti finché non decidi di visualizzarli.

Autorizzazioni

Per disattivare i risultati, devi disporre di uno dei seguenti sistemi IAM (Identity and Access Management) Ruoli a livello di organizzazione, cartella o progetto:

  • Visualizza le regole di disattivazione:
    • Visualizzatore amministratore Centro sicurezza (roles/securitycenter.adminViewer)
    • Visualizzatore impostazioni Centro sicurezza (roles/securitycenter.settingsViewer)
    • Security Center Mute Configurations Viewer (roles/securitycenter.muteConfigsViewer)
  • Visualizza, crea, aggiorna ed elimina le regole di disattivazione:
    • Amministratore Centro sicurezza (roles/securitycenter.admin)
    • Editor amministratore Centro sicurezza (roles/securitycenter.adminEditor)
    • Security Center Settings Editor (roles/securitycenter.settingsEditor)
    • Editor configurazioni di disattivazione del Centro sicurezza (roles/securitycenter.muteConfigsEditor)
  • Disattiva manualmente i risultati:
    • Editor risultati Centro sicurezza (roles/securitycenter.findingsEditor)

Puoi anche creare e concedere ruoli personalizzati con alcune o tutte le seguenti autorizzazioni:

  • Autorizzazioni di lettura delle regole di disattivazione
    • securitycenter.muteconfigs.get
    • securitycenter.muteconfigs.list
  • Autorizzazioni di scrittura per le regole di disattivazione
    • securitycenter.muteconfigs.create
    • securitycenter.muteconfigs.update
    • securitycenter.muteconfigs.delete
  • Trovare le autorizzazioni di scrittura
    • securitycenter.findings.setMute
    • securitycenter.findings.bulkMuteUpdate

La tua capacità di disattivare i risultati è conforme ai ruoli concessi a livello di organizzazione, cartella o progetto. Puoi disattivare i risultati in cartelle specifiche progetti e limita la possibilità di altri di disattivare i risultati in base all'accesso concesso. Per Ad esempio, se hai accesso a un singolo progetto, puoi disattivare i risultati quel progetto. Se hai accesso a una cartella, puoi disattivare i risultati in qualsiasi sottocartella o progetto al suo interno.

Per scoprire di più sui ruoli di Security Command Center, consulta Controllo degli accessi.

Creare e gestire le regole di disattivazione

Le regole di disattivazione sono configurazioni di Security Command Center che utilizzano i filtri che crei disattivare automaticamente i risultati futuri ed esistenti in base ai criteri da te specificati. Puoi creare filtri con regole di disattivazione statiche o dinamiche.

Le regole di disattivazione statica disattivano a tempo indeterminato i risultati futuri. Disattivazione dinamica le regole disattivano temporaneamente i risultati futuri ed esistenti fino a una data specificata o a tempo indeterminato, finché un risultato non corrisponde più alla configurazione.

Tipi di regole di disattivazione

Security Command Center supporta configurazioni di regole di disattivazione statiche e dinamiche. Sebbene puoi utilizzare regole di disattivazione statiche e dinamiche contemporaneamente, ma sconsigliamo di farlo. Le regole di disattivazione statica sostituiscono le regole di disattivazione dinamica quando vengono applicate alla stessa ricerca. Di conseguenza, le regole di disattivazione dinamica non funzioneranno come previsto, il che può creare confusione durante la gestione dei risultati. Pertanto, ti consigliamo utilizzare in modo esclusivo un tipo di regola di disattivazione.

A meno che tu non stia già utilizzando regole di disattivazione statica, ti consigliamo di usare la disattivazione dinamica esclusivamente perché offrono una maggiore flessibilità.

La tabella riportata di seguito offre un confronto di alto livello tra i due tipi di regole di disattivazione. Per maggiori dettagli, consulta Regole di disattivazione statica e Dinamici. di disattivazione delle regole.

Regole di disattivazione statica Regole di disattivazione dinamica
Agisci sempre sulla base dei risultati. Può intervenire su un risultato temporaneamente con un'ora di scadenza o indefinitamente se non è impostata un'ora di scadenza.
Non si applica ai risultati esistenti. Applica a risultati nuovi ed esistenti.
Hanno la precedenza sulle regole di disattivazione dinamica. Sono hanno una priorità più bassa e vengono sostituite da regole di disattivazione statiche quando si applicano a un risultato.

Regole di disattivazione statiche

  • Le regole di disattivazione statiche vengono applicate a tempo indeterminato. Quando un risultato corrisponde alla tua configurazione di disattivazione audio statica, Security Command Center imposta automaticamente la proprietà mute del risultato su MUTED finché non la modifichi manualmente.
  • Le regole di disattivazione statiche non hanno alcun effetto sui risultati esistenti. Si applicano solo a i risultati appena creati o aggiornati dopo la definizione della regola. Se vuoi anche disattivare i risultati esistenti simili, utilizza gli stessi filtri per disattivare collettivamente i risultati.
  • Le regole di disattivazione statiche hanno la precedenza sulle regole di disattivazione dinamiche. Di conseguenza, tutti i nuovi i risultati che corrispondono a una regola di disattivazione statica definita vengono considerati disattivati anche se corrispondono anche a una regola di disattivazione dinamica definita.

Regole di disattivazione dinamica

  • Le regole di disattivazione dinamica possono agire su un risultato temporaneamente con un'ora di scadenza o a tempo indeterminato se non è impostata un'ora di scadenza. Quando una nuova istanza il risultato creato corrisponde alla tua configurazione di disattivazione dinamica, Security Command Center imposta automaticamente la proprietà mute del risultato su MUTED finché data di scadenza specificata o finché non ci sono modifiche nel risultato o configurazione. Quando una regola di disattivazione dinamica scade, Security Command Centerrimuove la regola dal risultato. Se il risultato non corrisponde ad altre regole di disattivazione dinamica, la proprietà mute viene reimpostata automaticamente su UNDEFINED.
  • Le regole di disattivazione dinamica vengono applicate automaticamente ai risultati esistenti che corrispondono alla tua configurazione, nonché ai risultati appena creati o aggiornati.
  • Le regole di disattivazione dinamica hanno una priorità inferiore e vengono sostituite dalle regole di disattivazione statica quando entrambi i tipi si applicano a un rilevamento.

Ti consigliamo di utilizzare esclusivamente regole di disattivazione dinamica. La possibilità di l'attivazione e la disattivazione automatica dei risultati rendono le regole di disattivazione dinamica più flessibili rispetto alle regole di disattivazione statiche.

Se utilizzi regole di disattivazione statiche per ridurre il numero di risultati che revisione manuale e vuoi eseguire la migrazione alle regole di disattivazione dinamica, consulta Eseguire da disattivazione audio statica a dinamica .

Ambito delle regole di disattivazione

Tieni conto dell'ambito di una regola di disattivazione quando crei i filtri.

Ad esempio, se un filtro viene scritto per disattivare i risultati in Project A, ma il filtro stesso viene creato in Project B, il filtro potrebbe non corrispondere a nessun risultato.

Analogamente, se la residenza dei dati l'ambito di una regola di disattivazione è limitato alla località di Security Command Center in cui la regola di disattivazione è è stato creato. Ad esempio, se crei una regola di disattivazione nella località Stati Uniti (us), la regola di disattivazione non disattiva i risultati archiviati nelle località Unione Europea (eu) o Globale (global). Per ulteriori informazioni sulla residenza dei dati e sulle regole di disattivazione, consulta Regole di disattivazione, esportazioni continue e residenza dei dati.

Per scoprire di più sulla creazione dei filtri, consulta Filtrare le notifiche.

Limitazioni delle regole di disattivazione

Le regole di disattivazione non supportano tutte le proprietà dei risultati. Per un elenco delle proprietà non supportate dalle regole di disattivazione, consulta Proprietà di ricerca non supportate per le regole di disattivazione.

Puoi creare, visualizzare, aggiornare ed eliminare le regole di disattivazione in base all'ambito dei tuoi ruoli IAM. Con i ruoli a livello di organizzazione, vengono visualizzate le regole di disattivazione per tutte le cartelle e tutti i progetti all'interno dell'organizzazione. Se l'applicazione è a livello di cartella, ruoli, puoi accedere e gestire le regole di disattivazione per cartelle specifiche e tutti sottocartelle e progetti all'interno di quelle cartelle. I ruoli a livello di progetto di disattivare le regole in progetti specifici.

Security Command Center Premium supporta la concessione dei ruoli a livello di organizzazione, cartella a livello di progetto e di progetto. Security Command Center Standard supporta la concessione di ruoli solo a livello di organizzazione. Per ulteriori informazioni, consulta Controllo dell'accesso.

Localizzazione dei dati e regole di disattivazione

Se la residente dei dati è abilitata, configurazioni che definiscono le regole di disattivazione (muteConfig risorse) soggetti a controllo della residenza dei dati e sono archiviati in Posizione di Security Command Center che selezioni.

Per applicare una regola di disattivazione ai risultati in una località di Security Command Center, devi creare la regola di disattivazione nella stessa località dei risultati a cui si applica.

Poiché i filtri utilizzati nelle regole di disattivazione possono contenere dati soggetti a controlli della residenza, assicurati di specificare la posizione corretta prima di crearli. Security Command Center non limita la località in cui crei le regole di disattivazione o le esportazioni in streaming.

Le regole di disattivazione vengono archiviate solo nella posizione in cui vengono create e non possono essere visualizzate o modificate in altre posizioni.

Una volta creata una regola di disattivazione audio, non puoi modificarne la posizione. Per modificare la località, devi eliminare la regola di disattivazione e ricrearla nella nuova posizione.

Per visualizzare le regole di disattivazione nella console Google Cloud, devi prima impostare la visualizzazione della console Google Cloud sulla posizione in cui sono state create.

Le stesse regole si applicano alla rappresentazione dell'API di una regola di disattivazione, MuteConfig.

Per recuperare un MuteConfig utilizzando le chiamate API, devi specificare la posizione nel nome completo della risorsa delMuteConfig. Ad esempio:

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

Analogamente, per recuperare un muteConfig utilizzando gcloud CLI, puoi specificare la posizione utilizzando il flag --locations. Ad esempio:

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

Crea regola di disattivazione

La tua organizzazione può creare un massimo di 1000 regole di disattivazione.

Puoi creare regole di disattivazione audio statiche o dinamiche utilizzando la console Google Cloud, la CLI gcloud o l'API Security Command Center. Ti consigliamo di utilizzare le regole di disattivazione dinamica esclusivamente nella regola di disattivazione perché sono più flessibili delle regole di disattivazione statiche. Per un confronto dei tipi di regole di disattivazione, consulta Tipi di regole di disattivazione.

Per codice campione che crea una regola di disattivazione, consulta Crea una regola di disattivazione.

Per creare una regola di disattivazione, fai clic sulla scheda relativa alla procedura vuoi utilizzare:

Console

  1. Nella console Google Cloud, vai alla pagina Risultati di Security Command Center.

    Vai ai risultati

  2. Se necessario, seleziona il tuo progetto o la tua organizzazione Google Cloud.

  3. (Facoltativo) Se è abilitata la residenza dei dati per Security Command Center, quindi modifica la località dei dati in base alle esigenze.

    Per modificare la posizione dei dati, fai clic sul selettore della posizione nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. Fai clic su Opzioni di disattivazione, quindi seleziona Gestisci regole di disattivazione.

  5. Fai clic su Crea regola di disattivazione e poi seleziona Regola di disattivazione dinamica o Regola di disattivazione statica. Per ulteriori informazioni sui tipi di regole di disattivazione, consulta Tipi di regole di disattivazione audio.

  6. Inserisci un ID regola di disattivazione. Questo valore è obbligatorio.

  7. Inserisci una descrizione della regola di disattivazione che fornisca il contesto del motivo per cui i risultati sono disattivati. Questo valore è facoltativo ma consigliato.

    Risorsa principale indica l'ambito in cui verrà creata e applicata la regola di disattivazione dell'audio.

  8. Se crei una regola di disattivazione statica o dinamica senza scadenza, vai al passaggio successivo. Se stai creando una regola di disattivazione dinamica per disattivare temporaneamente i risultati, completa i seguenti passaggi:

    1. Seleziona la casella di controllo Disattiva temporaneamente i risultati corrispondenti.
    2. Seleziona o inserisci la data di scadenza della regola di disattivazione audio dinamica. Questo valore indica per quanto tempo la regola disattiva i risultati corrispondenti.
  9. Nel campo Query dei risultati, crea le tue istruzioni di query in base a facendo clic su Aggiungi filtro. In alternativa, puoi digitare la query manualmente le istruzioni.

    La finestra di dialogo Seleziona filtro ti consente di scegliere i risultati supportati attributi e valori.

    1. Seleziona un attributo di risultato o digitane il nome nel Casella Cerca attributi dei risultati. Un elenco delle vengono visualizzati tutti gli attributi secondari.
    2. Seleziona un attributo secondario. Un campo di selezione mostra dove puoi creare l'istruzione di query utilizzando l'attributo secondario selezionato, un operatore di query e uno o più valori per l'attributo secondario.
    3. Seleziona l'operatore e uno o più valori per il sottoattributo dal riquadro. Per ulteriori informazioni sugli operatori di query e sulle funzioni che utilizzano, consulta Query nel menu Aggiungi filtri.
    4. Fai clic su Applica.

      La finestra di dialogo si chiude e la query viene aggiornata.

    5. Ripeti fino a quando la query sui risultati non contiene tutti gli attributi che ti interessano.
  10. Controlla l'accuratezza del filtro. Per apportare modifiche, elimina o aggiungi proprietà e filtra i valori in base alle esigenze.

  11. Fai clic su Anteprima dei risultati corrispondenti.

    Una tabella mostra i risultati corrispondenti alla query.

  12. Fai clic su Salva.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per creare regole di disattivazione, esegui il comando gcloud scc muteconfigs create:

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

    Sostituisci quanto segue:

    • CONFIG_ID: il nome della regola di disattivazione. ID deve utilizzare caratteri alfanumerici e trattini ed essere compreso tra 1 e 63 caratteri.
    • PARENT: l'ambito nella gerarchia delle risorse a cui si applica la regola di disattivazione, organization, folder o project.
    • PARENT_ID: l'ID dell'organizzazione principale, una cartella, un progetto, specificato nel formato organizations/123, folders/456 o projects/789.
    • LOCATION: se la residente dei dati è abilitata, Security Command Center posizione in cui creare una regola di disattivazione. Se la residenza dei dati non è abilitata, utilizza il valore global,
    • RULE_DESCRIPTION: una descrizione della disattivazione dell'audio non più di 1.024 caratteri.
    • FILTER: l'espressione che definisci per filtrare i risultati. Ad esempio, per disattivare OPEN_FIREWALL risultati, il tuo filtro può essere FILTER="category=\"OPEN_FIREWALL\"".
    • MUTE_TYPE: il tipo di regola di disattivazione che vuoi creare. I tipi di regole di disattivazione validi sono DYNAMIC e STATIC. Il tipo di regola di disattivazione è impostato su STATIC per impostazione predefinita. Non puoi modificare il tipo di una regola di disattivazione audio dopo averla creata.
    • TIMESTAMP: si applica solo se stai creando un oggetto regola di disattivazione dinamica. La stringa data/ora che indica quando la stringa dinamica la regola di disattivazione scade. Il valore deve essere impostato su almeno un giorno del in futuro, altrimenti la richiesta verrà rifiutata. Per informazioni sui formati di tempo, consulta gcloud topic datetimes. Quando una regola di disattivazione dinamica scade, viene rimossa da tutti i risultati corrispondenti. Se vuoi che la regola di disattivazione dinamica agisca indefinitamente sui risultati corrispondenti, ometti questo campo.

    La risposta include l'ID regola di disattivazione, che puoi utilizzare per visualizzare, aggiornare ed eliminare le regole di disattivazione, come descritto in Gestire le regole di disattivazione.

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


import (
	"context"
	"fmt"
	"io"

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

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

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

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

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

Java

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


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

public class CreateMuteRule {

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

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

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

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

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

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.



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

    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

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

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

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

API REST

Nell'API Security Command Center, utilizza il metodo muteConfigs create per per creare una regola di disattivazione. Il corpo della richiesta è un'istanza di MuteConfig.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione 1 o 2 dell'API Security Command Center. La versione 2 dell'API è disponibile come versione di anteprima. Quando la residenza dei dati è abilitata, l'API v2 è l'unica API disponibile.

Se utilizzi la versione 1 dell'API Security Command Center, utilizza l'endpoint della versione 1 per chiamare muteConfigs create. Nel corpo della richiesta, utilizza la definizione di MuteConfig della versione 1:

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

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

Se usi l'API Security Command Center v2, usa la versione 2 endpoint da chiamare muteConfigs create Nel corpo della richiesta, utilizza la definizione di MuteConfig della versione 2:

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"
  }

Sostituisci quanto segue:

  • PARENT: la risorsa principale per la regola di disattivazione (organizations, folders o projects)
  • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale
  • LOCATION: se la residenza dei dati è abilitata, la località di Security Command Center in cui creare una regola di disattivazione. Se la residenza dei dati non è abilitata, utilizza il valore global.
  • MUTE_CONFIG_ID: il nome della regola di disattivazione (tra 1 e 63 caratteri)
  • RULE_DESCRIPTION: una descrizione della disattivazione dell'audio regola (massimo 1024 caratteri)
  • FILTER: l'espressione che definisci per filtrare i risultati

    Ad esempio, per disattivare OPEN_FIREWALL risultati, il filtro può essere "category=\"OPEN_FIREWALL\"".

  • MUTE_TYPE: il tipo di regola di disattivazione che vuoi creare. I tipi di regole di disattivazione validi sono DYNAMIC e STATIC. Non puoi modificare il tipo di regola di disattivazione dopo aver l'ha creato.

  • TIMESTAMP: si applica solo se stai creando un oggetto regola di disattivazione dinamica. La stringa data/ora che indica quando la stringa dinamica la regola di disattivazione scade. Il valore deve essere impostato su almeno un giorno nella in futuro, altrimenti la richiesta verrà rifiutata. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes. Quando viene disattivato l'audio dinamico scade, viene rimossa da tutti i risultati corrispondenti. Se vuoi che la regola di disattivazione dinamica agisca indefinitamente sui risultati corrispondenti, ometti questo campo.

La risposta include l'ID configurazione di disattivazione, che puoi utilizzare per visualizzare, aggiornare ed eliminare le regole di disattivazione, come descritto in Gestire le regole di disattivazione.

I nuovi risultati che corrispondono esattamente al filtro vengono nascosti e l'attributo mute per i risultati viene impostato su MUTED.

Proprietà di ricerca non supportate per le regole di disattivazione

Le regole di disattivazione non supportano tutte le proprietà dei risultati nei filtri. Le seguenti proprietà non sono supportate nei filtri delle regole di disattivazione.

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

Elenca regole di disattivazione

Puoi elencare le regole di disattivazione audio in un'organizzazione, una cartella o un progetto utilizzando la console Google Cloud, la CLI gcloud o l'API Security Command Center.

La possibilità di elencare le regole di disattivazione per un determinato ambito, dipende le autorizzazioni concesse ai tuoi account IAM ruoli.

Se la residenza dei dati è abilitata per Security Command Center, l'ambito anche il comando list è limitato Posizione di Security Command Center.

Per un codice di esempio che elenca le regole di disattivazione, consulta Elenca le regole di disattivazione.

Per elencare le regole di disattivazione audio per un'organizzazione, una cartella o un progetto, fai clic sulla scheda della procedura che vuoi utilizzare:

Console

  1. Nella console Google Cloud, vai alla scheda Disattiva regole nella pagina Impostazioni di Security Command Center.

    Vai alle regole di disattivazione

  2. Se necessario, seleziona il progetto o l'organizzazione Google Cloud.

  3. (Facoltativo) Se la residenza dei dati è abilitata per Security Command Center, modifica la posizione dei dati in base alle esigenze.

    Per modificare la località dei dati, fai clic sul selettore della località nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. Nella sezione Regole di disattivazione, vengono visualizzati i dettagli delle regole di disattivazione attive, tra cui:

    • Nome: disattiva l'ID regola
    • Risorsa padre: la risorsa in cui si trova la regola di disattivazione.
    • Descrizione: la descrizione della regola di disattivazione, se disponibile
    • Ultimo aggiornamento da: l'entità che ha aggiornato per ultimo la regola
    • Ultimo aggiornamento: la data e l'ora dell'ultimo aggiornamento della regola.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per elencare le regole di disattivazione, esegui il comando gcloud scc muteconfigs list:

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

    Sostituisci quanto segue:

    • PARENT: il gruppo principale organization, folder, o project per cui elencare le regole di disattivazione
    • PARENT_ID: l'ID dell'organizzazione principale, una cartella o un progetto
    • LOCATION: se la residenza dei dati è abilitata, la località di Security Command Center in cui elencare le regole di disattivazione; se la residenza dei dati non è abilitata, utilizza il valore global

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.

import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


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

public class ListMuteRules {

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

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

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

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

API REST

Nell'API Security Command Center, utilizza il metodo muteConfigs list per elencare le regole di disattivazione. Il corpo della richiesta è vuoto.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione v1 o v2 di l'API Security Command Center. L'API v2 è disponibile come Release di anteprima. Quando la residenza dei dati abilitata, l'API v2 è l'unica disponibile.

Se utilizzi l'API Security Command Center v1, usa l'endpoint v1 per chiamare muteConfigs list:

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

Se utilizzi l'API Security Command Center v2, usa l'endpoint v2 per chiamare muteConfigs list:

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

Sostituisci quanto segue:

  • PARENT: la risorsa principale per la regola di disattivazione (organizations, folders o projects)
  • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale
  • LOCATION: se la residenza dei dati è abilitata, la località di Security Command Center in cui elencare le regole di disattivazione; se la residenza dei dati non è abilitata, utilizza il valore global

La risposta include i nomi, le descrizioni e gli ID di configurazione della disattivazione per le tue regole di disattivazione.

Visualizzare la configurazione di una regola di disattivazione

Puoi visualizzare una configurazione della regola di disattivazione utilizzando la console Google Cloud, la CLI gcloud o l'API Security Command Center.

Per il codice di esempio che recupera una configurazione della regola di disattivazione, consulta Visualizzare una regola di disattivazione.

Per visualizzare la configurazione di una regola di disattivazione, fai clic sulla scheda relativa alla procedura vuoi utilizzare:

Console

  1. Nella console Google Cloud, vai alla scheda Regole di disattivazione nel Pagina Impostazioni di Security Command Center.

    Vai a Regole di disattivazione

  2. Se necessario, seleziona il tuo progetto o la tua organizzazione Google Cloud.

  3. (Facoltativo) Se la residenza dei dati è abilitata per Security Command Center, modifica la posizione dei dati in base alle esigenze.

    Per modificare la posizione dei dati, fai clic sul selettore della posizione nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. Nella sezione Regole di disattivazione, viene visualizzato un elenco di queste regole.

  5. Fai clic sul nome della regola che vuoi visualizzare.

    Si apre una pagina con la configurazione della regola di disattivazione dell'audio.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per visualizzare la configurazione di una regola di disattivazione, esegui il comando gcloud scc muteconfigs get:

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

    Sostituisci quanto segue:

    • MUTE_CONFIG_ID: l'ID della regola di disattivazione
    • PARENT: la risorsa padre per la regola di disattivazione (organization, folder o project)
    • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto
    • LOCATION: se la residente dei dati è abilitata, Security Command Center posizione in cui visualizzare la configurazione della regola di disattivazione. Se la residenza dei dati non è abilitata, utilizza il valore global

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.

import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


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

public class GetMuteRule {

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

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

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

    getMuteRule(parentPath, muteConfigId);
  }

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

API REST

Nell'API Security Command Center, utilizza il metodo muteConfigs get per restituire la configurazione di una regola di disattivazione audio. Il corpo della richiesta è vuoto.

Per ottenere il valore CONFIG_ID per una regola di disattivazione, esegui prima una chiamata API per elencare le regole di disattivazione. La risposta include gli ID configurazione per le regole di disattivazione restituite.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione 1 o 2 dell'API Security Command Center. L'API v2 è disponibile come Release di anteprima. Quando la residenza dei dati abilitata, l'API v2 è l'unica disponibile.

Se utilizzi l'API Security Command Center v1, usa l'endpoint v1 per chiamare muteConfigs get:

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

Se utilizzi la versione 2 dell'API Security Command Center, utilizza l'endpoint v2 per chiamare muteConfigs get:

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

Sostituisci quanto segue:

  • PARENT: la risorsa padre per la regola di disattivazione (organizations, folders o projects)
  • PARENT_ID: l'ID per organizzazione, cartella o progetto
  • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui visualizzare la configurazione della regola di disattivazione. Se la residenza dei dati non è attivata, utilizza il valore global
  • CONFIG_ID: l'ID numerico della regola di disattivazione

Aggiornare le regole di disattivazione

Puoi aggiornare la descrizione o il filtro dei risultati di una regola di disattivazione utilizzando la console Google Cloud, gcloud CLI o API Security Command Center.

Non puoi modificare l'ID, l'organizzazione, la cartella o il progetto principale o la posizione di una regola di disattivazione. Per modificare uno di questi valori, devi creare una nuova regola di disattivazione.

Se in precedenza hai riattivato i risultati, questi verranno nuovamente disattivati se corrispondono a una regola di disattivazione aggiornata nella console Google Cloud. Per ulteriori informazioni, consulta Riattivare i singoli risultati.

Per codice campione che aggiorna una regola di disattivazione, consulta Aggiorna una regola di disattivazione.

Per aggiornare una regola di disattivazione, fai clic sulla scheda relativa alla procedura vuoi utilizzare:

Console

  1. Nella console Google Cloud, vai alla scheda Disattiva regole nella pagina Impostazioni di Security Command Center.

    Vai alle regole di disattivazione

  2. Seleziona il progetto o l'organizzazione Google Cloud che è la risorsa principale per la regola di disattivazione audio che vuoi modificare.

  3. (Facoltativo) Se la residenza dei dati è abilitata per Security Command Center, modifica la posizione dei dati in base alle esigenze.

    Per modificare la posizione dei dati, fai clic sul selettore della posizione nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. Fai clic sul nome della regola di disattivazione che vuoi modificare.

    Se non hai selezionato il progetto o l'organizzazione appropriati, potresti vedrai una nota che ti informa che non hai l'autorizzazione per modificare la disattivazione personalizzata.

  5. Inserisci una nuova descrizione e fai clic su Salva.

  6. Per le regole di disattivazione audio dinamiche, aggiorna o modifica la data e l'ora di scadenza della regola.

  7. Aggiorna o modifica il filtro.

    Per le istruzioni, vedi Creare regole di disattivazione.

  8. Per visualizzare i risultati che corrispondono al filtro aggiornato, fai clic su Anteprima della corrispondenza. Risultati.

    Viene caricata una tabella con i risultati che corrispondono alla nuova query.

  9. Fai clic su Salva.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per aggiornare le regole di disattivazione dell'audio, esegui il comando gcloud scc muteconfigs update:

      gcloud scc muteconfigs update MUTE_CONFIG_ID \
        --PARENT=PARENT_ID \
        --location=LOCATION
        --description=RULE_DESCRIPTION \
        --filter=FILTER
        --type=MUTE_TYPE \
        --expiry-time=TIMESTAMP
    

    Sostituisci quanto segue:

    • MUTE_CONFIG_ID: l'ID della regola di disattivazione.
    • PARENT: la risorsa padre per la regola di disattivazione (organization, folder o project).
    • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto.
    • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui aggiornare la regola di disattivazione audio. Se la residenza dei dati non è attivata, utilizza il valore global.
    • RULE_DESCRIPTION: una descrizione della disattivazione dell'audio (massimo 1024 caratteri).
    • FILTER: l'espressione che definisci per filtrare i risultati.

      Ad esempio, per disattivare OPEN_FIREWALL risultati, il filtro potrebbe essere FILTER="category=\"OPEN_FIREWALL\"".

    • MUTE_TYPE: il tipo di regola di disattivazione che stai aggiornando. I tipi di regole di disattivazione audio validi sono DYNAMIC e STATIC. Non puoi modificare il tipo di una regola di disattivazione dopo averla creata.

    • TIMESTAMP: si applica solo se aggiorni un regola di disattivazione dinamica. La stringa data/ora che indica quando la stringa dinamica la regola di disattivazione scade. Il valore deve essere impostato su almeno un giorno nel futuro, altrimenti la richiesta verrà rifiutata. Per informazioni sull'orario formati, consulta gcloud topic datetimes. Quando una regola di disattivazione dinamica scade, viene rimossa da tutti i risultati corrispondenti. Se vuoi che la regola di disattivazione dinamica agisca indefinitamente sui risultati corrispondenti, ometti questo campo.

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


import (
	"context"
	"fmt"
	"io"

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

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

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

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

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

Java

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.


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

public class UpdateMuteRule {

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

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

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

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

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

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

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

API REST

Nell'API Security Command Center, utilizza il metodo muteConfigs patch per aggiornare una regola di disattivazione audio. Il corpo della richiesta è un'istanza di MuteConfig.

Per ottenere CONFIG_ID per una regola di disattivazione, esegui una chiamata API a elencare le regole di disattivazione. La risposta include gli ID di configurazione per le regole di disattivazione restituite.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione v1 o v2 di l'API Security Command Center. La versione 2 dell'API è disponibile come release di anteprima. Quando la residenza dei dati abilitata, l'API v2 è l'unica disponibile.

Se utilizzi la versione 1 dell'API Security Command Center, utilizza l'endpoint v1 per chiamare muteConfigs patch:

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

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

Se utilizzi l'API Security Command Center v2, usa l'endpoint v2 per chiama muteConfigs patch:

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

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

Sostituisci quanto segue:

  • PARENT: la risorsa padre per la regola di disattivazione (organizations, folders o projects)
  • PARENT_ID: l'ID per organizzazione, cartella o progetto
  • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui aggiornare la regola di disattivazione audio. Se la residenza dei dati non è attivata, utilizza il valore global
  • CONFIG_ID: l'ID numerico della regola di disattivazione
  • RULE_DESCRIPTION: una descrizione della regola di disattivazione (massimo 1024 caratteri)
  • FILTER: l'espressione che definisci per filtrare i risultati

    Ad esempio, per disattivare OPEN_FIREWALL risultati, il filtro può essere "category=\"OPEN_FIREWALL\"".

  • MUTE_TYPE: il tipo di regola di disattivazione che stai aggiornando. I tipi di regole di disattivazione audio validi sono DYNAMIC e STATIC. Non puoi modificare il tipo di una regola di disattivazione dopo averla creata.

  • TIMESTAMP: si applica solo se aggiorni un regola di disattivazione dinamica. La stringa data/ora che indica quando la disattivazione dell'audio dinamico della regola scade. Il valore deve essere impostato su almeno un giorno nel futuro, altrimenti la richiesta verrà rifiutata. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes. Quando un elemento dinamico la regola di disattivazione scade, viene rimossa da tutti i risultati corrispondenti. Se desideri regola di disattivazione dinamica affinché agisca all'infinito sui risultati corrispondenti. ometti questo campo.

I nuovi risultati che corrispondono esattamente al filtro vengono nascosti e l'attributo mute per i risultati viene impostato su MUTED.

Elimina regole di disattivazione

Puoi eliminare una regola di disattivazione utilizzando la console Google Cloud, gcloud CLI o l'API Security Command Center.

Prima di eliminare le regole di disattivazione audio, tieni presente quanto segue:

  • Non puoi recuperare le regole di disattivazione eliminate.
  • L'eliminazione delle regole di disattivazione statiche non riattiva automaticamente i risultati disattivati. Devi riattivare l'audio manualmente o in modo programmatico risultati.
  • L'eliminazione di regole di disattivazione dinamica rimuove automaticamente la regola da tutte che in precedenza corrispondono ai risultati e li riattiva se non corrispondono ad alcun risultato regole aggiuntive.
  • I risultati futuri che corrispondono ai filtri nelle regole di disattivazione eliminate non vengono disattivati.

Per codice campione che elimina una regola di disattivazione, consulta Elimina una regola di disattivazione.

Per eliminare una regola di disattivazione audio, fai clic sulla scheda della procedura che vuoi utilizzare:

Console

  1. Nella console Google Cloud, vai alla scheda Disattiva regole nella pagina Impostazioni di Security Command Center.

    Vai alle regole di disattivazione

  2. Se necessario, seleziona il progetto o l'organizzazione Google Cloud.

  3. (Facoltativo) Se è abilitata la residenza dei dati per Security Command Center, quindi modifica la località dei dati in base alle esigenze.

    Per modificare la località dei dati, fai clic sul selettore della località nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. Fai clic sul nome della regola di disattivazione che vuoi eliminare.

  5. Fai clic su Elimina.

  6. Leggi la finestra di dialogo e, se soddisfatto, fai clic su Elimina.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per eliminare le regole di disattivazione, esegui il comando gcloud scc muteconfigs delete:

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

    Sostituisci quanto segue:

    • MUTE_CONFIG_ID: l'ID della configurazione di disattivazione dell'audio
    • PARENT: la risorsa padre per la regola di disattivazione (organization, folder o project)
    • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto
    • LOCATION: se la residenza dei dati è abilitata, la località di Security Command Center in cui eliminare la regola di disattivazione. Se la residenza dei dati non è abilitata, utilizza il valore global.
  3. Conferma la richiesta di eliminazione della regola di disattivazione dell'audio.

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


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

public class DeleteMuteRule {

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

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

    deleteMuteRule(parentPath, muteConfigId);
  }

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

API REST

Nell'API Security Command Center, utilizza il metodo muteConfigs delete per elimina una regola di disattivazione. Il corpo della richiesta è vuoto.

Per ottenere CONFIG_ID per una regola di disattivazione, esegui una chiamata API a Elenca le regole di disattivazione. La risposta include gli ID configurazione per le regole di disattivazione restituite.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione v1 o v2 di l'API Security Command Center. La versione 2 dell'API è disponibile come release di anteprima. Quando la residenza dei dati abilitata, l'API v2 è l'unica disponibile.

Se utilizzi l'API Security Command Center v1, usa l'endpoint v1 per chiamare muteConfigs delete:

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

Se utilizzi la versione 2 dell'API Security Command Center, utilizza l'endpoint v2 per chiamare muteConfigs delete:

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

Sostituisci quanto segue:

  • PARENT: la risorsa padre per la regola di disattivazione (organizations, folders o projects)
  • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto
  • LOCATION: se la residenza dei dati è abilitata, la località di Security Command Center in cui eliminare la regola di disattivazione. Se la residenza dei dati non è abilitata, utilizza il valore global.
  • CONFIG_ID: l'ID numerico della regola di disattivazione

Disattivare un singolo risultato

Puoi disattivare staticamente un singolo rilevamento utilizzando la console Google Cloud, la CLI gcloud o l'API Security Command Center.

La disattivazione statica di un risultato non influisce sul fatto che sia attivo o meno. Se un risultato attivo viene disattivato, l'attributo state rimane invariato:state="ACTIVE". Il risultato è nascosto, ma rimane attivo fino all'elemento sottostante la vulnerabilità, l'errata configurazione o la minaccia vengono risolte. Inoltre, se disattivi un risultato in modo statico, sostituisci eventuali regole di disattivazione dinamica che si applicano al risultato.

La disattivazione del risultato di una combinazione tossica chiude la combinazione tossica corrispondente per verificare se è così.

Per disattivare tutti i risultati futuri che corrispondono ai criteri specificati, consulta Creare regole di disattivazione.

Per il codice campione per disattivare l'audio di una segnalazione, consulta Disattivare l'audio di una segnalazione.

Per disattivare in modo statico l'audio di un singolo risultato, fai clic sulla scheda relativa alla procedura che vuoi utilizzare:

Console

  1. Nella console Google Cloud, vai ai Risultati di Security Command Center .

    Vai a Risultati

  2. Se necessario, seleziona il tuo progetto o la tua organizzazione Google Cloud.

  3. (Facoltativo) Se la residenza dei dati è abilitata per Security Command Center, modifica la posizione dei dati in base alle esigenze.

    Per modificare la località dei dati, fai clic sul selettore della località nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. Se non vedi il rilevamento che devi disattivare nel riquadro Risultati della query sui rilevamenti, seleziona la categoria del rilevamento nella sezione Categoria del riquadro Filtri rapidi.

  5. Seleziona la casella di controllo accanto al risultato da disattivare. Puoi selezionare uno o più risultati.

  6. Nella barra delle azioni Risultati della query sui risultati, fai clic su Opzioni di disattivazione audio e poi seleziona Applica disattivazione audio.

    L'attributo mute dei risultati selezionati è impostato su MUTED e il risultato viene rimosso dal riquadro Risultati della query dei risultati.

In alternativa, puoi disattivare un risultato dal relativo riquadro dei dettagli:

  1. Nel riquadro Ricerca dei risultati della query della pagina Risultati, Nella colonna Categoria, fai clic sul nome di un singolo risultato. Si apre il riquadro dei dettagli del risultato.
  2. Fai clic su Intervieni.
  3. Dal menu Intervieni, seleziona Applica override disattivazione audio.

    Se invece selezioni Disattiva risultati come questo, il pulsante Crea regola di disattivazione si apre una pagina in cui puoi creare una regola di disattivazione per i risultati o che includono lo stesso Indicator .

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per impostare lo stato di disattivazione dell'audio di un risultato su MUTED, utilizza Comando set-mute in gcloud CLI:

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

    Sostituisci quanto segue:

    • FINDING_ID: l'ID del risultato che vuoi disattivare

      Per recuperare gli ID dei risultati, utilizza l'API Security Command Center per elencare i risultati. L'ID risultato è l'ultima parte dell'attributo canonicalName, per un esempio, projects/123456789012/sources/1234567890123456789/findings`/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: la risorsa padre (project, folder o organization), sensibile alle maiuscole

    • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale

    • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui disattivare l'audio del risultato. Se la residenza dei dati non è attivata, utilizza il valore global

    • SOURCE_ID: l'ID origine

      Per istruzioni sul recupero di un ID origine, vedi Recupero dell'ID origine.

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.

import (
	"context"
	"fmt"
	"io"

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

// setMute mutes an individual finding, can also unmute or reset the mute state of a finding.
// If a finding is already muted, muting it again has no effect.
// Various mute states are: UNDEFINED/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

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.


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

public class SetMuteFinding {

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

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

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

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

API REST

Nell'API Security Command Center, utilizza il metodo setMute per disattivare l'audio di ricerca. Il corpo della richiesta è un'enumerazione che indica i senza audio.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione v1 o v2 di l'API Security Command Center. L'API v2 è disponibile come Release di anteprima. Quando la residenza dei dati abilitata, l'API v2 è l'unica disponibile.

Se utilizzi la versione 1 dell'API Security Command Center, chiama setMute utilizzando l'endpoint v1:


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

{
  "mute": "MUTED"
}

Se utilizzi l'API Security Command Center v2, chiama setMute utilizzando l'endpoint v2:

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

{
  "mute": "MUTED"
}

Sostituisci quanto segue:

  • PARENT: la risorsa principale (organizations, folders o projects).
  • PARENT_ID: l'ID dell'elemento principale un'organizzazione, una cartella o un progetto.
  • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui disattivare l'audio del risultato. Se la residenza dei dati non è attivata, utilizza il valore global
  • SOURCE_ID: l'ID numerico dell'origine.

    Per istruzioni sul recupero di un ID origine, vedi Recupero dell'ID origine.

  • FINDING_ID: l'ID del risultato che ti interessa per disattivare l'audio.

    Per recuperare gli ID risultato, utilizza l'API Security Command Center per elencare i risultati. L'ID risultato è l'ultima parte dell'attributo canonicalName, per un esempio, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Dopo aver disattivato un risultato, il relativo attributo mute viene impostato su MUTED.

Riattivare singoli risultati

Puoi attivare staticamente un singolo rilevamento utilizzando la console Google Cloud, la riga di comando gcloud o l'API Security Command Center.

La disattivazione della disattivazione di un risultato è utile quando devi impedire che un risultato venga nascosto da una regola di disattivazione troppo ampia o da una regola che potrebbe essere troppo complessa da modificare per escludere i risultati che ritieni importanti.

Per il codice campione per riattivare un rilevamento, consulta Riattivare un rilevamento.

I risultati non disattivati vengono disattivati di nuovo solo se vengono disattivati manualmente. Le regole di disattivazione create con gcloud CLI o l'API Security Command Center influire sui risultati riattivati dagli utenti.

Per codice campione per riattivare un risultato, consulta Riattivare un risultato.

Console

  1. Nella console Google Cloud, vai alla pagina Risultati di Security Command Center.

    Vai a Risultati

  2. Se necessario, seleziona il tuo progetto o la tua organizzazione Google Cloud.

    Viene visualizzata la pagina Risultati con la query predefinita nella sezione Anteprima query. La query predefinita filtra i risultati disattivati, Devi quindi modificare la query prima che i risultati disattivati vengano visualizzati nella Riquadro Risultati query dei risultati.

  3. (Facoltativo) Se la residenza dei dati è abilitata per Security Command Center, modifica la posizione dei dati in base alle esigenze.

    Per modificare la posizione dei dati, fai clic sul selettore della posizione nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. A destra della sezione Anteprima della query, fai clic su Modifica query per apri l'Editor di query.

  5. Nel campo Editor di query, sostituisci l'istruzione di disattivazione esistente con le seguenti:

    mute="MUTED"
  6. Fai clic su Applica. I risultati nel riquadro Risultati della query dei risultati sono aggiornati in modo da includere solo i risultati disattivati.

  7. Se necessario, filtra altri risultati disattivati. Ad esempio, nel riquadro Filtri rapidi, in Categoria, seleziona il nome della segnalazione di cui devi riattivare l'audio per filtrare tutte le altre categorie di segnalazioni.

  8. Seleziona la casella di controllo accanto al risultato da riattivare. Puoi selezionare uno o più risultati.

  9. Nella barra delle azioni Risultati della query sui risultati, fai clic su Opzioni di disattivazione audio e poi seleziona Applica override di attivazione audio.

    L'attributo mute dei risultati selezionati è impostato su UNMUTED e il risultato viene rimosso dal riquadro Risultati della query dei risultati.

In alternativa, puoi riattivare l'audio di un rilevamento dal relativo riquadro dei dettagli:

  1. Nel riquadro Ricerca dei risultati della query della pagina Risultati, Nella colonna Categoria, fai clic sul nome di un singolo risultato. Viene visualizzato il riquadro dei dettagli del rilevamento.
  2. Fai clic su Intervieni.
  3. Dal menu Intervieni, seleziona Applica override di attivazione audio.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per impostare lo stato di disattivazione di un rilevamento su UNMUTED, utilizza il comando set-mute nella CLI gcloud:

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

    Sostituisci quanto segue:

    • FINDING_ID: l'ID del risultato che vuoi disattivare

      Per recuperare gli ID risultato, utilizza l'API Security Command Center per elencare i risultati. L'ID risultato è l'ultima parte dell'attributo canonicalName, per un esempio, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: la risorsa principale (project, folder o organization), sensibile alle maiuscole

    • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale

    • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui riattivare il rilevamento. Se la residenza dei dati non è attivata, utilizza il valore global

    • SOURCE_ID: l'ID origine

      Per istruzioni sul recupero di un ID origine, vedi Recupero dell'ID origine.

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.


import (
	"context"
	"fmt"
	"io"

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

// setMute mutes an individual finding, can also unmute or reset the mute state of a finding.
// If a finding is already muted, muting it again has no effect.
// Various mute states are: UNDEFINED/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

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


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

public class SetUnmuteFinding {

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

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

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

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

API REST

Nell'API Security Command Center, utilizza il metodo setMute per riattivare un risultato. Il corpo della richiesta è un'enumerazione che indica i senza audio.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione v1 o v2 di l'API Security Command Center. La versione 2 dell'API è disponibile come release di anteprima. Quando la residenza dei dati è attivata, l'API v2 è l'unica API disponibile.

Se utilizzi la versione 1 dell'API Security Command Center, chiama setMute utilizzando l'endpoint v1:

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

{
  "mute": "UNMUTED"
}

Se utilizzi l'API Security Command Center v2, chiama setMute utilizzando l'endpoint v2:

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

{
  "mute": "UNMUTED"
}

Sostituisci quanto segue:

  • PARENT: la risorsa padre (organizations, folders o projects)
  • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale
  • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui riattivare il rilevamento. Se la residenza dei dati non è attivata, utilizza il valore global
  • SOURCE_ID: l'ID numerico dell'origine

    Per istruzioni su come recuperare un ID origine, consulta Ottenere l'ID origine.

  • FINDING_ID: l'ID del risultato che ti interessa per disattivare l'audio.

    Per recuperare gli ID risultato, utilizza l'API Security Command Center per elencare i risultati. L'ID del rilevamento è l'ultima parte dell'attributo canonicalName, ad esempio projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

I risultati selezionati non sono più nascosti e l'attributo mute per il i risultati sono impostati su UNMUTED.

Rimuovere un override dello stato di disattivazione dai singoli risultati

Applichi un override dello stato di disattivazione quando modifichi intenzionalmente la disattivazione dell'audio di un risultato per disattivare o riattivare il risultato in modo statico. Ad esempio, potresti voler applicare un'override dello stato di disattivazione per nascondere un risultato di bassa gravità per il quale non vale la pena creare una regola di disattivazione dinamica.

Puoi rimuovere l'override dello stato di disattivazione da un singolo risultato utilizzando la console Google Cloud, la riga di comando gcloud o l'API Security Command Center.

Prima di rimuovere l'override dello stato di disattivazione da un risultato, comprendi le seguenti:

  • Un risultato ha l'override dello stato di disattivazione se l'audio è disattivato o riattivato in modo statico. Tu puoi applicare un override dello stato di disattivazione a qualsiasi risultato manualmente o automaticamente con regole di disattivazione statiche.
  • L'override dello stato di disattivazione si applica a un rilevamento a tempo indeterminato e ha la precedenza su eventuali regole di disattivazione corrispondenti.
  • La rimozione dell'override dello stato di disattivazione da un risultato reimposta lo stato di disattivazione del risultato in modo che possa essere elaborato da regole di disattivazione statiche o dinamiche.
  • Rimuovere l'override dello stato di disattivazione da un risultato è diverso dalla riattivazione di un ricerca. Quando riattivi l'audio di un risultato (applichi un override per la riattivazione dell'audio), le regole di disattivazione non può disattivare questo risultato finché non hai rimosso manualmente l'override dello stato di disattivazione.

Per rimuovere la disattivazione dell'audio da una singola segnalazione:

Console

  1. Nella console Google Cloud, vai alla pagina Risultati di Security Command Center.

    Vai a Risultati

  2. Seleziona il tuo progetto o la tua organizzazione Google Cloud.

  3. (Facoltativo) Se è abilitata la residenza dei dati per Security Command Center, quindi modifica la località dei dati in base alle esigenze.

    Per modificare la località dei dati, fai clic sul selettore della località nella barra delle azioni.

    Viene visualizzato un elenco di località. Seleziona la nuova posizione.

  4. A destra della sezione Anteprima della query, fai clic su Modifica query per apri l'Editor di query.

  5. Nel campo Editor di query, sostituisci l'istruzione di disattivazione esistente con le seguenti:

    mute="MUTED" OR mute="UNMUTED"
  6. Fai clic su Applica. I risultati nel riquadro Risultati della query dei risultati sono aggiornati per includere i risultati con e senza audio statico.

  7. Se necessario, filtra gli altri risultati. Ad esempio, nel riquadro Filtri rapidi, in Categoria, seleziona il nome dell'elemento da reimpostare per filtrare tutte le altre categorie di elementi.

  8. Seleziona la casella di controllo accanto al risultato da reimpostare. Puoi selezionare uno o più risultati.

  9. Nella barra delle azioni Risultati della query dei risultati, fai clic su Opzioni di disattivazione. quindi seleziona Rimuovi sostituzioni di disattivazione audio.

    L'attributo mute dei risultati selezionati è impostato su UNDEFINED e il risultato viene rimosso dal riquadro Risultati della query dei risultati.

In alternativa, puoi riattivare l'audio di un rilevamento dal relativo riquadro dei dettagli:

  1. Nel riquadro Ricerca dei risultati della query della pagina Risultati, Nella colonna Categoria, fai clic sul nome di un singolo risultato. Viene visualizzato il riquadro dei dettagli del rilevamento.
  2. Fai clic su Intervieni.
  3. Dal menu Intervieni, seleziona Rimuovi sostituzioni di disattivazione audio.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per impostare lo stato di disattivazione di un rilevamento su UNDEFINED, utilizza il comando set-mute nella CLI gcloud:

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

    Sostituisci quanto segue:

    • FINDING_ID: l'ID del rilevamento da reimpostare

      Per recuperare gli ID risultato, utilizza l'API Security Command Center per elencare i risultati. L'ID del rilevamento è l'ultima parte dell'attributo canonicalName, ad esempio projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: la risorsa principale (project, folder o organization), sensibile alle maiuscole

    • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale

    • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui rimuovere l'override dello stato di disattivazione da un rilevamento. Se la residenza dei dati non è attivata, utilizza il valore global.

    • SOURCE_ID: l'ID origine

      Per istruzioni su come recuperare un ID origine, consulta Ottenere l'ID origine

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.

import (
	"context"
	"fmt"
	"io"

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

// setMute mutes an individual finding, can also unmute or reset the mute state of a finding.
// If a finding is already muted, muting it again has no effect.
// Various mute states are: UNDEFINED/MUTE/UNMUTE.
func setMuteUndefined(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_UNDEFINED}

	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

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.


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

public class 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;
    }
  }
}

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

API REST

Nell'API Security Command Center, utilizza il metodo setMute per reimpostare la disattivazione lo stato di un risultato. Il corpo della richiesta è un enum che indica lo stato di disattivazione risultante.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione 1 o 2 dell'API Security Command Center. La versione 2 dell'API è disponibile come release di anteprima. Quando la residenza dei dati abilitata, l'API v2 è l'unica disponibile.

Se utilizzi la versione 1 dell'API Security Command Center, chiama setMute utilizzando l'endpoint v1:

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

{
  "mute": "UNDEFINED"
}

Se utilizzi l'API Security Command Center v2, chiama setMute utilizzando l'endpoint v2:

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

{
  "mute": "UNDEFINED"
}

Sostituisci quanto segue:

  • PARENT: la risorsa padre (organizations, folders o projects)
  • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale
  • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui rimuovere l'override dello stato di disattivazione da un rilevamento. Se la residenza dei dati non è attivata, utilizza il valore global.
  • SOURCE_ID: l'ID numerico dell'origine

Disattivare o reimpostare più risultati esistenti

Puoi eseguire le seguenti operazioni di disattivazione collettiva per più account esistenti dei risultati utilizzando gcloud scc findings bulk-mute il comando gcloud CLI o il metodo bulkMute del API Security Command Center:

  • Disattiva più risultati esistenti. La disattivazione collettiva dei risultati esistenti li disattiva staticamente e sostituisce qualsiasi regola di disattivazione dinamica applicabile al risultato. Se devi disattivare risultati futuri simili, crea una regola di disattivazione.

  • Rimuovi l'override dello stato di disattivazione su più risultati esistenti. Se rimuovi la sostituzione dello stato di disattivazione su un risultato, reimposti lo stato di disattivazione da MUTED (disattivato in modo statico) o UNMUTED (attivato in modo statico) a UNDEFINED. Questa funzionalità può essere utile se stai eseguendo la migrazione da un'immagine statica a una dinamica di disattivazione delle regole.

Specifica l'insieme di risultati che devi disattivare definendo un filtro di ricerca. I filtri di disattivazione collettiva non supportano tutte le proprietà dei risultati. Per un elenco delle proprietà non supportate, vedi Proprietà dei risultati non supportate per le regole di disattivazione.

Se la residenza dei dati è abilitata per Security Command Center, l'ambito delle operazioni di disattivazione collettiva è limitato alla località di Security Command Center in cui vengono eseguite.

Per un codice di esempio che disattiva collettivamente i risultati, consulta Disattivare collettivamente i risultati.

Per disattivare l'audio o reimpostare collettivamente i risultati, fai clic sulla scheda relativa alla procedura che vuoi utilizzare:

Console

Nella console Google Cloud, puoi disattivare collettivamente i risultati solo creando regole di disattivazione. Nella console Google Cloud, la creazione di regole di disattivazione consente di disattivare i risultati esistenti e futuri.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per disattivare o reimpostare più risultati contemporaneamente, esegui il comandogcloud scc findings bulk-mute:

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

    Sostituisci quanto segue:

    • PARENT: l'ambito nella gerarchia delle risorse a cui si applica la regola di disattivazione, organization, folder o project.
    • PARENT_ID: l'ID dell'organizzazione principale, una cartella, un progetto, specificato nel formato organizations/123, folders/456 o projects/789.
    • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui disattivare o reimpostare collettivamente i risultati. Se la residenza dei dati non è attivata, utilizza il valore global.

    • FILTER: l'espressione che definisci per filtrare i risultati.

      Ad esempio, per disattivare l'audio di tutti i OPEN_FIREWALL e i PUBLIC_IP_ADDRESS risultati nel progetto internal-test, il tuo filtro può essere "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.projectDisplayName=\"internal-test\"".

    • MUTE_STATE: il valore che indica se le o meno in modo statico. I valori validi sono MUTED e UNDEFINED. Il valore è impostato su MUTED per impostazione predefinita. Imposta questo valore su UNDEFINED solo se reimposti lo stato di disattivazione di più risultati esistenti.

Vai

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION al nome della risorsa dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del servizio Security Command Center che ha emesso il risultato.


import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al del nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders, o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.


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

public class BulkMuteFindings {

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

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

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

    bulkMute(parentPath, muteRule);
  }

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

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

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

Python

L'esempio seguente utilizza l'API v1. Per modificare l'esempio per la versione 2, sostituisci v1 con v2 e aggiungi /locations/LOCATION al nome della risorsa.

Per la maggior parte delle risorse, aggiungi /locations/LOCATION al nome della risorsa dopo /PARENT/PARENT_ID, dove PARENT è organizations, folders o projects.

Per i risultati, aggiungi /locations/LOCATION alla risorsa nome dopo /sources/SOURCE_ID, dove SOURCE_ID è l'ID del Servizio Security Command Center che ha restituito il risultato.

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

    client = securitycenter.SecurityCenterClient()

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

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

API REST

Nell'API Security Command Center, utilizza il metodo bulkMute per disattivare o reimpostare lo stato di disattivazione di più risultati esistenti. Il corpo della richiesta contiene l'espressione utilizzata per filtrare i risultati.

A meno che la residenza dei dati non sia abilitata, puoi utilizzare la versione v1 o v2 di l'API Security Command Center. La versione 2 dell'API è disponibile come release di anteprima. Quando la residenza dei dati abilitata, l'API v2 è l'unica disponibile.

Se utilizzi la versione 1 dell'API Security Command Center, chiama bulkMute utilizzando l'endpoint v1:

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

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

Se utilizzi la versione 2 dell'API Security Command Center, chiama bulkMute utilizzando l'endpoint v2:

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

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

Sostituisci quanto segue:

  • PARENT: la risorsa principale (organizations, folders o projects).
  • PARENT_ID: l'ID dell'organizzazione principale, una cartella o un progetto.
  • LOCATION: se la residenza dei dati è attivata, la località di Security Command Center in cui disattivare o reimpostare collettivamente i risultati. Se la residenza dei dati non è attivata, utilizza il valore global.
  • FILTER: l'espressione che definisci per filtrare i risultati.

    Ad esempio, per disattivare tutti i risultati OPEN_FIREWALL e PUBLIC_IP_ADDRESS esistenti di bassa gravità nel progetto internal-test, il filtro puoi essere "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.projectDisplayName=\"internal-test\"".

  • MUTE_STATE: il valore che indica se le sia disattivato o meno. I valori validi sono MUTED o UNDEFINED. Il valore è impostato su MUTED per impostazione predefinita. Imposta questo valore solo su UNDEFINED se reimposti lo stato di disattivazione di più risultati esistenti.

Tutti i risultati esistenti nella risorsa selezionata e che corrispondono esattamente al sono nascosti. L'attributo mute dei risultati è impostato su MUTED.

La disattivazione dei risultati non cambia il loro stato. Se i risultati attivi sono disattivati, sono nascosti, ma rimangono attivi finché le vulnerabilità sottostanti errori di configurazione o le minacce.

Visualizzare i risultati disattivati nella console Google Cloud

Puoi visualizzare i risultati disattivati nella console Google Cloud modificando la query dei risultati per selezionare quelli che includono il valore della proprietà mute="MUTED".

Ad esempio, la seguente query sui risultati mostra solo i risultati attivi con audio disattivato:

state="ACTIVE"
AND mute="MUTED"

Per visualizzare tutti i risultati attivi, sia disattivati che non, ometti completamente l'attributo mute dalla query:

state="ACTIVE"

Per impostazione predefinita, la query sui risultati nella console Google Cloud mostra solo i risultati non disattivati.

Visualizza i risultati disattivati per tipo di regola di disattivazione

Le seguenti sezioni descrivono come eseguire query sui risultati attivi in base al tipo di regola di disattivazione.

Per ulteriori informazioni sull'elenco di risultati specifici, consulta Filtro risultati.

Risultati della query disattivati da regole di disattivazione statiche

Per visualizzare i risultati attivi disattivati da una regola di disattivazione statica dopo un all'ora specificata, utilizza la seguente query ed esamina muteInitiator per determinare se il risultato è stato disattivato da una regola di disattivazione statica.

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

Sostituisci TIMESTAMP con la stringa data/ora che indica l'inizio del periodo di tempo per cui vuoi eseguire una query. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.

Risultati della query disattivati dalle regole di disattivazione dinamica

Per visualizzare i risultati attivi che sono stati disattivati da una regola di disattivazione dinamica dopo un determinato periodo di tempo, utilizza la seguente query:

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

Sostituisci quanto segue:

  • TIMESTAMP: la stringa data/ora che indica l'inizio del periodo di tempo per cui vuoi eseguire una query. Per informazioni sull'orario formati, consulta gcloud topic datetimes.
  • PARENT_ID: l'ID dell'organizzazione principale, della cartella o progetto, specificato nel formato organizations/123, folders/456, oppure projects/789.
  • CONFIG_ID: il nome della regola di disattivazione. L'ID deve utilizzare caratteri alfanumerici e trattini e avere una lunghezza compresa tra 1 e 63 caratteri.

Per ulteriori informazioni sulla modifica delle query sui risultati, consulta Crea o modifica una query sui risultati nella dashboard.

Ricerca delle proprietà correlate alla disattivazione dell'audio

Questa sezione elenca le proprietà di rilevamento correlate allo stato di disattivazione di un rilevamento e descrive in che modo sono interessate dalle operazioni di disattivazione:

  • mute: impostato su UNDEFINED quando vengono creati i risultati e cambia nei seguenti scenari:
    • MUTED: l'audio di un risultato viene disattivato manualmente o da una regola di disattivazione.
    • UNMUTED: un utente riattiva l'audio di un rilevamento.
  • muteUpdateTime: il momento in cui un risultato viene disattivato o riattivato.
  • muteInitiator: l'identificatore della regola principale o di disattivazione che ha disattivato un ricerca.
  • muteInfo: disattiva le informazioni relative al risultato, ad esempio il tipo di regola di disattivazione (statiche o dinamiche) e le regole di disattivazione corrispondenti al risultato.
  • muteInfo.staticMute: uno stato di disattivazione statica sostituisce qualsiasi regola di disattivazione dinamica applicata a questo risultato.
    • state: uno stato di disattivazione audio statico che può essere impostato disattivando il risultato o una regola di disattivazione statica.
    • applyTime: data e ora in cui lo stato di disattivazione audio statico è stato applicato al risultato.
  • muteInfo.dynamicMuteRecords: il record di una regola di disattivazione dinamica corrispondente al risultato.
    • muteConfig: il nome della risorsa relativa della regola di disattivazione, rappresentata dalla configurazione di disattivazione che ha creato il record. Ad esempio: organizations/123/muteConfigs/examplemuteconfig.
    • matchTime: data e ora in cui una regola di disattivazione dinamica ha trovato corrispondenza al risultato.

Interrompere le notifiche e le esportazioni dei risultati disattivati

Se attivi la ricerca delle notifiche, risultati disattivati nuovi o aggiornati che corrispondono ai tuoi filtri per le notifiche vengono ancora esportate in Pub/Sub.

Per interrompere le esportazioni e le notifiche relative ai risultati disattivati, utilizza l'attributo mute per escludere i risultati disattivati nel filtro NotificationConfig. Ad esempio, invia notifiche solo per i risultati attivi che non sono disattivati o in cui l'attributo di disattivazione dell'audio non è stato impostato:

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

Passaggi successivi

Scopri di più su filtrando le notifiche sui risultati.

Consulta altri esempi di filtri che puoi utilizzare.