创建规则

您可以使用 Security and Compliance Center UI 来定义要针对 IBM Cloud 资源监视的配置规则。 有关可以为哪些服务配置规则的更多信息，请参阅 我可以评估什么?。

您可以使用规则构建器或直接编辑 JSON。

1. 在 IBM Cloud 控制台中，转到 Resource list 页面并选择 Security and Compliance Center 实例。

2. 在 Security and Compliance Center 实例中，转到 Rules 页面并单击 Create。

3. 给你的规则起一个有意义的名称和描述。

4. 可选: 添加可用于组织和搜索类似规则的一个或多个标签，然后单击 下一步。

5. 以您的资源为目标。

   1. 从 目标服务 下拉列表中，选择服务。 例如 Cloud Object Storage.

   2. 从 资源类型 下拉列表中，选择要为其创建规则的资源类型。 例如，存储区。

   3. 可选: 添加其他目标属性以进一步限定要作为目标的资源。

      例如，要将美国南部位置中的所有 Cloud Object Storage 存储区作为目标，您将进行以下选择: 属性: Location，值: string_equals，并输入 us_south 作为 值。

   4. 单击添加到规则。

6. 配置属性。

   要向规则添加其他属性，请重复此步骤。 您最多可以选择 5 个不同的条件和 16 个属性来创建规则。

   1. 选择条件。

      • 和: 选择 和 作为条件时，您添加到规则的所有属性配置都必须求值为 true 才能使规则合规。
      • 或: 当您选择 或 作为条件时，只有规则的一部分必须求值为 true 才能符合条件。

   2. 通过指定 属性，运算符和 值来定义规则。

      要查看可用于所选服务的所有属性，可以在 定义 步骤中单击 可用属性。

   3. 单击添加到规则。

7. 单击下一步。

8. 查看您的选择，然后单击“创建”。

使用应用程序接口创建规则

您可以使用 Security and Compliance Center API 来定义要针对 IBM Cloud 资源监视的配置规则。 有关可以为哪些服务配置规则的更多信息，请参阅 我可以评估什么?。

curl -X POST
   --location --header "Authorization: Bearer {iam_token}"
   --header "Accept: application/json"
   --header "Content-Type: application/json"
   --data '{
               "account_id": "130003ea8bfa43c5aacea07a86da3000",
               "description": "Example rule",
               "rule_type": "user_defined",
               "import": {
                  "parameters": [
                     {
                        "name": "hard_quota",
                        "display_name": "The Cloud Object Storage bucket quota.",
                        "description": "The maximum bytes that are allocated to the Cloud Object Storage bucket.",
                        "type": "numeric"
                        }
                     ]
                  },
               "target": {
                  "service_name": "cloud-object-storage",
                  "resource_kind": "bucket",
                  "additional_target_attributes":  ]
               },
               "required_config": {
                  "description": "The Cloud Object Storage rule.",
                  "and": [
                     {
                        "property": "hard_quota",
                        "operator": "num_equals",
                        "value": "{hard_quota}"
                        }
                     ]
                  },
               "labels":  
            ],
            "version": "1.0.0"
         }'
"https://us-south.compliance.cloud.ibm.com/instances/{instance_id}/v3/rules"

(securityAndComplianceCenterApi *SecurityAndComplianceCenterApiV3) CreateRule(createRuleOptions *CreateRuleOptions) (result *Rule, response *core.DetailedResponse, err error)

AdditionalTargetAttribute additionalTargetAttributeModel = new AdditionalTargetAttribute.Builder()
  .name("location")
  .operator("string_equals")
  .value("us-east")
  .build();
TargetPrototype targetPrototypeModel = new TargetPrototype.Builder()
  .serviceName("cloud-object-storage")
  .resourceKind("bucket")
  .additionalTargetAttributes(java.util.Arrays.asList(additionalTargetAttributeModel))
  .build();
RequiredConfigItemsRequiredConfigBase requiredConfigItemsModel = new RequiredConfigItemsRequiredConfigBase.Builder()
  .property("hard_quota")
  .operator("num_equals")
  .value("{hard_quota}")
  .build();
RequiredConfigAnd requiredConfigModel = new RequiredConfigAnd.Builder()
  .description("The Cloud Object Storage rule.")
  .and(java.util.Arrays.asList(requiredConfigItemsModel))
  .build();
Parameter parameterModel = new Parameter.Builder()
  .name("hard_quota")
  .displayName("The Cloud Object Storage bucket quota.")
  .description("The maximum bytes that are allocated to the Cloud Object Storage bucket.")
  .type("numeric")
  .build();
Import importModel = new Import.Builder()
  .parameters(java.util.Arrays.asList(parameterModel))
  .build();
