Disattivare singoli risultati

Livelli di servizio Standard (legacy), Standard, Premium ed Enterprise

Il livello di servizio Security Command Center Enterprise verrà chiuso il 21 maggio 2027. Se la tua organizzazione utilizza il livello di servizio Enterprise, verrà eseguito automaticamente il passaggio al livello di servizio Premium a partire dal 21 maggio 2027. Contatta il tuo rappresentante dell'account o uno Google Cloud specialista delle vendite se hai domande.

Questo documento spiega come disattivare singole vulnerabilità in modo statico, riattivarle o disattivare le vulnerabilità in blocco in Security Command Center.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per disattivare o riattivare i risultati, chiedi all'amministratore di concederti i seguenti ruoli IAM nell'organizzazione, nella cartella o nel progetto:

• Disattivare o riattivare manualmente l'audio dei singoli risultati:
  • Editor risultati Centro sicurezza (roles/securitycenter.findingsEditor)
  • Amministratore Security Center (roles/securitycenter.admin)
• Disattiva più risultati contemporaneamente:
  • Security Center Findings Bulk Mute Editor (roles/securitycenter.findingsBulkMuteEditor)
  • Amministratore Security Center (roles/securitycenter.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Disattivare un singolo risultato

Puoi disattivare l'audio di un singolo risultato in modo statico utilizzando la consoleGoogle Cloud , gcloud CLI o l'API Security Command Center.

La disattivazione statica di un risultato non influisce sul suo stato di attività. Se un risultato attivo viene disattivato, l'attributo state rimane invariato: state="ACTIVE". Il risultato è nascosto, ma rimane attivo finché non viene risolta la vulnerabilità, la configurazione errata o la minaccia sottostante. Inoltre, disattivando staticamente un risultato, esegui l'override di tutte le regole di disattivazione dinamica che si applicano al risultato.

La disattivazione di un risultato di combinazione tossica chiude il caso di combinazione tossica corrispondente.

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

Per un esempio di codice campione per disattivare un risultato, vedi Disattivare un risultato.

Per disattivare l'audio di un singolo risultato, fai clic sulla scheda della procedura che vuoi utilizzare:

Console

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

   Vai a Risultati

2. Se necessario, seleziona il tuo progetto Google Cloud o la tua organizzazione.
3. Se non vedi il risultato che devi disattivare nel riquadro Risultati della query sui risultati, seleziona la categoria del risultato nella sezione Categoria del riquadro Filtri rapidi.
4. Seleziona il risultato che devi disattivare. Puoi selezionare uno o più risultati.

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

   L'attributo mute per i risultati selezionati è impostato su MUTED e il risultato viene rimosso dal riquadro Risultati della query sui risultati. In alternativa, puoi disattivare un risultato dal relativo riquadro dei dettagli:

6. Nel riquadro Risultati della query sui risultati della pagina Risultati, nella colonna Categoria, fai clic sul nome di un singolo risultato. Viene visualizzato il riquadro dei dettagli del problema.

7. Fai clic su Passa all'azione.

8. Dal menu Passa all'azione, seleziona Applica override disattivazione audio.

   Se invece selezioni Disattiva i risultati simili, si apre la pagina Crea regola di silenziamento, in cui puoi creare una regola di silenziamento per i risultati dello stesso tipo o che includono lo stesso attributo Indicator.

gcloud

1. Nella console Google Cloud , attiva Cloud Shell.

   Attiva Cloud Shell

   Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

2. Per impostare lo stato di disattivazione di un problema su MUTED, utilizza il 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, ad 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 padre

   • LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, utilizza il valore global

   • SOURCE_ID: l'ID origine

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

Go

import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

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

public class SetMuteFinding {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the variables within {}
    // findingPath: The relative resource name of the finding. See:
    // https://cloud.google.com/apis/design/resource_names#relative_resource_name
    // Use any one of the following formats:
    //  - organizations/{org_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //
    String findingPath = "{path-to-the-finding}";

    setMute(findingPath);
  }

  // Mute an individual finding.
  // If a finding is already muted, muting it again has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
  public static Finding setMute(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      SetMuteRequest setMuteRequest =
          SetMuteRequest.newBuilder()
              // Relative path for the finding.
              .setName(findingPath)
              .setMute(Mute.MUTED)
              .build();

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

Python

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

    client = securitycenter_v2.SecurityCenterClient()

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

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

REST

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

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 padre (organizations, folders o projects).
• PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto padre.
• LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, utilizza il valore global

• SOURCE_ID: l'ID numerico dell'origine.

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

• 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, ad esempio projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Dopo aver disattivato una scoperta, l'attributo mute viene impostato su MUTED.

Riattivare singoli risultati

Puoi riattivare l'audio di un singolo risultato staticamente utilizzando la console Google Cloud , gcloud CLI o l'API Security Command Center.

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

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 non influenzano i risultati riattivati dagli utenti.

Per un esempio di codice campione per riattivare un risultato, vedi Riattivare un risultato.

Console

Per riattivare l'audio di un singolo risultato utilizzando la console Google Cloud , fai clic sulla scheda del tuo livello di servizio:

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

   Vai a Risultati

2. Se necessario, seleziona il tuo progetto Google Cloud o la tua organizzazione. Si apre la pagina Risultati con la query predefinita visualizzata nella sezione Anteprima della query. La query predefinita filtra i risultati disattivati, quindi devi modificarla prima che i risultati disattivati vengano visualizzati nel riquadro Risultati query sui risultati.
3. A destra della sezione Anteprima query, fai clic su Modifica query per aprire l'editor di query.
4. Nel campo Editor di query, sostituisci l'istruzione di disattivazione audio esistente con la seguente:

   mute="MUTED"

5. Fai clic su Applica. I risultati nel riquadro Risultati query sui risultati vengono aggiornati in modo da includere solo i risultati disattivati.
6. Se necessario, filtra gli altri risultati disattivati. Ad esempio, nel riquadro Filtri rapidi, in Categoria, seleziona il nome del risultato che devi riattivare per filtrare tutte le altre categorie di risultati.
7. Seleziona il risultato che vuoi riattivare. Puoi selezionare uno o più risultati.
8. Nella barra delle azioni Risultati della query sui risultati, fai clic su Opzioni di disattivazione e poi seleziona Applica override di riattivazione. L'attributo mute per i risultati selezionati è impostato su UNMUTED e il risultato viene rimosso dal riquadro Risultati della query sui risultati. In alternativa, puoi riattivare l'audio di un risultato dal relativo riquadro dei dettagli:
9. Nel riquadro Risultati della query sui risultati della pagina Risultati, nella colonna Categoria, fai clic sul nome di un singolo risultato. Viene visualizzato il riquadro dei dettagli del problema.
10. Fai clic su Passa all'azione.
11. Dal menu Passa all'azione, seleziona Applica override riattivazione audio.

gcloud

1. Nella console Google Cloud , attiva Cloud Shell.

   Attiva Cloud Shell

   Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

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

   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 dei risultati, utilizza l'API Security Command Center per elencare i risultati. L'ID risultato è l'ultima parte dell'attributo canonicalName, ad 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 padre

   • LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, utilizza il valore global

   • SOURCE_ID: l'ID origine

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

Go

import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

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

public class SetUnmuteFinding {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the variables within {}
    // findingPath: The relative resource name of the finding. See:
    // https://cloud.google.com/apis/design/resource_names#relative_resource_name
    // Use any one of the following formats:
    //  - organizations/{org_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //
    String findingPath = "{path-to-the-finding}";

    setUnmute(findingPath);
  }

  // Unmute an individual finding.
  // Unmuting a finding that isn't muted has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
  public static Finding setUnmute(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

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

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

Python

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

    client = securitycenter_v2.SecurityCenterClient()

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

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

REST

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

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 padre
• LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, utilizza il valore global

• SOURCE_ID: l'ID numerico dell'origine

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

• 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, ad esempio projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

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

Rimuovere l'override dello stato di disattivazione dai singoli risultati

Applichi un override dello stato di disattivazione quando modifichi intenzionalmente lo stato di disattivazione di un risultato per disattivarlo o riattivarlo in modo statico. Ad esempio, potresti voler applicare una sostituzione dello stato di silenziamento per nascondere un risultato di gravità bassa per il quale non vale la pena creare una regola di silenziamento dinamica.

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

Prima di rimuovere l'override dello stato di disattivazione da un risultato, tieni presente quanto segue:

• Un risultato ha un override dello stato di disattivazione se è disattivato o riattivato in modo statico. Puoi applicare l'override dello stato di disattivazione a qualsiasi risultato manualmente o automaticamente con regole di disattivazione statiche.
• Un override dello stato di disattivazione si applica a un risultato per un periodo di tempo indefinito e ha la priorità su qualsiasi regola di disattivazione corrispondente.
• 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.
• La rimozione dell'override dello stato di disattivazione da un risultato è diversa dalla riattivazione di un risultato. Quando riattivi un risultato (applichi una sostituzione della disattivazione), le regole di disattivazione non possono disattivare quel risultato finché non hai rimosso manualmente la sostituzione dello stato di disattivazione.

Per rimuovere l'override della disattivazione dell'audio da un singolo risultato:

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. A destra della sezione Anteprima query, fai clic su Modifica query per aprire l'editor di query.
4. Nel campo Editor di query, sostituisci l'istruzione di disattivazione audio esistente con la seguente:

   mute="MUTED" OR mute="UNMUTED"

5. Fai clic su Applica. I risultati nel riquadro Risultati della query sui risultati vengono aggiornati in modo da includere i risultati disattivati e riattivati staticamente.
6. Se necessario, filtra gli altri risultati. Ad esempio, nel riquadro Filtri rapidi, seleziona il nome del risultato che devi reimpostare per filtrare tutte le altre categorie di risultati.
7. Seleziona il risultato che vuoi reimpostare. Puoi selezionare uno o più risultati.
8. Nella barra delle azioni Risultati della query sui risultati, fai clic su Opzioni di disattivazione e poi seleziona Rimuovi override di disattivazione. L'attributo mute per i risultati selezionati è impostato su UNDEFINED e il risultato viene rimosso dal riquadro Risultati della query sui risultati. In alternativa, puoi riattivare l'audio di un risultato dal relativo riquadro dei dettagli:
9. Nel riquadro Risultati della query sui risultati della pagina Risultati, nella colonna Categoria, fai clic sul nome di un singolo risultato. Viene visualizzato il riquadro dei dettagli del problema.
10. Fai clic su Passa all'azione.
11. Dal menu Passa all'azione, seleziona Rimuovi sostituzioni silenziamento.

gcloud

1. Nella console Google Cloud , attiva Cloud Shell.

   Attiva Cloud Shell

   Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

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

   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 risultato che vuoi reimpostare

     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, ad 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 padre

   • LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, utilizza il valore global

   • SOURCE_ID: l'ID origine

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

REST

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

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 padre
• LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, utilizza il valore global
• SOURCE_ID: l'ID numerico dell'origine

Java

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

public class SetMuteUndefinedFinding {

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

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

  // Reset mute state of an individual finding.
  // If a finding is already reset, resetting it again has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE/UNDEFINED.
  public static Finding setMuteUndefined(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs
    // to be created once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

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

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

Disattivare o reimpostare più risultati esistenti

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

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

• Rimuovi l'override dello stato di disattivazione su più risultati esistenti. Se rimuovi l'override dello stato di disattivazione di un risultato, reimposti lo stato di disattivazione da MUTED (disattivato staticamente) o UNMUTED (riattivato staticamente) a UNDEFINED. Questa funzionalità può essere utile se esegui la migrazione dalle regole di disattivazione statiche a quelle dinamiche.

Specifica l'insieme di risultati che devi disattivare definendo un filtro di risultati. 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, le operazioni di disattivazione collettiva sono limitate all'ambito della località di Security Command Center in cui vengono eseguite.

Attenzione :le operazioni di disattivazione collettiva possono scadere se tenti di disattivare più di circa 4.000.000 di risultati esistenti o se l'operazione richiede più di 6 ore. Se devi disattivare milioni di risultati esistenti, valuta la possibilità di suddividere l'operazione di disattivazione utilizzando più query di ricerca che corrispondono a un numero inferiore di risultati.

Nota: i risultati appartenenti alla classe di risultati SCC errors segnalano problemi che impediscono a Security Command Center di funzionare come previsto. Per questo motivo, i risultati degli errori non possono essere disattivati. Per saperne di più, vedi Panoramica degli errori di Security Command Center.

Per un codice campione che disattiva collettivamente i risultati, vedi Disattivare collettivamente i risultati.

Per disattivare o reimpostare i risultati in blocco, fai clic sulla scheda relativa alla procedura che vuoi utilizzare:

Console

Nella console Google Cloud , puoi disattivare in blocco i risultati solo creando regole di disattivazione. Nella consoleGoogle Cloud , la creazione di regole di disattivazione disattiva i risultati esistenti e futuri.

gcloud

1. Nella console Google Cloud , attiva Cloud Shell.

   Attiva Cloud Shell

   Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

2. Per disattivare o reimpostare più risultati in blocco, esegui il comando gcloud 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 silenziamento, organization, folder o project.
   • PARENT_ID: l'ID numerico dell'organizzazione, della cartella o del progetto padre oppure l'ID alfanumerico del progetto padre.
   • LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, 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 con gravità bassa nel progetto internal-test, il 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 il risultato è disattivato staticamente o meno. I valori validi sono MUTED e UNDEFINED. Il valore è impostato su MUTED per impostazione predefinita. Imposta questo valore su UNDEFINED solo se stai reimpostando lo stato di disattivazione dell'audio di più risultati esistenti.

REST

Nell'API Security Command Center, utilizza il metodo findings.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:

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

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

Sostituisci quanto segue:

• PARENT: la risorsa padre (organizations, folders o projects).
• PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto padre.
• LOCATION: la posizione di Security Command Center in cui disattivare o riattivare le notifiche dei risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, 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 con gravità bassa nel progetto internal-test, il 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 il risultato è disattivato o meno. I valori validi sono MUTED o UNDEFINED. Il valore è impostato su MUTED per impostazione predefinita. Imposta questo valore su UNDEFINED solo se stai reimpostando lo stato di disattivazione di più risultati esistenti.

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

La disattivazione dei risultati non ne modifica lo stato. Se i risultati attivi vengono disattivati, sono nascosti, ma rimangono attivi finché non vengono risolte le vulnerabilità, le configurazioni errate o le minacce sottostanti.

Visualizza i risultati disattivati nella console Google Cloud

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

Ad esempio, la seguente query sui risultati mostra solo i risultati attivi che sono disattivati:

state="ACTIVE"
AND mute="MUTED"

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

state="ACTIVE"

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

Visualizzare i risultati silenziati per tipo di regola di silenziamento

Le sezioni seguenti descrivono come eseguire query sui risultati attivi per tipo di regola di silenziamento.

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

Risultati della query disattivati dalle regole di disattivazione statica

Per visualizzare i risultati attivi che sono stati silenziati da una regola di silenziamento statica dopo un periodo di tempo specificato, utilizza la seguente query e controlla l'attributo muteInitiator per determinare se il risultato è stato silenziato da una regola di silenziamento statica.

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

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

Risultati delle query disattivati dalle regole di disattivazione dinamica

Per visualizzare i risultati attivi che sono stati silenziati da una regola di silenziamento dinamica dopo un periodo di tempo specificato, 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 di data e ora che indica l'inizio del periodo di tempo per cui vuoi eseguire la query. Per informazioni sui formati dell'ora, vedi gcloud topic datetimes.
• PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto padre, specificato nel formato organizations/123, folders/456 o projects/789.
• CONFIG_ID: il nome della regola di silenziamento. L'ID deve utilizzare caratteri alfanumerici e trattini e deve essere compreso tra 1 e 63 caratteri.

Per saperne di più sulla modifica delle query sui risultati, consulta Creare o modificare una query sui risultati nella dashboard.

Interrompere le notifiche e le esportazioni dei risultati disattivati

Se attivi le notifiche sui risultati, i risultati silenziati nuovi o aggiornati che corrispondono ai filtri di notifica vengono comunque esportati in Pub/Sub.

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

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