AWS Security Agent 的動作、資源和條件索引鍵 - 服務授權參考
動作資源類型條件索引鍵

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS Security Agent 的動作、資源和條件索引鍵

AWS Security Agent （服務字首：securityagent) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

AWS Security Agent 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

動作資料表的存取層級欄說明動作的分類方式 （列出、讀取、許可管理或標記）。此分類可協助您了解在政策中使用某動作時，該動作授予您的存取層級。如需存取層級的詳細資訊，請參閱政策摘要中的存取層級。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了 動作本身的許可之外，還可能需要這些許可。當動作指定相依動作時，這些相依性可能適用於針對該動作定義的其他資源，而不只是資料表中列出的第一個資源。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作 描述 存取層級 資源類型 (*必填項目) 條件索引鍵 相依動作
AddArtifact 准許為指定的代理程式執行個體新增成品 寫入

AgentSpace*

AddControl 准許新增客戶受管控制項 寫入

Application*

BatchDeletePentests 准許在單一請求中刪除多個滲透測試 寫入

AgentSpace*

BatchGetAgentInstances 准許在單一請求中擷取多個代理程式執行個體 讀取

AgentInstance*

BatchGetAgentSpaces 准許在單一請求中擷取多個代理程式空間 讀取

AgentSpace*

BatchGetArtifactMetadata 准許擷取指定代理程式執行個體的一或多個成品中繼資料記錄 讀取

AgentSpace*

BatchGetFindings 准許擷取單一請求中的多個安全測試問題清單 讀取

AgentSpace*

BatchGetPentestJobContentMetadata 准許在單一請求中擷取多個 pentest 任務內容中繼資料 讀取

AgentSpace*

BatchGetPentestJobTasks 准許在單一請求中擷取多個 pentest 任務 讀取

AgentSpace*

BatchGetPentestJobs 准許在單一請求中擷取多個安全測試任務 讀取

AgentSpace*

BatchGetPentests 准許在單一請求中擷取多個滲透測試 讀取

AgentSpace*

BatchGetSecurityTestContentMetadata 准許擷取單一請求中的多個安全性測試內容中繼資料 讀取

AgentSpace*

BatchGetTasks 准許在單一請求中擷取多個安全測試任務 讀取

AgentSpace*

CreateAgentInstance 准許建立代理程式執行個體記錄 寫入

Application*

CreateAgentSpace 准許建立代理程式空間記錄 寫入
CreateApplication 准許建立新的應用程式 寫入

iam:PassRole

sso:CreateApplication

CreateDesignReview 准許建立設計檢閱 寫入

AgentSpace*

CreateDocumentReview 准許建立文件檢閱 寫入

AgentSpace*

CreateIntegration 准許建立安全測試整合 寫入

Application*

CreateMembership 准許將單一成員新增至具有指定角色的代理程式執行個體 寫入

AgentSpace*

CreateOneTimeLoginSession 准許建立一次性登入工作階段 寫入

AgentSpace*

CreatePentest 准許建立新的滲透測試組態 寫入

AgentSpace*

CreateSecurityRequirement 准許新增客戶受管安全要求 寫入

Application*

DeleteAgentInstance 准許刪除代理程式執行個體記錄 寫入

AgentInstance*

DeleteAgentSpace 准許刪除客服人員空間記錄 寫入

AgentSpace*

DeleteApplication 准許刪除應用程式 寫入

Application*

DeleteArtifact 准許刪除成品 寫入

AgentSpace*

DeleteControl 准許刪除客戶受管控制 寫入

Control*

DeleteDesignReview 准許刪除設計檢閱 寫入

AgentSpace*

DeleteDocumentReview 准許刪除文件檢閱 寫入

AgentSpace*

DeleteIntegration 准許刪除應用程式的整合 寫入

Integration*

DeleteMembership 准許移除與代理程式執行個體相關聯的單一成員 寫入

AgentSpace*

DeleteSecurityRequirement 准許刪除客戶受管安全要求 寫入

SecurityRequirement*

DescribeFindings 准許擷取滲透測試的安全調查結果或滲透測試中的安全測試任務 讀取

AgentSpace*

GetApplication 准許依應用程式 ID 取得應用程式詳細資訊 讀取

Application*

GetArtifact 准許擷取指定代理程式執行個體的成品 讀取

AgentSpace*

GetCodeReviewTask 准許擷取 Code Review Task 讀取

AgentSpace*

GetControl 准許擷取控制項 讀取

Control*

GetDesignReview 准許取得相關代理程式空間設計檢閱的狀態 讀取

AgentSpace*

GetDesignReviewArtifact 准許取得特定文件的設計檢閱成品 讀取

AgentSpace*

GetDocReviewTask 准許擷取文件檢閱任務 讀取

AgentSpace*

GetDocumentReview 准許取得相關聯客服人員執行個體文件檢閱的狀態 讀取

AgentSpace*

GetDocumentReviewArtifact 准許取得特定文件的文件檢閱成品 讀取

