在 Security Command Center 中忽略发现结果

本页面介绍了如何通过忽略发现结果来减少您在 Security Command Center 中收到的发现结果数量。

忽略发现结果会将其隐藏在发现结果的默认视图中，具体如下： Google Cloud 控制台。您可以手动或以编程方式忽略发现结果，并 创建过滤条件，以根据数据自动滤除现有和未来的发现结果 对您指定的条件进行调整

Security Command Center 检测服务提供针对 但您可能会发现某些发现结果 与您的组织或项目相关。大量的发现结果还可能导致安全分析师难以有效识别和消除最关键的风险。忽略发现结果可以节省您的时间 审核或响应隔离资产的安全发现结果 也不在可接受的业务参数之内

与停用检测器相比，忽略发现结果具有多项优势：

  • 您可以创建自定义过滤条件，以微调忽略哪些发现结果。
  • 忽略发现结果不会停止扫描底层资源。发现结果仍会生成，但在您决定查看它们之前会保持隐藏状态。

权限

如需忽略发现结果，您需要组织、文件夹或项目级别的以下某个 Identity and Access Management (IAM) 角色：

  • 查看忽略规则：
    • Security Center Admin Viewer (roles/securitycenter.adminViewer)
    • Security Center Settings Viewer (roles/securitycenter.settingsViewer)
    • Security Center Mute Configurations Viewer (roles/securitycenter.muteConfigsViewer)
  • 查看、创建、更新和删除忽略规则：
    • Security Center Admin (roles/securitycenter.admin)
    • Security Center Admin Editor (roles/securitycenter.adminEditor)
    • Security Center Settings Editor (roles/securitycenter.settingsEditor)
    • Security Center Mute Configurations Editor (roles/securitycenter.muteConfigsEditor)
  • 手动忽略发现结果：
    • Security Center Findings Editor (roles/securitycenter.findingsEditor)

您还可以创建和授予自定义角色 拥有以下部分或全部权限：

  • 忽略规则读取权限
    • securitycenter.muteconfigs.get
    • securitycenter.muteconfigs.list
  • 忽略规则写入权限
    • securitycenter.muteconfigs.create
    • securitycenter.muteconfigs.update
    • securitycenter.muteconfigs.delete
  • 发现结果写入权限
    • securitycenter.findings.setMute
    • securitycenter.findings.bulkMuteUpdate

您忽略发现结果的能力遵循在组织、文件夹或项目级层授予的角色。您可以忽略特定文件夹或项目中的发现结果，并限制其他人员根据他们获得的访问权限忽略发现结果的能力。例如，如果您有权访问单个项目，则只能忽略该项目中的发现结果。如果您有权访问某一文件夹，则可以忽略该文件夹内任何子文件夹或项目中的发现结果。

如需详细了解 Security Command Center 角色，请参阅访问权限控制。

创建和管理忽略规则

忽略规则是 Security Command Center 配置，它们使用您创建的过滤条件，根据您指定的条件自动忽略未来的发现结果。匹配忽略过滤条件的新发现结果将持续自动忽略。如果您还希望忽略类似的现有发现结果，请使用相同的过滤条件批量忽略发现结果。

忽略规则的范围

在创建过滤器时，请考虑忽略规则的范围。

例如，如果编写了一个过滤条件来忽略 Project A 中的发现结果，但 过滤条件本身是在 Project B 下创建的，则该过滤条件可能不匹配 任何发现结果。

同样，如果数据驻留 启用后，忽略规则的范围 仅限于忽略规则所在的 Security Command Center 位置 创建。例如，如果您在美国 (us) 位置，则忽略规则不会忽略存储在 欧盟 (eu) 或全球 (global) 位置。 如需详细了解数据驻留和忽略规则，请参阅 忽略规则、持续导出和数据驻留。

如需详细了解如何创建过滤条件，请参阅过滤通知。

忽略规则限制

忽略规则并不支持所有发现结果属性。如需查看忽略规则不支持的属性列表，请参阅忽略规则不支持的发现结果属性。

您可以根据自己应用的范围创建、查看、更新和删除忽略规则， IAM 角色。使用组织级层角色，您可以查看组织中所有文件夹和项目的忽略规则。如果您拥有文件夹级层角色，则可以访问和管理特定文件夹以及这些文件夹中所有子文件夹和项目的忽略规则。项目级层角色可让您管理特定项目中的忽略规则。

Security Command Center Premium 支持在组织、文件夹和项目级层授予角色。Security Command Center Standard 仅支持在组织级层授予角色。如需了解详情，请参阅访问权限控制。

数据驻留和忽略规则

如果为数据驻留 启用静音状态的 规则（muteConfig 项资源）受数据驻留的约束 并存储在 Security Command Center 位置 您选择的代码。

对 Security Command Center 中的发现结果应用忽略规则 您必须在以下位置创建忽略规则： 它应用于的发现结果所在的位置。

