Silencia resultados individuales

En este documento, se explica cómo silenciar de forma estática hallazgos individuales, dejar de silenciarlos o silenciarlos de forma masiva en Security Command Center.

Roles obligatorios

Para obtener los permisos que necesitas para silenciar o reactivar hallazgos, pídele a tu administrador que te otorgue los siguientes roles de IAM en la organización, la carpeta o el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Silenciar un hallazgo individual

Puedes silenciar estáticamente un hallazgo individual con la consola deGoogle Cloud , la gcloud CLI o la API de Security Command Center.

Silenciar un hallazgo de forma estática no afecta si está activo o no. Si se silencia un hallazgo activo, el atributo state no se modifica: state="ACTIVE". El hallazgo se oculta, pero permanece activo hasta que se resuelve la vulnerabilidad, la configuración incorrecta o la amenaza subyacentes. Además, si silencias un hallazgo de forma estática, anularás cualquier regla de silenciamiento dinámica que se aplique al hallazgo.

Silenciar un hallazgo de combinación tóxica cierra el caso de combinación tóxica correspondiente.

Para silenciar todos los resultados futuros que coincidan con los criterios que especifiques, consulta Cómo administrar las reglas de silencio.

Para ver un código de muestra para silenciar un hallazgo, consulta Cómo silenciar un hallazgo.

Para silenciar de forma estática un hallazgo individual, haz clic en la pestaña del procedimiento que deseas usar:

Console

  1. En la consola de Google Cloud , ve a la página Resultados de Security Command Center.

    Ir a hallazgos

  2. Si es necesario, selecciona tu Google Cloud organización o proyecto.
  3. Si no ves el hallazgo que necesitas silenciar en el panel Resultados de la búsqueda, selecciona la categoría del hallazgo en la sección Categoría del panel Filtros rápidos.
  4. Selecciona el hallazgo que necesitas silenciar. Puedes seleccionar uno o más hallazgos.
  5. En la barra de acciones Resultados de la búsqueda, haz clic en Opciones para silenciar y, luego, selecciona Aplicar anulación de silencio.

    El atributo mute para los resultados seleccionados se establece en MUTED y el resultado se quita del panel Resultados de la búsqueda. Como alternativa, puedes silenciar un hallazgo desde su panel de detalles:

  6. En el panel Resultados de la búsqueda de la página Resultados, en la columna Categoría, haz clic en el nombre de un resultado individual. Se abrirá el panel de detalles del hallazgo.

  7. Haz clic en Tomar medidas.

  8. En el menú Tomar medidas, selecciona Anular el silencio.

    Si seleccionas Silenciar los resultados como este, se abrirá la página Crear regla de silenciamiento, en la que podrás crear una regla de silenciamiento para los resultados del mismo tipo o que incluyan el mismo atributo Indicator.