AgentSpace*

GetIntegration 准許依 ID 取得整合中繼資料 讀取

Integration*

GetLoginSessionCredentials 准許擷取一次性登入工作階段的登入資料 讀取
GetSecurityRequirement 准許擷取安全需求 讀取

SecurityRequirement*

HandleOneTimeLoginSession 准許處理和使一次性登入工作階段失效 寫入
InitiateProviderRegistration 准許啟動指定提供者的安全代理程式應用程式的註冊 （例如：GitHub) 寫入

Application*

ListAgentInstanceTasks 准許列出特定代理程式執行個體的任務 清單

AgentInstance*

ListAgentInstances 准許列出代理程式執行個體 清單
ListAgentSpaces 准許列出代理程式空間 清單
ListApplications 准許列出帳戶中的所有應用程式 清單
ListArtifacts 准許列出指定專案的所有成品 清單

AgentSpace*

ListControls 准許列出所有控制項 清單
ListDesignReviewComments 准許列出設計評論 清單

AgentSpace*

ListDesignReviews 准許列出指定專案的所有設計檢閱 清單

AgentSpace*

ListDiscoveredEndpoints 准許使用選用的 URI 字首篩選列出與 pentest 任務相關聯的探索端點 清單

AgentSpace*

ListDocumentReviewComments 准許列出文件評論 清單

AgentSpace*

ListDocumentReviews 准許列出指定專案的所有文件檢閱 清單

AgentSpace*

ListFindings 准許列出具有篩選和分頁支援的調查結果 清單

AgentSpace*

ListIntegratedResources 准許列出代理程式執行個體的整合資源 清單

AgentSpace*

ListIntegrations 准許取得發起人的 擁有的整合 AWS 帳戶 清單
ListMemberships 准許列出與具有分頁支援之代理程式執行個體相關聯的所有成員 清單

AgentSpace*

ListPentestJobTasks 准許列出與 pentest 任務相關聯的 pentest 任務 清單

AgentSpace*

ListPentestJobsForPentest 准許列出與滲透測試相關聯的滲透測試任務 清單

AgentSpace*

ListPentests 准許列出依狀態選擇性篩選的滲透測試 清單

AgentSpace*

ListResourcesFromIntegration 准許從整合列出資源 清單

Integration*

ListSecurityRequirements 准許列出所有安全需求 清單
ListTasks 准許列出與 pentest 任務相關聯的安全測試任務 清單

AgentSpace*

StartCodeRemediation 准許開始問題清單的程式碼修復 寫入

AgentSpace*

StartPentestExecution 准許啟動滲透測試的執行 寫入

AgentSpace*

StartPentestJob 准許啟動滲透測試的執行 寫入

AgentSpace*

StopPentestExecution 准許停止執行中的滲透測試 寫入

AgentSpace*

StopPentestJob 准許停止執行中的滲透測試 寫入

AgentSpace*

ToggleManagedControl 准許切換狀態 寫入

Control*

ToggleManagedSecurityRequirement 准許切換受管安全要求的狀態 寫入

SecurityRequirement*

UpdateAgentInstance 准許更新代理程式執行個體記錄 寫入

AgentInstance*

UpdateAgentSpace 准許更新代理程式空間記錄 寫入

AgentSpace*

UpdateApplication 准許更新應用程式組態 寫入

Application*

iam:PassRole

UpdateControl 准許更新客戶受管控制 寫入

Control*

UpdateFinding 准許更新具有新詳細資訊或狀態的現有安全調查結果 寫入

AgentSpace*

UpdateIntegratedResources 准許更新代理程式執行個體的整合資源 寫入

AgentSpace*

UpdatePentest 准許使用新組態或設定更新現有的滲透測試 寫入

AgentSpace*

UpdateSecurityRequirement 准許更新客戶受管安全要求 寫入

SecurityRequirement*

VerifyTargetDomain 准許驗證代理程式執行個體中已註冊目標網域的擁有權 寫入

AgentSpace*

AWS Security Agent 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。

資源類型 ARN 條件索引鍵
Application arn:${Partition}:securityagent:${Region}:${Account}:application/${ApplicationId}
Control arn:${Partition}:securityagent:${Region}:${Account}:control/${ControlId}
SecurityRequirement arn:${Partition}:securityagent:${Region}:${Account}:security-requirement/${SecurityRequirementId}
Integration arn:${Partition}:securityagent:${Region}:${Account}:integration/${IntegrationId}
AgentInstance arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}
AgentSpace arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}
Artifact arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/artifact/${ArtifactId}
Pentest arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/pentest/${PentestId}
PentestJob arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/pentest-job/${JobId}
PentestTask arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/pentest-task/${TaskId}
Finding arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}/finding/${FindingId}

AWS Security Agent 的條件索引鍵

securityagent 沒有可在政策陳述式 Condition元素中使用的服務特定內容索引鍵。如需所有 服務可用的全域內容索引鍵清單，請參閱AWS 全域條件內容索引鍵。