Disattivare singoli risultati

Standard-legacy, Standard, Premium ed Enterprise (obsoleto)

La disattivazione statica in Security Command Center ti consente di nascondere singoli risultati o gruppi di risultati dai risultati delle query senza modificare il loro stato attivo. Questa funzionalità ti aiuta a ridurre il rumore nella visualizzazione dei risultati, a chiudere i casi di combinazioni tossiche corrispondenti e a escludere i risultati disattivati dalle notifiche. Puoi anche riattivare i risultati, eseguire l'override delle regole di silenziamento dinamico o reimpostare gli override di silenziamento.

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:

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.

Disattiva l'audio di un singolo risultato

Puoi disattivare staticamente un singolo risultato utilizzando la consoleGoogle Cloud , gcloud CLI 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 finché la vulnerabilità, l'errore di configurazione o la minaccia sottostante non viene risolta. Inoltre, se disattivi staticamente un risultato, esegui l'override di tutte le regole di silenziamento dinamica applicabili al risultato.

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

Per silenziare tutti i risultati futuri che corrispondono ai criteri specificati, consulta Gestisci le regole di silenziamento.

Per un codice campione per disattivare un risultato, consulta Disattiva un risultato.

Per disattivare l'audio di un singolo risultato in modo statico, fai clic sulla scheda della procedura che 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. Se non vedi il risultato che devi disattivare nel riquadro Risultati delle query sui risultati, seleziona la categoria del risultato nella sezione Categoria del riquadro Filtri rapidi.
  4. Seleziona il risultato da disattivare. Puoi selezionare uno o più risultati.
  5. Nella barra delle azioni Risultati della query sui risultati, fai clic su Opzioni di silenziamento e poi seleziona Applica override di silenziamento.

    L'attributo mute per i risultati selezionati è impostato su MUTED e il risultato viene rimosso dal riquadro Risultati delle 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 risultato.

  7. Fai clic su Passa all'azione.

  8. Dal menu Esegui azione, seleziona Applica override disattivazione audio.

    Se invece selezioni Silenzia risultati come questo, si apre la pagina Crea regola di silenziamento, dove 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 risultato 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 principale (project, folder o organization), sensibile alle maiuscole

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

    • LOCATION: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global

    • SOURCE_ID: l'ID origine

      Per istruzioni su come recuperare un ID origine, consulta Recupero dell'ID origine.

Vai

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 principale.
  • LOCATION: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global
  • SOURCE_ID: l'ID numerico dell'origine.

    Per istruzioni su come recuperare un ID origine, consulta Recupero dell'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 un risultato, il relativo attributo mute viene impostato su MUTED.

Riattiva i singoli risultati

Puoi riattivare l'audio di un singolo risultato in modo statico 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 riattivati vengono disattivati di nuovo solo se vengono disattivati manualmente. Le regole di silenziamento create con gcloud CLI o l'API Security Command Center non influiscono sui risultati riattivati dagli utenti.

Per un codice campione per riattivare l'audio di un risultato, consulta Riattiva l'audio di 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 ai 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 della query. La query predefinita filtra i risultati disattivati, quindi devi modificarla prima che i risultati disattivati vengano visualizzati nel pannello 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 mute esistente con quanto segue:
    mute="MUTED"
  5. Fai clic su Applica. I risultati nel riquadro Risultati delle query sui risultati vengono aggiornati per 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 silenziamento 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 delle 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 risultato.
  10. Fai clic su Passa all'azione.
  11. Dal menu Passa all'azione, seleziona Applica override di 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 risultato 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 principale (project, folder o organization), sensibile alle maiuscole

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

    • LOCATION: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global

    • SOURCE_ID: l'ID origine

      Per istruzioni su come recuperare un ID origine, consulta Recupero dell'ID origine.

Vai


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 l'audio di 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 principale
  • LOCATION: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global
  • SOURCE_ID: l'ID numerico dell'origine

    Per istruzioni su come recuperare un ID origine, consulta Recupero dell'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.

Rimuovi un 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 un override dello stato di silenziamento per nascondere un risultato di gravità bassa per cui non vale la pena creare una regola di silenziamento dinamica.

Puoi rimuovere l'override dello stato di disattivazione da 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 un override dello stato di silenziamento a qualsiasi risultato manualmente o automaticamente con regole di silenziamento statiche.
  • Un override dello stato di silenziamento si applica a un risultato a tempo indeterminato e ha la precedenza su qualsiasi regola di silenziamento corrispondente.
  • La rimozione dell'override dello stato di silenziamento da un risultato reimposta lo stato di silenziamento del risultato in modo che possa essere elaborato da regole di silenziamento 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 un override di riattivazione), le regole di silenziamento non possono silenziare il risultato finché non rimuovi manualmente l'override dello stato di silenziamento.

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

Console

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

    Vai ai 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 mute esistente con quanto segue:
    mute="MUTED" OR mute="UNMUTED"
  5. Fai clic su Applica. I risultati nel riquadro Risultati delle query sui risultati vengono aggiornati per includere i risultati disattivati e riattivati staticamente.
  6. Se necessario, filtra gli altri risultati. Ad esempio, nel riquadro Filtri rapidi in Categoria, 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 silenziamento e poi seleziona Rimuovi override di silenziamento. L'attributo mute per i risultati selezionati è impostato su UNDEFINED e il risultato viene rimosso dal riquadro Risultati delle 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 risultato.
  10. Fai clic su Passa all'azione.
  11. Dal menu Passa all'azione, seleziona Rimuovi override di disattivazione 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 risultato 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 principale (project, folder o organization), sensibile alle maiuscole

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

    • LOCATION: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global

    • SOURCE_ID: l'ID origine

      Per istruzioni su come recuperare un ID origine, consulta Recupero dell'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 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": "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: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, 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;
    }
  }
}

Disattiva o reimposta più risultati esistenti

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

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

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

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

Se la residenza dei dati è abilitata per Security Command Center, le operazioni di disattivazione collettiva sono limitate alla località di Security Command Center in cui vengono eseguite.

Per un codice campione che disattiva i risultati collettivamente, consulta Disattiva i risultati collettivamente.

Per disattivare o reimpostare i risultati collettivamente, fai clic sulla scheda della procedura che vuoi utilizzare:

Console

Nella console Google Cloud , puoi silenziare i risultati in blocco solo creando regole di silenziamento. Nella consoleGoogle Cloud , la creazione di regole di silenziamento 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 contemporaneamente, 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 principale o l'ID alfanumerico del progetto principale.
    • LOCATION: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global.
    • FILTER: l'espressione che definisci per filtrare i risultati.

      Ad esempio, per disattivare l'audio di 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 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 principale.
  • LOCATION: la località di Security Command Center in cui disattivare o riattivare i risultati; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global.
  • FILTER: l'espressione che definisci per filtrare i risultati.

    Ad esempio, per disattivare l'audio di 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 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, vengono 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 dei risultati 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, 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 silenziati per tipo di regola di silenziamento

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

Per saperne di più su come elencare risultati specifici, consulta Filtra i risultati.

Esegui query sui risultati disattivati dalle regole di silenziamento statico

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 di ora, consulta gcloud topic datetimes.

Esegui query sui risultati disattivati dalle regole di silenziamento dinamico

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, consulta gcloud topic datetimes.
  • PARENT_ID: l'ID dell'organizzazione, della cartella o del progetto principale, 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 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.

Interrompi le notifiche e le esportazioni dei risultati disattivati

Se attivi le notifiche sui risultati, i risultati disattivati 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\""