gcloud

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Para establecer el estado de silenciamiento de un hallazgo en MUTED, usa el comando set-mute en gcloud CLI:

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

    Reemplaza lo siguiente:

    • FINDING_ID: Es el ID del resultado que deseas silenciar

      Para recuperar los IDs de los resultados, usa la API de Security Command Center para listar los resultados. El ID de hallazgo es la última parte del atributo canonicalName, por ejemplo, projects/123456789012/sources/1234567890123456789/findings`/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: El recurso principal (project, folder o organization), distingue entre mayúsculas y minúsculas.

    • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal.

    • LOCATION: Ubicación de Security Command Center en la que se silenciarán o reactivarán los resultados. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.

    • SOURCE_ID: El ID de origen

      Para obtener instrucciones sobre cómo recuperar un ID de origen, consulta Obtén el ID de origen.

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

En la API de Security Command Center, usa el método findings.setMute para silenciar un hallazgo. El cuerpo de la solicitud es una enumeración que indica el estado de silenciamiento resultante:

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

{
  "mute": "MUTED"
}

Reemplaza lo siguiente:

  • PARENT: Es el recurso principal (organizations, folders o projects).
  • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal.
  • LOCATION: Ubicación de Security Command Center en la que se silenciarán o reactivarán los resultados. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.
  • SOURCE_ID: Es el ID numérico de la fuente.

    Para obtener instrucciones sobre cómo recuperar un ID de origen, consulta Obtén el ID de origen.

  • FINDING_ID: Es el ID del hallazgo que deseas silenciar.

    Para recuperar los IDs de los resultados, usa la API de Security Command Center para listar los resultados. El ID de hallazgo es la última parte del atributo canonicalName, por ejemplo, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Después de silenciar un hallazgo, su atributo mute se establece en MUTED.

Deja de silenciar resultados individuales

Puedes quitar el silencio de un hallazgo individual de forma estática con la Google Cloud consola, la gcloud CLI o la API de Security Command Center.

Dejar de silenciar un hallazgo es útil cuando necesitas evitar que una regla de silenciamiento demasiado amplia oculte un hallazgo o cuando una regla es demasiado compleja para modificarla y excluir los hallazgos que consideras importantes.

Los resultados que se dejaron de silenciar se vuelven a silenciar solo si se silencian de forma manual. Las reglas de silenciamiento creadas con la gcloud CLI o la API de Security Command Center no afectarán los resultados que los usuarios dejen de silenciar.

Para ver un código de muestra para reactivar el audio de un hallazgo, consulta Cómo reactivar el audio de un hallazgo.

Console

Para reactivar el audio de un hallazgo individual con la consola de Google Cloud , haz clic en la pestaña de tu nivel de servicio:

  1. En la consola de Google Cloud , ve a la página Resultados de Security Command Center.

    Ir a hallazgos

  2. Si es necesario, selecciona tu Google Cloud organización o proyecto. Se abrirá la página Hallazgos con la consulta predeterminada que se muestra en la sección Vista previa de consulta. La consulta predeterminada filtra los hallazgos silenciados, por lo que debes editarla antes de que aparezcan en el panel Resultados de la consulta de hallazgos.
  3. A la derecha de la sección Vista previa de la consulta, haz clic en Editar consulta para abrir el Editor de consultas.
  4. En el campo Editor de consultas, reemplaza la sentencia de silencio existente por la siguiente:
    mute="MUTED"
  5. Haz clic en Aplicar. Los hallazgos del panel Resultados de la búsqueda se actualizan para incluir solo los hallazgos silenciados.
  6. Si es necesario, filtra otros hallazgos silenciados. Por ejemplo, en el panel Filtros rápidos, en Categoría, selecciona el nombre del hallazgo que necesitas reactivar para filtrar todas las demás categorías de hallazgos.
  7. Selecciona el hallazgo que quieras reactivar. Puedes seleccionar uno o más hallazgos.
  8. En la barra de acciones Resultados de la búsqueda, haz clic en Opciones para silenciar y, luego, selecciona Aplicar anulación de silencio. El atributo mute para los resultados seleccionados se establece en UNMUTED y el resultado se quita del panel Resultados de la búsqueda. Como alternativa, puedes reactivar un hallazgo desde su panel de detalles:
  9. En el panel Resultados de la búsqueda de la página Resultados, en la columna Categoría, haz clic en el nombre de un resultado individual. Se abrirá el panel de detalles del hallazgo.
  10. Haz clic en Tomar medidas.
  11. En el menú Tomar medidas, selecciona Anular el silencio.

gcloud

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Para establecer el estado de silenciamiento de un hallazgo en UNMUTED, usa el comando set-mute en gcloud CLI:

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

    Reemplaza lo siguiente:

    • FINDING_ID: Es el ID del resultado que deseas silenciar

      Para recuperar los IDs de los resultados, usa la API de Security Command Center para listar los resultados. El ID de hallazgo es la última parte del atributo canonicalName, por ejemplo, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: El recurso principal (project, folder o organization), distingue entre mayúsculas y minúsculas.

    • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal.

    • LOCATION: Ubicación de Security Command Center en la que se silenciarán o reactivarán los resultados. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.

    • SOURCE_ID: El ID de origen

      Para obtener instrucciones sobre cómo recuperar un ID de origen, consulta Obtén el ID de origen.

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

En la API de Security Command Center, usa el método findings.setMute para reactivar un resultado. El cuerpo de la solicitud es una enumeración que indica el estado de silenciamiento resultante:

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

{
  "mute": "UNMUTED"
}

Reemplaza lo siguiente:

  • PARENT: El recurso superior (organizations, folders o projects)
  • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal.
  • LOCATION: Ubicación de Security Command Center en la que se silenciarán o reactivarán los resultados. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.
  • SOURCE_ID: Es el ID numérico del origen

    Para obtener instrucciones sobre cómo recuperar un ID de origen, consulta Obtén el ID de origen.

  • FINDING_ID: Es el ID del hallazgo que deseas silenciar.

    Para recuperar los IDs de los resultados, usa la API de Security Command Center para listar los resultados. El ID de hallazgo es la última parte del atributo canonicalName, por ejemplo, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Los resultados seleccionados ya no están ocultos y el atributo mute para los resultados se establece en UNMUTED.

Cómo quitar la anulación del estado de silencio de resultados individuales

Aplicas una anulación del estado de silenciamiento cuando modificas intencionalmente el estado de silenciamiento de un hallazgo para silenciarlo o reactivarlo de forma estática. Por ejemplo, es posible que desees aplicar una anulación del estado de silenciamiento para ocultar un hallazgo de gravedad baja para el que no vale la pena crear una regla de silenciamiento dinámica.

Puedes quitar la anulación del estado de silencio de un hallazgo individual con la consola de Google Cloud , gcloud CLI o la API de Security Command Center.

Antes de quitar la anulación del estado de silencio de un hallazgo, debes comprender lo siguiente:

  • Un hallazgo tiene una anulación del estado de silenciamiento si se silenció o activó su sonido de forma estática. Puedes aplicar una anulación del estado de silenciamiento a cualquier hallazgo de forma manual o automática con reglas de silenciamiento estáticas.
  • Una anulación del estado de silenciamiento se aplica a un hallazgo de forma indefinida y tiene prioridad sobre cualquier regla de silenciamiento coincidente.
  • Si quitas la anulación del estado de silenciamiento de un hallazgo, se restablece su estado de silenciamiento para que las reglas de silenciamiento estáticas o dinámicas puedan procesarlo.
  • Quitar la anulación del estado de silencio de un hallazgo es diferente a dejar de silenciarlo. Cuando dejas de silenciar un hallazgo (aplicar una anulación de silenciamiento), las reglas de silenciamiento no pueden silenciar ese hallazgo hasta que quites manualmente la anulación del estado de silenciamiento.

Para quitar la anulación de silencio de un hallazgo individual, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Resultados de Security Command Center.

    Ir a hallazgos

  2. Selecciona tu Google Cloud organización o proyecto.
  3. A la derecha de la sección Vista previa de la consulta, haz clic en Editar consulta para abrir el Editor de consultas.
  4. En el campo Editor de consultas, reemplaza la sentencia de silencio existente por la siguiente:
    mute="MUTED" OR mute="UNMUTED"
  5. Haz clic en Aplicar. Los hallazgos en el panel Resultados de la búsqueda se actualizan para incluir los hallazgos silenciados y no silenciados de forma estática.
  6. Si es necesario, filtra otros hallazgos. Por ejemplo, en el panel Filtros rápidos, en Categoría, selecciona el nombre del hallazgo que necesitas restablecer para filtrar todas las demás categorías de hallazgos.
  7. Selecciona el hallazgo que deseas restablecer. Puedes seleccionar uno o más hallazgos.
  8. En la barra de acciones de Resultados de la búsqueda de hallazgos, haz clic en Opciones para silenciar y, luego, selecciona Quitar anulaciones de silencio. El atributo mute para los resultados seleccionados se establece en UNDEFINED y el resultado se quita del panel Resultados de la búsqueda. Como alternativa, puedes reactivar un hallazgo desde su panel de detalles:
  9. En el panel Resultados de la búsqueda de la página Resultados, en la columna Categoría, haz clic en el nombre de un resultado individual. Se abrirá el panel de detalles del hallazgo.
  10. Haz clic en Tomar medidas.
  11. En el menú Tomar medidas, selecciona Quitar anulaciones de silencio.

gcloud

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Para establecer el estado de silenciamiento de un hallazgo en UNDEFINED, usa el comando set-mute en gcloud CLI:

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

    Reemplaza lo siguiente:

    • FINDING_ID: Es el ID del hallazgo que deseas restablecer.

      A fin de recuperar los ID de resultados, usa la API de Security Command Center para mostrar una lista de resultados. El ID de hallazgo es la última parte del atributo canonicalName, por ejemplo, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: El recurso principal (project, folder o organization), distingue entre mayúsculas y minúsculas.

    • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal.

    • LOCATION: Ubicación de Security Command Center en la que se silenciarán o reactivarán los resultados. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.

    • SOURCE_ID: El ID de origen

      Para obtener instrucciones sobre cómo recuperar un ID de origen, consulta Obtén el ID de origen.

REST

En la API de Security Command Center, usa el método findings.setMute para restablecer el estado de silencio de un hallazgo. El cuerpo de la solicitud es una enumeración que indica el estado de silenciamiento resultante:

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

{
  "mute": "UNDEFINED"
}

Reemplaza lo siguiente:

  • PARENT: El recurso superior (organizations, folders o projects)
  • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal.
  • LOCATION: Ubicación de Security Command Center en la que se silenciarán o reactivarán los resultados. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.
  • SOURCE_ID: Es el ID numérico del origen

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

Cómo silenciar o restablecer varios hallazgos existentes

Puedes realizar las siguientes operaciones de silencio masivo para varios hallazgos existentes con el comando de gcloud scc findings bulk-mute de gcloud CLI o el método bulkMute de la API de Security Command Center:

  • Silencia varios hallazgos existentes. Si silencias de forma masiva los hallazgos existentes, se silenciarán estáticamente y se anularán las reglas de silenciamiento dinámico que se apliquen al hallazgo. Si necesitas silenciar resultados similares futuros, crea una regla de silenciamiento.

  • Quita la anulación del estado de silenciamiento en varios hallazgos existentes. Si quitas la anulación del estado de silenciamiento en un hallazgo, restableces el estado de silenciamiento de MUTED (silenciado de forma estática) o UNMUTED (sin silenciar de forma estática) a UNDEFINED. Esta capacidad puede ser útil si migras de reglas de silenciamiento estáticas a dinámicas.

Especifica el conjunto de hallazgos que necesitas silenciar definiendo un filtro de hallazgos. Los filtros de silenciamiento masivo no son compatibles con todas las propiedades de los resultados. Para obtener una lista de las propiedades no compatibles, consulta Propiedades de hallazgos no compatibles con las reglas de silenciamiento.

Si la residencia de datos está habilitada para Security Command Center, el alcance de las operaciones de silenciamiento masivo se limita a la ubicación de Security Command Center en la que se ejecutan.

Para ver un código de muestra que silencia resultados de forma masiva, consulta Silencia resultados de forma masiva.

Para silenciar o restablecer hallazgos de forma masiva, haz clic en la pestaña del procedimiento que quieras usar:

Console

En la consola de Google Cloud , solo puedes silenciar resultados de forma masiva mediante la creación de reglas de silencio. En la consola deGoogle Cloud , la creación de reglas de silenciamiento silencia los resultados existentes y futuros.

gcloud

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Para silenciar o restablecer varios hallazgos de forma masiva, ejecuta el comando gcloud scc findings bulk-mute:

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

    Reemplaza lo siguiente:

    • PARENT: Es el alcance en la jerarquía de recursos al que se aplica la regla de silenciamiento: organization, folder o project.
    • PARENT_ID: Es el ID numérico de la organización, la carpeta o el proyecto principal, o bien el ID alfanumérico del proyecto principal.
    • LOCATION: Es la ubicación de Security Command Center en la que se silenciarán o reactivarán los hallazgos. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.
    • FILTER: Es la expresión que defines para filtrar los resultados.

      Por ejemplo, para silenciar todos los resultados OPEN_FIREWALL y PUBLIC_IP_ADDRESS de gravedad baja existentes en el proyecto internal-test, el filtro puede ser "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.projectDisplayName=\"internal-test\"".

    • MUTE_STATE: Es el valor que indica si el hallazgo está silenciado de forma estática o no. Los valores válidos son MUTED y UNDEFINED. El valor se establece en MUTED de forma predeterminada. Solo establece este valor en UNDEFINED si restableces el estado de silencio de varios hallazgos existentes.

REST

En la API de Security Command Center, usa el método findings.bulkMute para silenciar o restablecer el estado de silencio de varios resultados existentes. El cuerpo de la solicitud contiene la expresión que se usa para filtrar los hallazgos:

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

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

Reemplaza lo siguiente:

  • PARENT: Es el recurso principal (organizations, folders o projects).
  • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal.
  • LOCATION: Es la ubicación de Security Command Center en la que se silenciarán o reactivarán los hallazgos. Si la residencia de datos está habilitada, usa eu, sa o us. De lo contrario, usa el valor global.
  • FILTER: Es la expresión que defines para filtrar los resultados.

    Por ejemplo, para silenciar todos los resultados OPEN_FIREWALL y PUBLIC_IP_ADDRESS de gravedad baja existentes en el proyecto internal-test, el filtro puede ser "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.projectDisplayName=\"internal-test\"".

  • MUTE_STATE: Es el valor que indica si el hallazgo está silenciado o no. Los valores válidos son MUTED o UNDEFINED. El valor se establece en MUTED de forma predeterminada. Solo establece este valor en UNDEFINED si restableces el estado de silenciamiento de varios hallazgos existentes.

Se ocultan todos los resultados existentes en el recurso que selecciones y que coincidan con exactitud con el filtro. El atributo mute para los resultados se establece en MUTED.

Silenciar los resultados no cambia su estado. Si silencias los resultados activos, se ocultan, pero permanecen activos hasta que se resuelven las vulnerabilidades, las configuraciones incorrectas o las amenazas subyacentes.

Visualiza los hallazgos silenciados en la consola de Google Cloud

Puedes ver los hallazgos silenciados en la consola Google Cloud si editas la consulta de hallazgos para seleccionar los hallazgos que incluyen el valor de propiedad mute="MUTED".

Por ejemplo, la siguiente consulta de resultados solo muestra los resultados activos que están silenciados:

state="ACTIVE"
AND mute="MUTED"

Para mostrar todos los hallazgos activos, tanto silenciados como no silenciados, omite el atributo mute de la consulta por completo:

state="ACTIVE"

De forma predeterminada, la consulta de resultados en la consola de Google Cloud solo muestra los resultados que no están silenciados.

Consulta los hallazgos silenciados por tipo de regla de silenciamiento

En las siguientes secciones, se describe cómo consultar los hallazgos activos por tipo de regla de silenciamiento.

Para obtener más información sobre cómo mostrar una lista de hallazgos específicos, consulta Filtra hallazgos.

Se silenciaron los hallazgos de la búsqueda con reglas de silenciamiento estáticas

Para mostrar los hallazgos activos que se silenciaron con una regla de silenciamiento estática después de un tiempo especificado, usa la siguiente consulta y, luego, inspecciona el atributo muteInitiator para determinar si el hallazgo se silenció con una regla de silenciamiento estática.

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

Reemplaza TIMESTAMP por la cadena de fecha y hora que indica el comienzo del período que deseas consultar. Para obtener información sobre los formatos de hora, consulta gcloud topic datetimes.

Hallazgos de la búsqueda silenciados por reglas de silenciamiento dinámico

Para mostrar los hallazgos activos que se silenciaron con una regla de silenciamiento dinámica después de un tiempo especificado, usa la siguiente consulta:

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

Reemplaza lo siguiente:

  • TIMESTAMP: Es la cadena de fecha y hora que indica el comienzo del período que deseas consultar. Para obtener información sobre los formatos de hora, consulta gcloud topic datetimes.
  • PARENT_ID: Es el ID de la organización, la carpeta o el proyecto principal, especificado en el formato organizations/123, folders/456 o projects/789.
  • CONFIG_ID: Es el nombre de la regla de silenciamiento. El ID debe usar caracteres alfanuméricos y guiones, y tener entre 1 y 63 caracteres.

Para obtener más información sobre cómo editar consultas de hallazgos, consulta Crea o edita una consulta de hallazgos en el panel.

Detén las notificaciones y exportaciones de los hallazgos silenciados

Si habilitas las notificaciones de hallazgos, los hallazgos silenciados nuevos o actualizados que coincidan con los filtros de notificaciones se seguirán exportando a Pub/Sub.

Para detener las exportaciones y las notificaciones de los resultados silenciados, usa el atributo mute para excluir los resultados silenciados en tu filtro NotificationConfig. Por ejemplo, el siguiente filtro solo envía notificaciones de los resultados activos que no estén silenciados o en los que el atributo de silenciamiento no se haya establecido:

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