由于忽略规则中使用的过滤条件 可能包含受驻留控制措施、 请务必先指定正确的位置，然后再创建它们。 Security Command Center 不会限制您创建的位置 忽略规则或流式导出。

忽略规则仅存储在创建规则的位置， 可在其他位置查看或修改。

创建忽略规则后，您将无法更改其位置。 要更改位置，您需要删除 忽略规则，并在新位置重新创建该规则。

如需在 Google Cloud 控制台中查看忽略规则，您首先需要在 Google Cloud 控制台视图 已创建。

这些规则同样适用于忽略规则 MuteConfig 的 API 表示法。

如需使用 API 调用检索 MuteConfig，请执行以下操作： 您需要在实例的完整资源名称中指定位置 MuteConfig。例如：

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

同样，如需检索 muteConfig，请使用 使用 gcloud CLI 时，您可以指定 方法是使用 --locations 标志。例如：

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

创建忽略规则

您的组织最多可以创建 1,000 条忽略规则。

您可以使用 Google Cloud 控制台、 gcloud CLI 或 Security Command Center API。

如需查看用于创建忽略规则的示例代码，请参阅创建忽略规则。

要创建忽略规则，请点击您要创建的过程 使用：

控制台

  1. 在 Google Cloud 控制台中，转到 Security Command Center 发现结果页面。

    转至“发现结果”

  2. 如有必要，请选择您的 Google Cloud 项目或组织。

    项目选择器

  3. 如果为数据驻留 已启用 Security Command Center，请使用 位置选择器（位于项目选择器正下方） 需要创建忽略规则的 Security Command Center 位置。 例如：

    位置选择器的屏幕截图

  4. 点击忽略选项，然后选择创建忽略规则。

  5. 输入忽略规则 ID。必须提供此值。

  6. 输入忽略规则说明，其提供为何忽略发现结果的上下文。该值是可选的，但我们建议您使用。

    父级资源表示将创建和应用忽略规则的范围。

  7. 在发现结果查询字段中，通过点击添加过滤条件来构建查询语句。或者，您也可以输入查询 语句。

    选择过滤条件对话框允许您选择支持的发现结果特性和值。查询过滤条件对话框

    1. 选择发现结果特性或在搜索发现结果特性框中输入其名称。 系统会显示可用子特性的列表。
    2. 选择子特性。评估选项的选择字段显示在位于发现结果的查询结果面板中的发现结果的子特性值列表上方。
    3. 为所选子特性的值选择评估选项。如需详细了解评估选项及其使用的运算符和函数，请参阅“添加过滤条件”菜单中的查询运算符。
    4. 选择应用。

      对话框将会关闭，并且您的查询即会更新。

    5. 重复这些步骤，直到发现结果查询包含所需的所有特性。

  8. 查看过滤条件，以确保准确性。如需进行更改，请根据需要删除或添加属性和过滤条件值。

  9. 点击预览匹配的发现结果。

    表会显示与您的查询匹配的发现结果。

  10. 点击保存。

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 如需创建忽略规则，请运行 gcloud scc muteconfigs create 命令：

    gcloud scc muteconfigs create CONFIG_ID \
--PARENT=PARENT_ID \
--location=LOCATION
--description="RULE_DESCRIPTION" \
--filter="FILTER"

    替换以下内容：

    • CONFIG_ID：忽略规则的名称。ID 必须使用字母数字字符和连字符，并且必须介于 1 到 63 之间 字符。
    • PARENT：资源层次结构中的范围 应用忽略规则的应用：organization、folder 或 project。
    • PARENT_ID：上级组织的 ID。 文件夹或项目，并以 organizations/123、folders/456 或 projects/789。

    • LOCATION：如果启用了数据驻留， 指定 Security Command Center 位置 即可创建忽略规则忽略规则配置已存储 并且仅适用于此位置中的发现结果。

      如果未启用数据驻留，请指定 --location 标志 使用 Security Command Center API v2 创建忽略规则， 此标志的有效值为 global。

    • RULE_DESCRIPTION：静音的说明 不能超过 1,024 个字符。

    • FILTER：您定义要过滤的表达式 结果。例如，如需忽略 OPEN_FIREWALL 项发现结果，您的过滤条件 可以为 FILTER="category=\"OPEN_FIREWALL\""。

    响应中包含忽略规则 ID 更新和删除忽略规则，如管理忽略规则中所述。

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


