기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS Security Agent에 사용되는 작업, 리소스 및 조건 키
AWS Security Agent(서비스 접두사: securityagent)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
AWS Security Agent에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 레벨 열은 작업이 분류되는 방법(나열, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 레벨에 대한 자세한 내용은 정책 요약의 액세스 레벨을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| AddArtifact | 지정된 에이전트 인스턴스에 대한 아티팩트를 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| AddControl | 고객 관리형 컨트롤을 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| BatchDeletePentests | 단일 요청으로 여러 침투 테스트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| BatchGetAgentInstances | 단일 요청으로 여러 에이전트 인스턴스를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| BatchGetArtifactMetadata | 지정된 에이전트 인스턴스에 대해 하나 이상의 아티팩트 메타데이터 레코드를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| BatchGetFindings | 단일 요청으로 여러 보안 테스트 결과를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| BatchGetPentestJobs | 단일 요청으로 여러 보안 테스트 작업을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| BatchGetPentests | 단일 요청으로 여러 침투 테스트를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| BatchGetSecurityTestContentMetadata | 단일 요청으로 여러 보안 테스트 콘텐츠 메타데이터를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| BatchGetTasks | 단일 요청으로 여러 보안 테스트 작업을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| CreateAgentInstance | 에이전트 인스턴스 레코드를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateApplication | 새 애플리케이션을 생성할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole sso:CreateApplication |
||
| CreateDocumentReview | 문서 검토를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateIntegration | 보안 테스트 통합을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateMembership | 역할이 지정된 에이전트 인스턴스에 단일 멤버를 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateOneTimeLoginSession | 일회성 로그인 세션을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreatePentest | 새 침투 테스트 구성을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAgentInstance | 에이전트 인스턴스 레코드를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteApplication | 애플리케이션을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteArtifact | 아티팩트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteControl | 고객 관리형 컨트롤을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteIntegration | 애플리케이션의 통합을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteMembership | 에이전트 인스턴스에 연결된 단일 멤버를 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DescribeFindings | 침투 테스트 또는 침투 테스트의 보안 테스트 작업에 대한 보안 결과를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetApplication | 애플리케이션 ID별로 애플리케이션 세부 정보를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetArtifact | 지정된 에이전트 인스턴스에 대한 아티팩트를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetCodeReviewTask | 코드 검토 작업을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetControl | 컨트롤을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDocReviewTask | 문서 검토 작업을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDocumentReview | 연결된 에이전트 인스턴스 문서 검토의 상태를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetDocumentReviewArtifact | 특정 문서에 대한 문서 검토 아티팩트를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetIntegration | ID별로 통합 메타데이터를 가져올 수 있는 권한을 부여합니다. | 읽기 | |||
| GetLoginSessionCredentials | 일회성 로그인 세션에 대한 자격 증명을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
| HandleOneTimeLoginSession | 일회성 로그인 세션을 처리하고 무효화할 수 있는 권한을 부여합니다. | 쓰기 | |||
| InitiateProviderRegistration | 지정된 공급자(예: GitHub)에 대한 Security Agent 앱 등록을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| ListAgentInstanceTasks | 특정 에이전트 인스턴스에 대한 작업을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAgentInstances | 에이전트 인스턴스를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListApplications | 계정의 모든 애플리케이션을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListArtifacts | 지정된 프로젝트의 모든 아티팩트를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListControls | 모든 컨트롤을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListDiscoveredEndpoints | 선택적 URI 접두사 필터링을 사용하여 pentest 작업과 연결된 검색된 엔드포인트를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListDocumentReviewComments | 문서 검토 설명을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListDocumentReviews | 지정된 프로젝트에 대한 모든 문서 검토를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListFindings | 필터링 및 페이지 매김 지원을 통해 조사 결과를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListIntegratedResources | 에이전트 인스턴스에 대한 통합 리소스를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListIntegrations | 호출자의에서 소유한 통합을 가져올 수 있는 권한을 부여합니다. AWS 계정 | List | |||
| ListMemberships | 페이지 매김을 지원하는 에이전트 인스턴스에 연결된 모든 멤버를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListPentestJobsForPentest | 침투 테스트와 연결된 침투 테스트 작업을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListPentests | 상태별 선택적 필터링을 사용하여 침투 테스트를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListResourcesFromIntegration | 통합의 리소스를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListTasks | pentest 작업과 연결된 보안 테스트 작업을 나열할 수 있는 권한을 부여합니다. | List | |||
| StartCodeRemediation | 결과에 대한 코드 수정을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartPentestExecution | 침투 테스트 실행을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopPentestExecution | 실행 중인 침투 테스트의 실행을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| ToggleManagedControl | 상태를 전환할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateAgentInstance | 에이전트 인스턴스 레코드를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateApplication | 애플리케이션 구성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| UpdateControl | 고객 관리형 컨트롤을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateFinding | 기존 보안 조사 결과를 새 세부 정보 또는 상태로 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateIntegratedResources | 에이전트 인스턴스에 대한 통합 리소스를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdatePentest | 기존 침투 테스트를 새 구성 또는 설정으로 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| VerifyTargetDomain | 에이전트 인스턴스에서 등록된 대상 도메인의 소유권을 확인할 수 있는 권한을 부여합니다. | 쓰기 |
AWS Security Agent에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 조건 키 | ARN | 조건 키 |
|---|---|---|
| Application |
arn:${Partition}:securityagent:${Region}:${Account}:application/${ApplicationId}
|
|
| Control |
arn:${Partition}:securityagent:${Region}:${Account}:control/${ControlId}
|
|
| Integration |
arn:${Partition}:securityagent:${Region}:${Account}:integration/${IntegrationId}
|
|
| AgentInstance |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}
|
|
| Artifact |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/artifact/${ArtifactId}
|
|
| Pentest |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest/${PentestId}
|
|
| PentestJob |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest-job/${JobId}
|
|
| PentestTask |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest-task/${TaskId}
|
|
| Finding |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/finding/${FindingId}
|
AWS Security Agent에 사용되는 조건 키
securityagent에는 정책 설명의 Condition 요소에 사용할 수 있는 서비스별 컨텍스트 키가 없습니다. 모든 서비스에 사용할 수 있는 전역 컨텍스트 키의 목록은 AWS 전역 조건 컨텍스트 키를 참조하세요.
