AWS App Runner 는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS App Runner 가용성 변경](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)을 참조하세요. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # App Runner가 IAM에서 작동하는 방식 IAM을 사용하여 액세스를 관리하기 전에 App Runner에서 사용할 수 있는 IAM 기능을 이해해야 AWS App Runner합니다. App Runner 및 기타 AWS 서비스에서 IAM을 사용하는 방법을 전체적으로 알아보려면 *IAM 사용 설명서*의 [AWS IAM으로 작업하는 서비스를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하세요. 다른 App Runner 보안 주제는 섹션을 참조하세요[App Runner의 보안](security.md). **Topics** + [App Runner 자격 증명 기반 정책](#security_iam_service-with-iam-id-based-policies) + [App Runner 리소스 기반 정책](#security_iam_service-with-iam-resource-based-policies) + [App Runner 태그 기반 권한 부여](#security_iam_service-with-iam-tags) + [App Runner 사용자 권한](#security_iam_service-with-iam-users) + [App Runner IAM 역할](#security_iam_service-with-iam-roles) ## App Runner 자격 증명 기반 정책 IAM ID 기반 정책을 사용하면 허용되거나 거부되는 작업과 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. App Runner는 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 *IAM 사용 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요. ### 작업 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요. App Runner의 정책 작업은 작업 앞에 접두사를 사용합니다`apprunner:`. 예를 들어 누군가에게 Amazon EC2 `RunInstances` API 작업을 통해 Amazon EC2 인스턴스를 실행할 권한을 부여하려면 해당 정책에 `ec2:RunInstances` 작업을 포함하세요. 정책 문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. App Runner는이 서비스로 수행할 수 있는 작업을 설명하는 고유한 작업 세트를 정의합니다. 명령문 하나에 여러 태스크를 지정하려면 다음과 같이 쉼표로 구분합니다. ``` "Action": [ "apprunner:CreateService", "apprunner:CreateConnection" ] ``` 와일드카드(\*)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, `Describe`라는 단어로 시작하는 모든 작업을 지정하려면 다음 작업을 포함합니다. ``` "Action": "apprunner:Describe*" ``` App Runner 작업 목록을 보려면 *서비스 승인* 참조의에서 [정의한 작업을 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-actions-as-permissions) 참조하세요. ### 리소스 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. `Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\*)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다. ``` "Resource": "*" ``` App Runner 리소스의 ARN 구조는 다음과 같습니다. ``` arn:aws:apprunner:{{region}}:{{account-id}}:{{resource-type}}/{{resource-name}}[/{{resource-id}}] ``` ARNs 형식에 대한 자세한 내용은의 [Amazon 리소스 이름(ARNs) 및 AWS 서비스 네임스페이스](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)를 참조하세요*AWS 일반 참조*. 예를 들어 문에서 `my-service` 서비스를 지정하려면 다음 ARN을 사용합니다. ``` "Resource": "arn:aws:apprunner:us-east-1:123456789012:service/my-service" ``` 특정 계정에 속하는 모든 서비스를 지정하려면 와일드카드(\*)를 사용합니다. ``` "Resource": "arn:aws:apprunner:us-east-1:123456789012:service/*" ``` 리소스를 생성하기 위한 작업과 같은 일부 App Runner 작업은 특정 리소스에서 수행할 수 없습니다. 이러한 경우, 와일드카드(\*)를 사용해야 합니다. ``` "Resource": "*" ``` App Runner 리소스 유형 및 해당 ARNs 목록을 보려면 *서비스 승인* 참조의에서 [정의한 리소스를 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-resources-for-iam-policies) 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 [AWS App Runner가 정의한 작업](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-actions-as-permissions)을 참조하십시오. ### 조건 키 관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다. `Condition` 요소는 정의된 기준에 따라 문이 실행되는 시기를 지정합니다. 같음(equals) 또는 미만(less than)과 같은 [조건 연산자](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)를 사용하여 정책의 조건을 요청의 값과 일치시키는 조건식을 생성할 수 있습니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 참조하세요. App Runner는 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html). App Runner는 서비스별 조건 키 세트를 정의합니다. 또한 App Runner는 조건 키를 사용하여 구현되는 태그 기반 액세스 제어를 지원합니다. 자세한 내용은 [App Runner 태그 기반 권한 부여](#security_iam_service-with-iam-tags)을 참조하세요. App Runner 조건 키 목록을 보려면 *서비스 승인* 참조의에 [대한 조건 키를 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-policy-keys) 참조하세요. 조건 키를 사용할 수 있는 작업과 리소스를 알아보려면 [에서 정의한 작업을 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-actions-as-permissions) 참조하세요. ### 예제 App Runner 자격 증명 기반 정책의 예를 보려면 섹션을 참조하세요[App Runner 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md). ## App Runner 리소스 기반 정책 App Runner는 리소스 기반 정책을 지원하지 않습니다. ## App Runner 태그 기반 권한 부여 App Runner 리소스에 태그를 연결하거나 App Runner에 대한 요청에서 태그를 전달할 수 있습니다. 태그에 근거하여 액세스를 제어하려면 `apprunner:ResourceTag/{{key-name}}`, `aws:RequestTag/{{key-name}}`또는 `aws:TagKeys`조건 키를 사용하여 정책의 [조건 요소](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)에 태그 정보를 제공합니다. App Runner 리소스 태그 지정에 대한 자세한 내용은 섹션을 참조하세요[App Runner 서비스 구성](manage-configure.md). 리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예시는 [태그를 기반으로 App Runner 서비스에 대한 액세스 제어](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-widget-tags)에서 확인할 수 있습니다. ## App Runner 사용자 권한 App Runner를 사용하려면 IAM 사용자에게 App Runner 작업에 대한 권한이 필요합니다. 사용자에게 권한을 부여하는 일반적인 방법은 IAM 사용자 또는 그룹에 정책을 연결하는 것입니다. 사용자 권한 관리에 대한 자세한 내용은 [IAM 사용 설명서의 IAM 사용자의 권한 변경을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html) 참조하세요. ** App Runner는 사용자에게 연결할 수 있는 두 가지 관리형 정책을 제공합니다. + [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerReadOnlyAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerReadOnlyAccess.html) - App Runner 리소스에 대한 세부 정보를 나열하고 볼 수 있는 권한을 부여합니다. + [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerFullAccess.html)- 모든 App Runner 작업에 대한 권한을 부여합니다. 사용자 권한을 보다 세밀하게 제어하려면 사용자 지정 정책을 생성하여 사용자에게 연결할 수 있습니다. 자세한 내용은 [IAM 사용 설명서의 IAM 정책 생성을](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) 참조하세요. ** 사용자 정책의 예는 섹션을 참조하세요[사용자 정책](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-users). ## App Runner IAM 역할 [IAM 역할은](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 특정 권한이 AWS 계정 있는 내의 엔터티입니다. ### 서비스 연결 역할 [서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) 사용하면 AWS 서비스가 다른 서비스의 리소스에 액세스하여 사용자를 대신하여 작업을 완료할 수 있습니다. 서비스 연결 역할은 IAM 계정에 나타나고 서비스가 소유합니다. IAM 관리자는 서비스 연결 역할의 권한을 볼 수 있지만 편집할 수 없습니다. App Runner는 서비스 연결 역할을 지원합니다. App Runner 서비스 연결 역할 생성 또는 관리에 대한 자세한 내용은 섹션을 참조하세요[App Runner에 서비스 연결 역할 사용](security-iam-slr.md). ### 서비스 역할 이 기능을 사용하면 서비스가 사용자를 대신하여 [서비스 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)을 수임할 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 IAM 계정에 나타나고, 해당 계정이 소유합니다. 즉, IAM 사용자는이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다. App Runner는 몇 가지 서비스 역할을 지원합니다. #### 액세스 역할 액세스 역할은 App Runner가 계정의 Amazon Elastic Container Registry(Amazon ECR)에 있는 이미지에 액세스하는 데 사용하는 역할입니다. Amazon ECR의 이미지에 액세스하는 데 필요하며 Amazon ECR Public에서는 필요하지 않습니다. Amazon ECR의 이미지를 기반으로 서비스를 생성하기 전에 IAM을 사용하여 서비스 역할을 생성합니다. 서비스 역할[https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerServicePolicyForECRAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerServicePolicyForECRAccess.html)에서 관리형 정책을 사용합니다. 그런 다음 [SourceConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_SourceConfiguration.html) 파라미터의 [AuthenticationConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_AuthenticationConfiguration.html) 멤버에서 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API를 호출하거나 App Runner 콘솔을 사용하여 서비스를 생성할 때이 역할을 App Runner에 전달할 수 있습니다. **참고** 액세스 역할에 대한 사용자 지정 정책을 직접 생성하는 경우 `ecr:GetAuthorizationToken` 작업에 `"Resource": "*"`를 지정해야 합니다. 토큰은 액세스 권한이 있는 모든 Amazon ECR 레지스트리에 액세스하는 데 사용할 수 있습니다. 액세스 역할을 생성할 때 App Runner 서비스 보안 주체를 신뢰할 수 있는 엔터티`build.apprunner.amazonaws.com`로 선언하는 신뢰 정책을 추가해야 합니다. ##### 액세스 역할에 대한 신뢰 정책 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "build.apprunner.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ App Runner 콘솔을 사용하여 서비스를 생성하는 경우 콘솔은 자동으로 액세스 역할을 생성하고 새 서비스에 대해 선택할 수 있습니다. 콘솔에는 계정의 다른 역할도 나열되며 원하는 경우 다른 역할을 선택할 수 있습니다. #### 인스턴스 역할 인스턴스 역할은 App Runner가 서비스의 컴퓨팅 인스턴스에 필요한 AWS 서비스 작업에 대한 권한을 제공하는 데 사용하는 선택적 역할입니다. 애플리케이션 코드가 AWS 작업(APIs. 인스턴스 역할에 필요한 권한을 포함하거나 자체 사용자 지정 정책을 생성하여 인스턴스 역할에 사용합니다. 코드에서 사용하는 호출을 예상할 수 있는 방법은 없습니다. 따라서 이러한 목적으로 관리형 정책을 제공하지 않습니다. App Runner 서비스를 생성하기 전에 IAM을 사용하여 필요한 사용자 지정 또는 임베디드 정책으로 서비스 역할을 생성합니다. 그런 다음 [InstanceConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_InstanceConfiguration.html) 파라미터의 `InstanceRoleArn` 멤버에서 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API를 호출하거나 App Runner 콘솔을 사용하여 서비스를 생성할 때이 역할을 App Runner에 인스턴스 역할로 전달할 수 있습니다. 인스턴스 역할을 생성할 때 App Runner 서비스 보안 주체를 신뢰할 수 있는 엔터티`tasks.apprunner.amazonaws.com`로 선언하는 신뢰 정책을 추가해야 합니다. ##### 인스턴스 역할에 대한 신뢰 정책 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "tasks.apprunner.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ App Runner 콘솔을 사용하여 서비스를 생성하는 경우 콘솔은 계정의 역할을 나열하고이 목적으로 생성한 역할을 선택할 수 있습니다. 서비스 생성에 대한 자세한 내용은 섹션을 참조하세요[App Runner 서비스 생성](manage-create.md).