import (
	"context"
	"fmt"
	"io"

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

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

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

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

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

Java

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class CreateMuteRule {

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

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

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

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

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

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 



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

    from google.cloud import securitycenter

    client = securitycenter.SecurityCenterClient()

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

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

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

REST API

在 Security Command Center API 中，使用 muteConfigs create 方法 创建忽略规则请求正文是 MuteConfig 的实例。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 作为预览版提供。启用数据驻留后， API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请使用版本 1 端点 以调用 muteConfigs create。 在请求正文中，使用版本 1 MuteConfig 定义：

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

  {
    "description": "RULE_DESCRIPTION",
    "filter": FILTER
  }

如果您使用的是 Security Command Center API v2，请使用版本 2 端点调用 muteConfigs create。 在请求正文中，使用版本 2 MuteConfig 定义：

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

  {
    "description": "RULE_DESCRIPTION",
    "filter": FILTER
    "type": "STATIC"
  }

替换以下内容：

  • PARENT：忽略规则的父级资源（organizations、folders 或 projects）
  • PARENT_ID：上级组织的 ID。 文件夹或项目
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 忽略规则的应用对象如果省略了位置字段 默认值为 global。
  • MUTE_CONFIG_ID：忽略规则的名称 （长度介于 1 到 63 个字符之间）
  • RULE_DESCRIPTION：静音的说明 规则（最多 1,024 个字符）

  • FILTER：您定义要过滤的表达式 发现结果

    例如，如需忽略 OPEN_FIREWALL 发现结果，您的过滤条件可以是 "category=\"OPEN_FIREWALL\""。

响应包括忽略配置 ID，您可以使用该 ID 查看、更新和删除忽略规则，如管理忽略规则中所述。

与过滤条件完全匹配的新发现结果会被隐藏，发现结果的 mute 特性设置为 MUTED。

忽略规则不支持的发现结果属性

忽略规则未必支持过滤条件中的所有发现结果属性。忽略规则过滤条件不支持以下属性。

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

列出忽略规则

您可以通过以下方式列出组织、文件夹或项目中的忽略规则： 使用 Google Cloud 控制台 gcloud CLI 或 Security Command Center API。

您是否能够列出给定范围的忽略规则，取决于 您向 IAM 授予的权限 角色。

如果为 Security Command Center 启用数据驻留， list 命令也仅限于 Security Command Center 位置。

如需查看列出忽略规则的示例代码，请参阅列出忽略规则。

要列出某个组织、文件夹或 请点击您要执行的 使用：

控制台

  1. 在 Google Cloud 控制台中，转到 Security Command Center 设置页面中的忽略规则标签页。

    转到“忽略规则”

  2. 如有必要，请选择您的 Google Cloud 项目或组织。

    项目选择器

  3. 如果为数据驻留 已启用 Security Command Center，请使用 位置选择器（位于项目选择器正下方），以便选择 存储忽略规则的 Security Command Center 位置。 例如：

    位置选择器的屏幕截图

  4. 在忽略规则部分，您会看到有效忽略规则的详细信息。 包括：

    • 名称：忽略规则 ID
    • 父级资源：忽略规则所在的资源
    • 说明：忽略规则的说明（如有）
    • 上次更新者为：上次更新规则的主账号
    • 上次更新时间：上次更新规则的日期和时间

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 如需列出忽略规则，请运行 gcloud scc muteconfigs list 命令：

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

    替换以下内容：

    • PARENT：父级 organization、folder 或 project（要为其列出忽略规则）
    • PARENT_ID：上级组织的 ID。 文件夹或项目

    • LOCATION：如果启用了数据驻留， 指定 Security Command Center 位置 以列出忽略规则。

      如果未启用数据驻留，请指定 --location 标志列表 使用 Security Command Center API v2 忽略规则，并且 此标志的有效值为 global。

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class ListMuteRules {

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

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

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

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

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

    client = securitycenter.SecurityCenterClient()

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

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

REST API

在 Security Command Center API 中，使用 muteConfigs list 方法列出 忽略规则。请求正文为空。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 是 预览版。当数据驻留 则 API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请使用 v1 端点执行以下操作 调用 muteConfigs list：

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

如果您使用的是 Security Command Center API v2，请使用 v2 端点执行以下操作 调用 muteConfigs list：

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

替换以下内容：

  • PARENT：忽略规则的父级资源（organizations、folders 或 projects）
  • PARENT_ID：上级组织的 ID。 文件夹或项目
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 要为其列出忽略规则的对象。如果省略了位置字段 默认值为 global。

响应包括忽略规则的名称、说明和忽略配置 ID。

查看忽略规则配置

您可以使用 Google Cloud 控制台、 gcloud CLI 或 Security Command Center API。

如需查看检索忽略规则配置的示例代码，请参阅 查看忽略规则。

要查看忽略规则配置，请点击 使用：

控制台

  1. 在 Google Cloud 控制台中，前往忽略规则标签页， Security Command Center 设置页面。

    转到“忽略规则”

  2. 如有必要，请选择您的 Google Cloud 项目或组织。

    项目选择器

  3. 如果为数据驻留 已启用 Security Command Center，请使用 位置选择器（位于项目选择器正下方） 忽略规则的 Security Command Center 位置。 例如：

    位置选择器的屏幕截图

  4. 在忽略规则部分中，您会看到忽略规则列表。

  5. 点击要查看的规则的名称。

    此时将打开一个页面，其中包含忽略规则的配置。

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 要查看忽略规则的配置，请运行 gcloud scc muteconfigs get 命令：

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

    替换以下内容：

    • MUTE_CONFIG_ID：忽略规则的 ID
    • PARENT：忽略规则的父级资源（organization、folder 或 project）
    • PARENT_ID： 组织、文件夹或项目

    • LOCATION：如果启用了数据驻留， 指定 Security Command Center 位置 并在其中存储忽略规则默认值为 global。

      如果未启用数据驻留，请指定 --location 标志 使用 Security Command Center API v2 来获取忽略规则 此标志的有效值为 global。

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class GetMuteRule {

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

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

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

    getMuteRule(parentPath, muteConfigId);
  }

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

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

    client = securitycenter.SecurityCenterClient()

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

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

REST API

在 Security Command Center API 中，使用 muteConfigs get 方法返回 忽略规则的配置请求正文为空。

如需获取忽略规则的 CONFIG_ID，请先对 列出忽略规则。 响应包含返回的忽略规则的配置 ID。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 是 预览版。当数据驻留 则 API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请使用 v1 端点调用 muteConfigs get：

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

如果您使用的是 Security Command Center API v2，请使用 v2 端点调用 muteConfigs get：

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

替换以下内容：

  • PARENT：忽略规则的父级资源（organizations、folders 或 projects）
  • PARENT_ID： 组织、文件夹或项目
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 并在其中存储忽略规则如果省略了位置字段 默认值为 global。
  • CONFIG_ID：忽略规则的数字 ID

更新忽略规则

您可以使用 Google Cloud 控制台、gcloud CLI 或 Security Command Center API。

您无法更改此 ID、父级组织、文件夹、项目或 忽略规则的位置。要更改其中任何值，您必须创建 创建新的忽略规则

如果您之前已取消忽略某些发现结果，但它们与 Google Cloud 控制台中更新的忽略规则匹配，则系统会再次忽略这些发现结果。如需了解详情，请参阅取消忽略的发现结果替换忽略规则。

如需查看更新忽略规则的示例代码，请参阅 更新忽略规则。

要更新忽略规则，请点击 使用：

控制台

  1. 在 Google Cloud 控制台中，转到 Security Command Center 设置页面中的忽略规则标签页。

    转到“忽略规则”

  2. 选择要修改的忽略规则的父资源的 Google Cloud 项目或组织。项目选择器

  3. 如果为数据驻留 已启用 Security Command Center，请使用 位置选择器（位于项目选择器正下方），以便选择 忽略规则的 Security Command Center 位置。 例如：

    位置选择器的屏幕截图

  4. 点击要修改的忽略规则的名称。

    如果您没有选择适当的项目或组织，可能会看到一条通知，指出您无权修改忽略规则。

  5. 输入新说明，然后点击保存。

  6. 更新或更改过滤条件。

    如需了解相关说明，请参阅创建忽略规则。

  7. 如需查看与更新后的过滤条件匹配的发现结果，请点击预览匹配的发现结果。

    系统会加载表，其中包含与新查询匹配的发现结果。

  8. 点击保存。

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 如需更新忽略规则，请运行 gcloud scc muteconfigs update 命令：

      gcloud scc muteconfigs update MUTE_CONFIG_ID \
    --PARENT=PARENT_ID \
    --location=LOCATION
    --description=RULE_DESCRIPTION \
    --filter=FILTER

    替换以下内容：

    • MUTE_CONFIG_ID：忽略规则的 ID。
    • PARENT：忽略规则的父级资源 （organization、folder 或 project）。
    • PARENT_ID： 组织、文件夹或项目。

    • LOCATION：如果启用了数据驻留， 指定 Security Command Center 位置 并在其中存储忽略规则默认值为 global。

      如果数据驻留为 未启用，指定 --location 标志会更新忽略规则 使用 Security Command Center API v2 进行配置 此标志的有效值为 global。

    • RULE_DESCRIPTION：静音的说明 规则（最多 1,024 个字符）。

    • FILTER：您定义要过滤的表达式 结果。

      例如，如需忽略 OPEN_FIREWALL 发现结果，您的过滤条件可能是 FILTER="category=\"OPEN_FIREWALL\""。

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


import (
	"context"
	"fmt"
	"io"

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

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

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

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

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

Java

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class UpdateMuteRule {

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

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

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

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

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

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

    client = securitycenter.SecurityCenterClient()

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

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

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

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

REST API

在 Security Command Center API 中，使用 muteConfigs patch 方法 更新忽略规则请求正文是 MuteConfig 的实例。

如需获取忽略规则的 CONFIG_ID，请对 列出忽略规则。 响应包含返回的忽略规则的配置 ID。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 是 预览版。当数据驻留 则 API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请使用 v1 端点执行以下操作 调用 muteConfigs patch：

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

  {
    "description": "RULE_DESCRIPTION",
    "filter": "FILTER",
  }

如果您使用的是 Security Command Center API v2，请使用 v2 端点执行以下操作 调用 muteConfigs patch：

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

  {
    "description": "RULE_DESCRIPTION",
    "filter": "FILTER",
    "type": "STATIC"
  }

替换以下内容：

  • PARENT：忽略规则的父级资源（organizations、folders 或 projects）
  • PARENT_ID： 组织、文件夹或项目
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 并在其中存储忽略规则如果省略了位置字段 默认值为 global。
  • CONFIG_ID：忽略规则的数字 ID
  • RULE_DESCRIPTION：忽略规则的说明 （最多：1,024 个字符）

  • FILTER：您定义来过滤发现结果的表达式

    例如，如需忽略 OPEN_FIREWALL 发现结果，您的过滤条件可以是 "category=\"OPEN_FIREWALL\""。

与过滤条件完全匹配的新发现结果会被隐藏，发现结果的 mute 特性设置为 MUTED。

更新忽略规则不会自动取消忽略之前规则忽略的任何发现结果。您必须手动取消忽略发现结果。

删除忽略规则

您可以使用 Google Cloud 控制台、 gcloud CLI 或 Security Command Center API。

在删除忽略规则之前，请先了解以下内容：

  • 您无法恢复已删除的忽略规则。
  • 删除忽略规则不会自动取消忽略任何已忽略的发现结果 已静音。您必须手动或以编程方式 取消忽略发现结果。
  • 系统不会忽略将来与已删除忽略规则中的过滤条件匹配的发现结果。

如需查看删除忽略规则的示例代码，请参阅 删除忽略规则。

要删除忽略规则，请点击要忽略的 使用：

控制台

  1. 在 Google Cloud 控制台中，转到 Security Command Center 设置页面中的忽略规则标签页。

    转到“忽略规则”

  2. 如有必要，请选择您的 Google Cloud 项目或组织。

    项目选择器

  3. 如果为数据驻留 已启用 Security Command Center，请使用 位置选择器（位于项目选择器正下方），以便选择 存储忽略规则的 Security Command Center 位置。 例如：

    位置选择器的屏幕截图

  4. 点击要删除的忽略规则的名称。

  5. 点击 删除。

  6. 阅读对话框，如果满意，请点击删除。

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 如需删除忽略规则，请运行 gcloud scc muteconfigs delete 命令：

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

    请替换以下内容：

    • MUTE_CONFIG_ID：忽略配置的 ID
    • PARENT：忽略规则的父级资源（organization、folder 或 project）
    • PARENT_ID： 组织、文件夹或项目

    • LOCATION：如果数据驻留为 指定 Security Command Center 位置 用于存储忽略规则配置。默认值为 global。

      如果未启用数据驻留，请指定 --location 标志 使用 Security Command Center API v2 删除忽略规则，以及 该标志的唯一有效值是 global。

  3. 确认您删除忽略规则的请求。

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class DeleteMuteRule {

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

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

    deleteMuteRule(parentPath, muteConfigId);
  }

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

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

    client = securitycenter.SecurityCenterClient()

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

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

REST API

在 Security Command Center API 中，使用 muteConfigs delete 方法 删除忽略规则。请求正文为空。

如需获取忽略规则的 CONFIG_ID，请对 列出忽略规则。 响应包含返回的忽略规则的配置 ID。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 是 预览版。当数据驻留 则 API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请使用 v1 端点调用 muteConfigs delete：

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

如果您使用的是 Security Command Center API v2，请使用 v2 端点调用 muteConfigs delete：

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

替换以下内容：

  • PARENT：忽略规则的父级资源（organizations、folders 或 projects）
  • PARENT_ID： 组织、文件夹或项目
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 并在其中存储忽略规则如果省略了位置字段 默认值为 global。
  • CONFIG_ID：忽略规则的数字 ID

忽略个别发现结果

您可以使用 Google Cloud 控制台、 gcloud CLI 或 Security Command Center API。

忽略发现结果不会影响其有效状态。如果某个有效的发现结果被忽略，其 state 属性会保持不变，即仍为 state="ACTIVE"。虽然该发现结果被隐藏起来，但在其相关的底层漏洞、配置错误或威胁得以消除之前，它会一直保持有效状态。

忽略恶意组合发现结果会关闭相应的恶意组合 这种情况。

如需忽略与您指定的条件匹配的所有未来发现结果，请参阅 创建忽略规则。

如需查看用于忽略发现结果的示例代码，请参阅忽略发现结果。

如需忽略单个发现结果，请点击要忽略的程序所对应的标签页 使用：

控制台

  1. 在 Google Cloud 控制台中，转到 Security Command Center 发现结果页面。

    转至“发现结果”

  2. 如有必要，请选择您的 Google Cloud 项目或组织。 项目选择器

  3. 如果为数据驻留 已启用 Security Command Center，请使用 位置选择器（位于项目选择器正下方） 发现结果的 Security Command Center 位置。 例如：

    位置选择器的屏幕截图

  4. 如果您在发现结果的查询结果面板中没有看到需要忽略的发现结果，请在快速过滤条件面板的类别部分选择该发现结果的类别。

  5. 勾选需要忽略的发现结果旁边的复选框。您可以选择一个或多个发现结果。

  6. 在发现结果的查询结果操作栏上，点击忽略选项，然后选择忽略。

    所选发现结果的 mute 属性将被设置为 MUTED，并且该发现结果会从发现结果的查询结果面板中被移除。

或者，您也可以在发现结果的详细信息面板中忽略相应的发现结果：

  1. 在发现结果页面的发现结果的查询结果面板中，选择类别列，然后点击需要忽略的发现结果的名称。系统会打开该发现结果的详细信息面板。
  2. 点击执行操作。

  3. 在执行操作菜单中，选择忽略。

    如果您选择忽略这类发现结果，则系统会打开创建忽略规则页面，您可以在其中为具有相同类型或包含相同 Indicator 属性的发现结果创建忽略规则。

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 如需将发现结果的忽略状态设置为 MUTED，请使用 gcloud CLI 中的 set-mute 命令：

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

    请替换以下内容：

    • FINDING_ID：要忽略的发现结果的 ID

      如需检索发现结果 ID，请使用 Security Command Center API 列出发现结果。发现结果 ID 是 canonicalName 特性的最后一部分，例如 projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9。

    • PARENT：父级资源 (project, folder 或 organization），区分大小写

    • PARENT_ID：上级组织的 ID。 文件夹或项目

    • LOCATION：如果数据驻留为 指定 Security Command Center 位置 发现结果的存储位置。

      如果未启用数据驻留，请指定 --location 标志 使用 Security Command Center API v2 忽略发现结果； 该标志的唯一有效值是 global。

    • SOURCE_ID：来源 ID

      如需了解如何检索来源 ID，请参阅获取来源 ID。

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

import (
	"context"
	"fmt"
	"io"

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

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class SetMuteFinding {

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

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

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

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

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

    client = securitycenter.SecurityCenterClient()

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

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

REST API

在 Security Command Center API 中，使用 setMute 方法忽略 查找。请求正文是一个枚举，用于指明生成的 静音状态。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 是 预览版。当数据驻留 则 API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请调用 setMute 方法是使用 v1 端点：


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

{
  "mute": "MUTED"
}

如果您使用的是 Security Command Center API v2，请调用 setMute 方法是使用 v2 端点：

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

{
  "mute": "MUTED"
}

替换以下内容：

  • PARENT：父级资源 (organizations, folders 或 projects）。
  • PARENT_ID：父级的 ID 组织、文件夹或项目。
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 发现结果的存储位置。如果省略了位置字段 默认值为 global。

  • SOURCE_ID：来源的数字 ID。

    如需了解如何检索来源 ID，请参阅获取来源 ID。

  • FINDING_ID：所需发现结果的 ID 静音。

    如需检索发现结果 ID，请使用 Security Command Center API 列出发现结果。发现结果 ID 是 canonicalName 特性的最后一部分，例如 projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9。

忽略发现结果后，其 mute 属性会被设为 MUTED。

取消忽略各个发现结果

您可以使用 Google Cloud 控制台、 gcloud CLI 或 Security Command Center API。

如需查看取消忽略发现结果的示例代码，请参阅将发现结果取消忽略。

如需取消忽略单个发现结果，请点击要忽略的程序所对应的标签页 使用：

控制台

  1. 在 Google Cloud 控制台中，转到 Security Command Center 发现结果页面。

    转至“发现结果”

  2. 如有必要，请选择您的 Google Cloud 项目或组织。 项目选择器

    系统随即会打开发现结果页面，并在查询预览部分中显示默认查询。由于默认查询会过滤掉已忽略的发现结果，因此您需要先修改该查询，之后系统才会在发现结果的查询结果面板中显示已忽略的发现结果。

  3. 如果为数据驻留 已启用 Security Command Center，请使用 位置选择器（位于项目选择器正下方），以便选择 发现结果的 Security Command Center 位置。 例如：

    位置选择器的屏幕截图

  4. 在查询预览部分右侧，点击修改查询以打开查询编辑器。

  5. 在查询编辑器字段中，将现有忽略语句替换为以下内容：

    mute="MUTED"

  6. 点击应用。发现结果的查询结果面板中的发现结果会相应更新，以仅包含已忽略的发现结果。

  7. 如有必要，您可以过滤掉其他已忽略的发现结果。例如，您可以在快速过滤条件面板下方的类别部分，选择需要取消忽略的发现结果的名称，以过滤掉所有其他类别的发现结果。

  8. 勾选要取消忽略的发现结果旁边的复选框。您可以选择一个或多个发现结果。

  9. 在发现结果的查询结果操作栏上，点击忽略选项，然后选择取消忽略。

    所选发现结果的 mute 属性将被设置为 UNMUTED，并且该发现结果会从发现结果的查询结果面板中被移除。

或者，您也可以在发现结果的详细信息面板中取消忽略相应的发现结果：

  1. 在发现结果页面的发现结果的查询结果面板中，选择类别列，然后点击需要取消忽略的发现结果的名称。系统会打开该发现结果的详细信息面板。
  2. 点击执行操作。
  3. 在执行操作菜单中，选择取消忽略。

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 如需将发现结果的忽略状态设置为 UNMUTED，请使用 gcloud CLI 中的 set-mute 命令：

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

    请替换以下内容：

    • FINDING_ID：要忽略的发现结果的 ID

      如需检索发现结果 ID，请使用 Security Command Center API 列出发现结果。发现结果 ID 是 canonicalName 特性的最后一部分，例如 projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9。

    • PARENT：父资源（project、folder 或 organization），区分大小写

    • PARENT_ID：上级组织的 ID。 文件夹或项目

    • LOCATION：如果数据驻留为 指定 Security Command Center 位置 发现结果的存储位置。

      如果未启用数据驻留，请指定 --location 标志 使用 Security Command Center API v2 取消忽略发现结果，以及 该标志的唯一有效值是 global。

    • SOURCE_ID：来源 ID

      如需了解如何检索来源 ID，请参阅获取来源 ID

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


import (
	"context"
	"fmt"
	"io"

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

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class SetUnmuteFinding {

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

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

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

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

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

    client = securitycenter.SecurityCenterClient()

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

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

REST API

在 Security Command Center API 中，使用 setMute 方法取消静音 查找。请求正文是一个枚举，用于指明生成的 静音状态。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 是 预览版。当数据驻留 则 API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请调用 setMute 方法是使用 v1 端点：

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

{
  "mute": "UNMUTED"
}

如果您使用的是 Security Command Center API v2，请调用 setMute 方法是使用 v2 端点：

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

{
  "mute": "UNMUTED"
}

替换以下内容：

  • PARENT：父级资源（organizations、folders 或 projects）
  • PARENT_ID：上级组织的 ID。 文件夹或项目
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 发现结果的存储位置。如果省略了位置字段 默认值为 global。

  • SOURCE_ID：来源的数字 ID

    如需了解如何检索来源 ID，请参阅获取来源 ID

  • FINDING_ID：所需发现结果的 ID 静音。

    如需检索发现结果 ID，请使用 Security Command Center API 列出发现结果。发现结果 ID 是 canonicalName 特性的最后一部分，例如 projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9。

所选的发现结果不再隐藏，并且发现结果的 mute 特性设置为 UNMUTED。

取消忽略的发现结果会覆盖忽略规则

如果用户取消忽略发现结果，则即使现有的忽略规则仍与发现结果匹配，它们仍会保持取消忽略状态。实际上，用户取消忽略操作会覆盖忽略规则。

仅当用户手动忽略发现结果或在 Google Cloud 控制台中创建新的匹配忽略规则时，未忽略的发现结果才会再次忽略。使用 gcloud CLI 或 Security Command Center API 创建的忽略规则不会影响用户取消忽略的发现结果。

忽略多个现有发现结果

您可以使用以下任一方法批量忽略多个现有发现结果： gcloud scc findings bulk-mute gcloud CLI 命令，或 bulkMute 方法。如果您需要 如需忽略将来的类似发现结果，请创建忽略规则。

通过定义 发现结果过滤条件。批量忽略过滤条件不支持所有发现结果属性。 有关不受支持的属性的列表，请参阅 忽略规则的发现结果属性不受支持。

如果为 Security Command Center 启用数据驻留，则批量忽略操作 限制在它们所在的 Security Command Center 位置范围内 。

如需查看批量忽略发现结果的示例代码，请参阅 批量忽略发现结果。

如需批量忽略发现结果，请点击所需操作步骤对应的标签页 使用：

控制台

在 Google Cloud 控制台中，您只能通过创建忽略规则来批量忽略发现结果。在 Google Cloud 控制台中，创建忽略规则会隐藏现有和未来的发现结果。

gcloud

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 如需批量忽略多个发现结果，请运行 gcloud scc findings bulk-mute 命令：

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

    替换以下内容：

    • PARENT：资源层次结构中的范围 应用忽略规则的应用：organization、folder 或 project。
    • PARENT_ID：上级组织的 ID。 文件夹或项目，并以 organizations/123、folders/456 或 projects/789。

    • LOCATION：如果启用了数据驻留， 指定 Security Command Center 位置 以批量忽略发现结果。仅限此位置中的发现结果 处于静音状态。

      如果未启用数据驻留，请指定 --location 标志 使用 Security Command Center API v2 忽略发现结果，并且唯一的 此标志的有效值为 global。

    • FILTER：您定义要过滤的表达式 发现结果

    例如，如需忽略 internal-test 项目中所有现有的低严重级别 OPEN_FIREWALL 和 PUBLIC_IP_ADDRESS 发现结果，您的过滤条件可以是 "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.project_display_name=\"internal-test\""。

Go

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


import (
	"context"
	"fmt"
	"io"

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

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

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

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

Java

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 


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

public class BulkMuteFindings {

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

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

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

    bulkMute(parentPath, muteRule);
  }

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

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

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

Python

以下示例使用 v1 API。修改 v2 的示例，将 v1 替换为 v2，并添加 将 /locations/LOCATION 设置为资源名称。

对于大多数资源，请将 /locations/LOCATION 添加到 资源名称在 /PARENT/PARENT_ID 之后，其中 PARENT 为 organizations、folders、 或 projects。

对于发现结果，请将 /locations/LOCATION 添加到资源中 名称在 /sources/SOURCE_ID 之后，其中 SOURCE_ID 是 Security Command Center 服务 发出该发现结果。 

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

    client = securitycenter.SecurityCenterClient()

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

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

REST API

在 Security Command Center API 中，使用 bulkMute 方法将多个 现有发现结果。请求正文包含用于 过滤发现结果。

除非启用数据驻留，否则您可以使用 Security Command Center API。API v2 是 预览版。当数据驻留 则 API v2 是唯一可用的 API。

如果您使用的是 Security Command Center API v1，请调用 bulkMute 方法是使用 v1 端点：

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

{
  "filter": "FILTER"
}

如果您使用的是 Security Command Center API v2，请调用 bulkMute 方法是使用 v2 端点：

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

{
  "filter": "FILTER"
}

替换以下内容：

  • PARENT：父级资源 （organizations、folders 或 projects）。
  • PARENT_ID：上级组织的 ID。 文件夹或项目。
  • LOCATION：仅适用于 v2，指定 Security Command Center 位置 发现结果的存储位置。如果省略了位置字段 默认值为 global。

  • FILTER：您定义要过滤的表达式 结果。

    例如，如需忽略 internal-test 项目中所有现有的低严重级别 OPEN_FIREWALL 和 PUBLIC_IP_ADDRESS 发现结果，您的过滤条件可以是 "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.project_display_name=\"internal-test\""。

系统会隐藏您选择的资源中与过滤条件完全匹配的所有现有发现结果。发现结果的 mute 特性设置为 MUTED。

如果忽略发现结果，则系统不会更改其状态。如果有效的发现结果被忽略，这些发现结果会隐藏起来，但在底层漏洞、配置错误或威胁得以消除之前会保持有效状态。

在 Google Cloud 控制台中查看已忽略的发现结果

您可以在 Google Cloud 控制台中修改发现结果，从而查看已忽略的发现结果 查询以选择包含属性值 mute="MUTED" 的发现结果。

例如，以下发现结果查询仅显示有效的发现结果 ：

state="ACTIVE"
AND mute="MUTED"

如需显示所有活跃的发现结果（包括已忽略的发现结果和取消忽略的发现结果），请完全省略查询中的 mute 属性：

state="ACTIVE"

默认情况下，Google Cloud 控制台中的发现结果查询仅显示 未忽略的发现结果。

如需详细了解如何修改发现结果查询，请参阅 在信息中心内创建或修改发现结果查询。

查找与静音相关的属性

本部分列出了与以下对象的静音状态相关的发现结果属性： 并描述了忽略操作对它们的影响：

  • mute：在创建发现结果时设置为 UNDEFINED 并在以下情况下进行更改：
    • MUTED：发现结果被手动忽略或通过忽略规则忽略。
    • UNMUTED：用户取消忽略发现结果。
  • mute_update_time：发现结果被忽略或取消忽略的时间
  • mute_initiator：忽略发现结果的主账号或忽略规则的标识符

停止通知并导出已忽略的发现结果

如果您启用发现结果通知， 符合您的通知过滤条件的新已忽略的发现结果或更新后的已忽略的发现结果 仍会导出到 Pub/Sub

如需针对已忽略的发现结果停止导出和通知，请使用mute 属性，以在 NotificationConfig 过滤条件中排除已忽略的发现结果。 例如，以下过滤条件仅发送有关未忽略或未设置忽略特性的有效发现结果的通知：

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

后续步骤

详细了解如何过滤发现结果通知。

浏览您可以使用的更多过滤条件示例。