本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
AWS Security Hub 的操作、资源和条件键
AWS Security Hub（服务前缀:securityhub）提供以下特定于服务的资源、操作和条件上下文密钥，用于IAM权限策略。
参考：
-
了解如何配置该服务。
-
查看此服务可用的API操作列表。
-
了解如何使用IAM权限策略保护此服务及其资源。
AWS Security Hub 定义的操作
您可以在IAM策略声明的Action元素中指定以下操作。可以使用策略授予在 AWS中执行操作的权限。当您在策略中使用操作时，通常会允许或拒绝访问具有相同名称的API操作或CLI命令。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。如果该列包含资源类型，则可以在带有该操作ARN的语句中指定该类型的资源类型。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您使用IAM策略中的Resource元素限制资源访问权限，则必须为每种必需的资源类型包含ARN或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。
操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。
注意
资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。
有关下表中各列的详细信息，请参阅操作表。
| 操作 | 描述 | 访问级别 | 资源类型（* 为必需） | 条件键 | 相关操作 |
|---|---|---|---|---|---|
| AcceptAdministratorInvitation | 授予权限以接受成为成员账户的 Security Hub 邀请 | Write | |||
| AcceptInvitation | 授予权限以接受成为成员账户的 Security Hub 邀请 | 写入 | |||
| BatchDeleteAutomationRules | 授予权限以删除 Security Hub 中的一个或多个自动化规则 | 写入 | |||
| BatchDisableStandards | 授予权限以在 Security Hub 中禁用标准 | Write | |||
| BatchEnableStandards | 授予权限以在 Security Hub 中启用标准 | 写入 | |||
| BatchGetAutomationRules | 根据规则 Amazon 资源名称 (ARNs) 授予从 Security Hub 检索自动化规则详情列表的权限 | 读取 | |||
| BatchGetConfigurationPolicyAssociations | 授予检索与调用账户所在组织的特定成员账户列表和组织单位关联的配置策略信息的权限 | 读取 | |||
| BatchGetControlEvaluations[仅权限] | 授予权限以获取控件的启用和合规性状态、控件的调查发现计数以及 Security Hub 控制台上控件的总体安全性评分 | 读取 | |||
| BatchGetSecurityControls | 授予权限以获取有关由 ID 标识的特定安全控制措施的详细信息或 ARN | 读取 |
securityhub:DescribeStandardsControls |
||
| BatchGetStandardsControlAssociations | 授予权限以获取标准中一批安全控件的启用状态 | 读取 |
securityhub:DescribeStandardsControls |
||
| BatchImportFindings | 授予权限以将结果从集成产品导入 Security Hub | 写入 | |||
| BatchUpdateAutomationRules | 根据规则 Amazon 资源名称 (ARNs) 和输入参数授予从 Security Hub 更新一条或多条自动化规则的权限 | 写入 | |||
| BatchUpdateFindings | 授予权限以更新一组选定的 Security Hub 结果的客户控制字段 | 写入 | |||
| BatchUpdateStandardsControlAssociations | 授予权限以更新标准中一批安全控件的启用状态 | 写入 |
securityhub:UpdateStandardsControl |
||
| CreateActionTarget | 授予权限以在 Security Hub 中创建自定义操作 | 写入 | |||
| CreateAutomationRule | 授予权限以基于输入参数创建自动化规则 | 写入 | |||
| CreateConfigurationPolicy | 授予在 Security Hub 中创建配置策略以管理组织成员设置的权限 | 写入 | |||
| CreateFindingAggregator | 授予权限以创建结果聚合器，其中包含跨区域结果聚合配置 | 写入 | |||
| CreateInsight | 授予权限以在 Security Hub 中创建洞察。洞察是相关结果的集合 | Write | |||
| CreateMembers | 授予权限以在 Security Hub 中创建成员账户 | Write | |||
| DeclineInvitations | 授予权限以拒绝成为成员账户的 Security Hub 邀请 | Write | |||
| DeleteActionTarget | 授予权限以删除 Security Hub 中的自定义操作 | 写入 | |||
| DeleteConfigurationPolicy | 授予删除现有配置策略的权限 | 写入 | |||
| DeleteFindingAggregator | 授予权限以删除结果聚合器，这将禁用跨区域结果聚合 | 写入 | |||
| DeleteInsight | 授予权限以从 Security Hub 中删除洞察 | Write | |||
| DeleteInvitations | 授予权限以删除成为成员账户的 Security Hub 邀请 | Write | |||
| DeleteMembers | 授予权限以删除 Security Hub 成员账户 | 写入 | |||
| DescribeActionTargets | 授予使用检索自定义操作列表的权限 API | 读取 | |||
| DescribeHub | 授予权限以检索有关您的账户中的 Hub 资源的信息 | Read | |||
| DescribeOrganizationConfiguration | 授予描述 Security Hub 组织配置的权限 | Read | |||
| DescribeProducts | 授予权限以检索有关可用 Security Hub 产品集成的信息 | Read | |||
| DescribeStandards | 授予权限以检索有关 Security Hub 标准的信息 | Read | |||
| DescribeStandardsControls | 授予权限以检索有关 Security Hub 标准控件的信息 | Read | |||
| DisableImportFindingsForProduct | 授予权限以禁用 Security Hub 集成产品的结果导入 | Write | |||
| DisableOrganizationAdminAccount | 授予删除组织的 Security Hub 管理员帐户的权限 | Write |
organizations:DescribeOrganization |
||
| DisableSecurityHub | 授予权限以禁用 Security Hub | Write | |||
| DisassociateFromAdministratorAccount | 授予 Security Hub 成员账户从关联的管理员账户中取消关联的权限 | Write | |||
| DisassociateFromMasterAccount | 授予对 Security Hub 成员账户的权限以从关联的主账户中取消关联 | Write | |||
| DisassociateMembers | 授予从关联的管理员账户中取消关联 Security Hub 成员账户的权限 | Write | |||
| EnableImportFindingsForProduct | 授予权限以启用 Security Hub 集成产品的结果导入 | Write | |||
| EnableOrganizationAdminAccount | 授予指定组织的 Security Hub 管理员帐户的权限 | Write |
organizations:DescribeOrganization organizations:EnableAWSServiceAccess organizations:RegisterDelegatedAdministrator |
||
| EnableSecurityHub | 授予权限以启用 Security Hub | Write | |||
| GetAdhocInsightResults[仅权限] | 通过提供一组过滤器而不是洞察来授予检索洞察结果的权限 ARN | 读取 | |||
| GetAdministratorAccount | 授予权限以检索有关 Security Hub 管理员账户的详细信息 | 读取 | |||
| GetConfigurationPolicy | 授予获取调用账户所创建一项配置策略的完整概览的权限 | 读取 | |||
| GetConfigurationPolicyAssociation | 授予检索与调用账户所在组织的某个成员账户或组织单位关联的某个配置策略信息的权限 | 读取 | |||
| GetControlFindingSummary[仅权限] | 授予检索安全评分以及安全标准状态的调查结果计数和控件状态的权限 | Read | |||
| GetEnabledStandards | 授予权限以检索在 Security Hub 中启用的标准列表 | 列出 | |||
| GetFindingAggregator | 授予权限以检索结果聚合器的详细信息，这将配置跨区域结果聚合 | 读取 | |||
| GetFindingHistory | 授予权限以从 Security Hub 检索调查发现历史记录的列表 | 读取 | |||
| GetFindings | 授予权限以从 Security Hub 检索结果的列表 | Read | |||
| GetFreeTrialEndDate[仅权限] | 授予权限以检索账户免费试用 Security Hub 的结束日期 | Read | |||
| GetFreeTrialUsage[仅权限] | 授予权限以检索免费试用期内 Security Hub 使用情况的信息 | Read | |||
| GetInsightFindingTrend[仅权限] | 授予权限以从 Security Hub 检索洞察发现趋势，从而生成图表 | Read | |||
| GetInsightResults | 授予权限以从 Security Hub 检索洞察结果 | Read | |||
| GetInsights | 授予权限以检索 Security Hub 洞察 | List | |||
| GetInvitationsCount | 授予权限以检索发送到账户的 Security Hub 成员资格邀请的计数 | Read | |||
| GetMasterAccount | 授予权限以检索有关 Security Hub 主账户的详细信息 | Read | |||
| GetMembers | 授予权限以检索 Security Hub 成员账户的详细信息 | 读取 | |||
| GetSecurityControlDefinition | 授予获取用 ID 标识的特定安全控件详细信息的权限 | 读取 |
securityhub:DescribeStandardsControls |
||
| GetUsage[仅权限] | 授予权限以按账户检索有关 Security Hub 使用情况的信息 | 读取 | |||
| InviteMembers | 授予邀请其他 AWS 账户成为 Security Hub 成员账户的权限 | 写入 | |||
| ListAutomationRules | 授予权限以从 Security Hub 检索呼叫账户的自动化规则列表及其元数据 | 列出 | |||
| ListConfigurationPolicies | 授予列出调用账户所创建所有配置策略的摘要的权限 | 列出 | |||
| ListConfigurationPolicyAssociations | 授予检索与调用账户所在组织的所有成员账户和组织单位关联的所有配置策略信息的权限 | 列出 | |||
| ListControlEvaluationSummaries[仅权限] | 授予检索标准控件列表的权限，包括控件IDs、状态和查找次数 | 读取 | |||
| ListEnabledProductsForImport | 授予权限以检索当前启用的 Security Hub 集成产品 | 列出 | |||
| ListFindingAggregators | 授予权限以检索结果聚合器的列表，其中包含跨区域结果聚合配置 | 列出 | |||
| ListInvitations | 授予权限以检索发送到账户的 Security Hub 邀请 | List | |||
| ListMembers | 授予权限以检索与管理员账户关联的 Security Hub 成员账户的详细信息 | List | |||
| ListOrganizationAdminAccounts | 授予列出组织的 Security Hub 管理员帐户的权限 | 列出 |
organizations:DescribeOrganization |
||
| ListSecurityControlDefinitions | 授予权限以检索安全控件定义列表，其中包含当前区域中安全控件的详细信息 | 列出 | |||
| ListStandardsControlAssociations | 授予权限以列出标准中安全控件的启用状态 | 列出 |
securityhub:DescribeStandardsControls |
||
| ListTagsForResource | 授予权限以列出与资源关联的标签 | Read | |||
| SendFindingEvents[仅权限] | 授予使用自定义操作向亚马逊发送 Security Hub 调查结果的权限 EventBridge | 读取 | |||
| SendInsightEvents[仅权限] | 授予使用自定义操作向亚马逊发送 Security Hub 见解的权限 EventBridge | 读取 | |||
| StartConfigurationPolicyAssociation | 授予将某个配置策略关联到调用账户所在组织的某个成员账户或组织单位的权限 | 写入 | |||
| StartConfigurationPolicyDisassociation | 授予从调用账户所在组织的某个成员账户或组织单位移除某个配置策略的权限 | 写入 | |||
| TagResource | 授予权限以将标签添加到 Security Hub 资源 | Tagging | |||
| UntagResource | 授予权限以从 Security Hub 资源中删除标签 | Tagging | |||
| UpdateActionTarget | 授予权限以在 Security Hub 中更新自定义操作 | 写入 | |||
| UpdateConfigurationPolicy | 授予更新现有配置策略的权限 | 写入 | |||
| UpdateFindingAggregator | 授予权限以更新结果聚合器，其中包含跨区域结果聚合配置 | 写入 | |||
| UpdateFindings | 授予权限以更新 Security Hub 结果 | Write | |||
| UpdateInsight | 授予权限以在 Security Hub 中更新洞察 | Write | |||
| UpdateOrganizationConfiguration | 授予更新 Security Hub 组织配置的权限 | 写入 | |||
| UpdateSecurityControl | 授予更新由 ID 标识的特定安全控件属性的权限 ARN | 写入 |
securityhub:UpdateStandardsControl |
||
| UpdateSecurityHubConfiguration | 授予权限以更新 Security Hub 配置 | Write | |||
| UpdateStandardsControl | 授予权限以更新 Security Hub 标准控件 | Write |
AWS Security Hub 定义的资源类型
以下资源类型由此服务定义，可以在IAM权限策略语句的Resource元素中使用。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。
| 资源类型 | ARN | 条件键 |
|---|---|---|
| hub |
arn:${Partition}:securityhub:${Region}:${Account}:hub/default
|
|
| product |
arn:${Partition}:securityhub:${Region}:${Account}:product/${Company}/${ProductId}
|
|
| finding-aggregator |
arn:${Partition}:securityhub:${Region}:${Account}:finding-aggregator/${FindingAggregatorId}
|
|
| automation-rule |
arn:${Partition}:securityhub:${Region}:${Account}:automation-rule/${AutomationRuleId}
|
|
| configuration-policy |
arn:${Partition}:securityhub:${Region}:${Account}:configuration-policy/${ConfigurationPolicyId}
|
AWS Security Hub 的条件键
AWS Security Hub 定义了可以在IAM策略Condition元素中使用的以下条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。
要查看适用于所有服务的全局条件键，请参阅可用的全局条件键。
| 条件键 | 描述 | 类型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 根据在请求中是否具有标签键值对来按照操作筛选访问权限 | String |
| aws:ResourceTag/${TagKey} | 根据附加到资源的标签键值对来按操作筛选访问权限 | String |
| aws:TagKeys | 根据在请求中是否具有标签键来按操作筛选访问权限 | ArrayOfString |
| securityhub:ASFFSyntaxPath/${ASFFSyntaxPath} | 根据请求中的指定字段和值筛选访问权限 | String |
| securityhub:TargetAccount | 按请求中指定的 AwsAccountId 字段筛选访问权限 | String |
