Amazon Security Hub 的操作、资源和条件键
Amazon Security Hub(服务前缀:securityhub)提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。
参考:
Amazon Security Hub 定义的操作
您可以在 IAM policy 语句的 Action 元素中指定以下操作。可以使用策略授予在 Amazon 中执行操作的权限。您在策略中使用一项操作时,通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource 元素中指定策略应用的所有资源(“*”)。通过在 IAM policy 中使用条件来筛选访问权限,以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源,则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限,则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种可选资源类型。
操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息,请参阅资源类型表的条件键列。
有关下表中各列的详细信息,请参阅操作表。
| 操作 | 描述 | 访问级别 | 资源类型(* 为必需) | 条件键 | 相关操作 |
|---|---|---|---|---|---|
| AcceptAdministratorInvitation | 授予权限以接受成为成员账户的 Security Hub 邀请 | Write | |||
| AcceptInvitation | 授予权限以接受成为成员账户的 Security Hub 邀请 | Write | |||
| BatchDisableStandards | 授予权限以在 Security Hub 中禁用标准 | Write | |||
| BatchEnableStandards | 授予权限以在 Security Hub 中启用标准 | Write | |||
| BatchGetSecurityControls | 授予权限以获取通过 ID 或 ARN 标识的特定安全控件的详细信息 | Read |
securityhub:DescribeStandardsControls |
||
| BatchGetStandardsControlAssociations | 授予权限以获取标准中一批安全控件的启用状态 | Read |
securityhub:DescribeStandardsControls |
||
| BatchImportFindings | 授予权限以将结果从集成产品导入 Security Hub | Write | |||
| BatchUpdateFindings | 授予权限以更新一组选定的 Security Hub 结果的客户控制字段 | Write | |||
| BatchUpdateStandardsControlAssociations | 授予权限以更新标准中一批安全控件的启用状态 | Write |
securityhub:UpdateStandardsControl |
||
| CreateActionTarget | 授予权限以在 Security Hub 中创建自定义操作 | Write | |||
| CreateFindingAggregator | 授予权限以创建结果聚合器,其中包含跨区域结果聚合配置 | Write | |||
| CreateInsight | 授予权限以在 Security Hub 中创建洞察。洞察是相关结果的集合 | Write | |||
| CreateMembers | 授予权限以在 Security Hub 中创建成员账户 | Write | |||
| DeclineInvitations | 授予权限以拒绝成为成员账户的 Security Hub 邀请 | Write | |||
| DeleteActionTarget | 授予权限以删除 Security Hub 中的自定义操作 | Write | |||
| DeleteFindingAggregator | 授予权限以删除结果聚合器,这将禁用跨区域结果聚合 | Write | |||
| DeleteInsight | 授予权限以从 Security Hub 中删除洞察 | Write | |||
| DeleteInvitations | 授予权限以删除成为成员账户的 Security Hub 邀请 | Write | |||
| DeleteMembers | 授予权限以删除 Security Hub 成员账户 | Write | |||
| DescribeActionTargets | 授予权限以使用 API 检索自定义操作列表 | Read | |||
| 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)检索洞察结果 | Read | |||
| GetAdministratorAccount | 授予权限以检索有关 Security Hub 管理员账户的详细信息 | Read | |||
| GetControlFindingSummary [仅权限] | 授予检索安全评分以及安全标准状态的调查结果计数和控件状态的权限 | Read | |||
| GetEnabledStandards | 授予权限以检索在 Security Hub 中启用的标准列表 | List | |||
| GetFindingAggregator | 授予权限以检索结果聚合器的详细信息,这将配置跨区域结果聚合 | Read | |||
| 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 成员账户的详细信息 | Read | |||
| GetUsage [仅权限] | 授予权限以按账户检索有关 Security Hub 使用情况的信息 | Read | |||
| InviteMembers | 授予权限以邀请其他Amazon账户成为 Security Hub 成员账户 | Write | |||
| ListControlEvaluationSummaries [仅权限] | 授予检索标准控件列表的权限,包括控件 ID、状态和调查结果计数 | Read | |||
| ListEnabledProductsForImport | 授予权限以检索当前启用的 Security Hub 集成产品 | List | |||
| ListFindingAggregators | 授予权限以检索结果聚合器的列表,其中包含跨区域结果聚合配置 | List | |||
| ListInvitations | 授予权限以检索发送到账户的 Security Hub 邀请 | List | |||
| ListMembers | 授予权限以检索与管理员账户关联的 Security Hub 成员账户的详细信息 | List | |||
| ListOrganizationAdminAccounts | 授予列出组织的 Security Hub 管理员帐户的权限 | List |
organizations:DescribeOrganization |
||
| ListSecurityControlDefinitions | 授予权限以检索安全控件定义列表,其中包含当前区域中安全控件的详细信息 | List | |||
| ListStandardsControlAssociations | 授予权限以列出标准中安全控件的启用状态 | List |
securityhub:DescribeStandardsControls |
||
| ListTagsForResource | 授予权限以列出与资源关联的标签 | Read | |||
| SendFindingEvents [仅权限] | 授予权限以使用自定义操作将 Security Hub 结果发送到 Amazon EventBridge | Read | |||
| SendInsightEvents [仅权限] | 授予权限以使用自定义操作将 Security Hub 洞察发送到 Amazon EventBridge | Read | |||
| TagResource | 授予权限以将标签添加到 Security Hub 资源 | Tagging | |||
| UntagResource | 授予权限以从 Security Hub 资源中删除标签 | Tagging | |||
| UpdateActionTarget | 授予权限以在 Security Hub 中更新自定义操作 | Write | |||
| UpdateFindingAggregator | 授予权限以更新结果聚合器,其中包含跨区域结果聚合配置 | Write | |||
| UpdateFindings | 授予权限以更新 Security Hub 结果 | Write | |||
| UpdateInsight | 授予权限以在 Security Hub 中更新洞察 | Write | |||
| UpdateOrganizationConfiguration | 授予更新 Security Hub 组织配置的权限 | Write | |||
| UpdateSecurityHubConfiguration | 授予权限以更新 Security Hub 配置 | Write | |||
| UpdateStandardsControl | 授予权限以更新 Security Hub 标准控件 | Write |
Amazon 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}
|
Amazon Security Hub 的条件键
Amazon Security Hub 定义以下可以在 IAM policy 的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息,请参阅条件键表。
要查看适用于所有服务的全局条件键,请参阅可用的全局条件键。
| 条件键 | 描述 | 类型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 根据在请求中是否具有标签键值对来按照操作筛选访问权限 | 字符串 |
| aws:ResourceTag/${TagKey} | 根据附加到资源的标签键值对来按操作筛选访问权限 | 字符串 |
| aws:TagKeys | 根据在请求中是否具有标签键来按操作筛选访问权限 | 字符串数组 |
| securityhub:ASFFSyntaxPath/${ASFFSyntaxPath} | 根据请求中的指定字段和值筛选访问权限 | 字符串 |
| securityhub:TargetAccount | 按请求中指定的 AwsAccountId 字段筛选访问权限 | 字符串 |