CreateRuleOptions createRuleOptions = new CreateRuleOptions.Builder()
  .description("Example rule")
  .target(targetPrototypeModel)
  .requiredConfig(requiredConfigModel)
  .version("1.0.0")
  .xImport(importModel)
  .labels(java.util.Arrays.asList())
  .build();

Response<Rule> response = securityAndComplianceCenterApiService.createRule(createRuleOptions).execute();
Rule rule = response.getResult();

System.out.println(rule);

// Request models needed by this operation.

// AdditionalTargetAttribute
const additionalTargetAttributeModel = {
  name: 'location',
  operator: 'string_equals',
  value: 'us-east',
};

// Target
const targetModel = {
  service_name: 'cloud-object-storage',
  resource_kind: 'bucket',
  additional_target_attributes: [additionalTargetAttributeModel],
};

// RequiredConfigItemsRequiredConfigBase
const requiredConfigItemsModel = {
  property: 'hard_quota',
  operator: 'num_equals',
  value: '{hard_quota}',
};

// RequiredConfigRequiredConfigAnd
const requiredConfigModel = {
  description: 'The Cloud Object Storage rule.',
  and: [requiredConfigItemsModel],
};

// Parameter
const parameterModel = {
  name: 'hard_quota',
  display_name: 'The Cloud Object Storage bucket quota.',
  description: 'The maximum bytes that are allocated to the Cloud Object Storage bucket.',
  type: 'numeric',
};

// Import
const importModel = {
  parameters: [parameterModel],
};

const params = {
  description: 'Example rule',
  target: targetModel,
  requiredConfig: requiredConfigModel,
  version: '1.0.0',
  _import: importModel,
  labels: [],
};

let res;
try {
  res = await securityAndComplianceCenterApiService.createRule(params);
  console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
  console.warn(err);
}

profile_controls_prototype_model = {
  'control_library_id': control_library_id_link,
  'control_id': '1fa45e17-9322-4e6c-bbd6-1c51db08e790',
}

default_parameters_prototype_model = {
  'assessment_type': 'Automated',
  'assessment_id': 'rule-a637949b-7e51-46c4-afd4-b96619001bf1',
  'parameter_name': 'session_invalidation_in_seconds',
  'parameter_default_value': '120',
  'parameter_display_name': 'Sign out due to inactivity in seconds',
  'parameter_type': 'numeric',
}

response = security_and_compliance_center_api_service.create_profile(
  profile_name='test_profile1',
  profile_description='test_description1',
  profile_type='custom',
  controls=[profile_controls_prototype_model],
  default_parameters=[default_parameters_prototype_model],
)
profile = response.get_result()

print(json.dumps(profile, indent=2))

成功响应将返回规则列表以及其他元数据。 有关必需和可选请求参数的更多信息，请查看 API 文档。

使用 CLI 创建规则

您可以使用 Security and Compliance Center CLI 来定义要针对 IBM Cloud 资源监视的配置规则。 有关可以为哪些服务配置规则的更多信息，请参阅 我可以评估什么?。

ibmcloud security-compliance rule create
--description='Example rule'
--target='{
  "service_name": "cloud-object-storage",
  "service_display_name": "exampleString",
  "resource_kind": "bucket",
  "additional_target_attributes": [
    {
      "name": "location",
      "operator": "string_equals",
      "value": "us-east"
      }
    ]
  }'
--required-config='{
  "description": "The Cloud Object Storage rule.",
  "and": [
    {
      "description": "exampleString",
      "property": "hard_quota",
      "operator": "num_equals",
      "value": "${hard_quota}"
      }
    ]
  }'
--type=user_defined
--version=1.0.0
--import='{
  "parameters": [
    {
      "name": "hard_quota",
      "display_name": "The Cloud Object Storage bucket quota.",
      "description": "The maximum bytes that are allocated to the Cloud Object Storage bucket.",
      "type": "numeric"
      }
    ]
  }'
--labels=foo,bar
--x-correlation-id=exampleString
--x-request-id=exampleString

请参阅 CLI 参考 以获取更多信息。

使用 Terraform 创建规则

您可以使用 Terraform 为 IBM Cloud 资源定义要监视的配置规则。 有关可以为哪些服务配置规则的更多信息，请参阅 我可以评估什么?。

resource "ibm_scc_rule" "scc_rule_instance" {
  description = "Example rule"
  import {
		parameters {
			name = "name"
			display_name = "display_name"
			description = "description"
			type = "string"
		}
  }
  required_config {
		description = "description"
		and {
			description = "description"
			or {
				description = "description"
				property = "property"
				operator = "string_equals"
				value = "anything as a string"
			}
		}
  }
  target {
		service_name = "service_name"
		service_display_name = "service_display_name"
		resource_kind = "resource_kind"
		additional_target_attributes {
			name = "name"
			operator = "string_equals"
			value = "value"
		}
  }
  version = "1.0.0"
}

有关更多信息，请查看 Terraform 参考。