

# Amazon Elastic Container Service Identity and Access 문제 해결
<a name="security_iam_troubleshoot"></a>

다음 정보를 사용하여 Amazon ECS 및 IAM으로 작업할 때 발생할 수 있는 일반적인 문제를 진단하고 수정할 수 있습니다.

**Topics**
+ [Amazon ECS에서 작업을 수행할 권한이 없음](#security_iam_troubleshoot-no-permissions)
+ [iam:PassRole을 수행하도록 인증되지 않음](#security_iam_troubleshoot-passrole)
+ [내 AWS 계정 외부의 사람이 내 Amazon ECS 리소스에 액세스할 수 있게 허용하고 싶음](#security_iam_troubleshoot-cross-account-access)
+ [Amazon ECS 관리형 인스턴스의 인스턴스 프로파일에 문제가 있음](#security_iam_instance-profile)
+ [추가 문제 해결 리소스](#security_iam_troubleshoot-additional-errors)

## Amazon ECS에서 작업을 수행할 권한이 없음
<a name="security_iam_troubleshoot-no-permissions"></a>

작업을 수행할 권한이 없다는 오류가 표시되면 작업을 수행할 수 있도록 정책을 업데이트해야 합니다.

다음의 예제 오류는 `mateojackson` IAM 사용자가 콘솔을 사용하여 가상 `{{my-example-widget}}` 리소스에 대한 세부 정보를 보려고 하지만 가상 `ecs:{{GetWidget}}` 권한이 없을 때 발생합니다.

```
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: ecs:{{GetWidget}} on resource: {{my-example-widget}}
```

이 경우, `ecs:{{GetWidget}}` 작업을 사용하여 `{{my-example-widget}}` 리소스에 액세스할 수 있도록 `mateojackson` 사용자 정책을 업데이트해야 합니다.

도움이 필요한 경우 AWS 관리자에게 문의하세요. 관리자는 로그인 자격 증명을 제공한 사람입니다.

## iam:PassRole을 수행하도록 인증되지 않음
<a name="security_iam_troubleshoot-passrole"></a>

`iam:PassRole` 작업을 수행할 수 있는 권한이 없다는 오류가 수신되면 Amazon ECS에 역할을 전달할 수 있도록 정책을 업데이트해야 합니다.

일부 AWS 서비스에서는 새로운 서비스 역할 또는 서비스 연결 역할을 생성하는 대신 해당 서비스에 기존 역할을 전달할 수 있습니다. 이렇게 하려면 사용자가 서비스에 역할을 전달할 수 있는 권한을 가지고 있어야 합니다.

다음 예제 오류는 `marymajor`라는 IAM 사용자가 콘솔을 사용하여 Amazon ECS에서 태스크를 수행하려고 하는 경우에 발생합니다. 하지만 작업을 수행하려면 서비스 역할이 부여한 권한이 서비스에 있어야 합니다. Mary는 서비스에 역할을 전달할 수 있는 권한을 가지고 있지 않습니다.

```
User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole
```

이 경우, Mary가 `iam:PassRole`작업을 수행할 수 있도록 Mary의 정책을 업데이트해야 합니다.

도움이 필요한 경우 AWS 관리자에게 문의하세요. 관리자는 로그인 자격 증명을 제공한 사람입니다.

Amazon ECS 관리형 인스턴스를 사용 중일 때 이 오류가 발생하는 경우 인스턴스 역할 이름이 관리형 정책에 필요한 명명 규칙과 일치하지 않을 수 있습니다. 자세한 내용은 [Amazon ECS 관리형 인스턴스의 인스턴스 프로파일에 문제가 있음](#security_iam_instance-profile) 섹션을 참조하세요.

## 내 AWS 계정 외부의 사람이 내 Amazon ECS 리소스에 액세스할 수 있게 허용하고 싶음
<a name="security_iam_troubleshoot-cross-account-access"></a>

다른 계정의 사용자 또는 조직 외부의 사람이 리소스에 액세스할 때 사용할 수 있는 역할을 생성할 수 있습니다. 역할을 수임할 신뢰할 수 있는 사람을 지정할 수 있습니다. 리소스 기반 정책 또는 액세스 제어 목록(ACL)을 지원하는 서비스의 경우, 이러한 정책을 사용하여 다른 사람에게 리소스에 대한 액세스 권한을 부여할 수 있습니다.

자세한 내용은 다음을 참조하세요.
+ Amazon ECS에서 이러한 기능을 지원하는지를 알아보려면 [Amazon Elastic Container Service가 IAM과 작동하는 방식](security_iam_service-with-iam.md)을 참조하세요.
+ 소유하고 있는 AWS 계정의 리소스에 대한 액세스 권한을 제공하는 방법을 알아보려면 *IAM 사용 설명서*의 [자신이 소유한 다른 AWS 계정의 IAM 사용자에 대한 액세스 권한 제공](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html)을 참조하세요.
+ 리소스에 대한 액세스 권한을 서드 파티 AWS 계정에게 제공하는 방법을 알아보려면 *IAM 사용 설명서*의 [서드 파티가 소유한 AWS 계정에 대한 액세스 제공](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)을 참조하세요.
+ ID 페더레이션을 통해 액세스 권한을 제공하는 방법을 알아보려면 *IAM 사용 설명서*의 [외부에서 인증된 사용자에게 액세스 권한 제공(ID 페더레이션)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)을 참조하세요.
+ 크로스 계정 액세스에 대한 역할과 리소스 기반 정책 사용의 차이점을 알아보려면 *IAM 사용 설명서*의 [IAM의 크로스 계정 리소스 액세스](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)를 참조하세요.

## Amazon ECS 관리형 인스턴스의 인스턴스 프로파일에 문제가 있음
<a name="security_iam_instance-profile"></a>

`AmazonECSInfrastructureRolePolicyForManagedInstances` 관리형 정책을 사용하는 경우 인스턴스 역할 이름은 `ecsInstanceRole`로 시작해야 합니다. 정책은 `iam:PassRole`을 `arn:aws:iam::*:role/ecsInstanceRole*`로 제한하므로 이름이 일치하지 않으면 태스크 시작 시 권한 부여 오류가 발생합니다.

CloudFormation에서는 `RoleName`을 `AWS::IAM::Role` 리소스에서 생략할 때 이 오류가 흔히 발생합니다. CloudFormation이 `MyStack-InstanceRole-ABC123`과 같이 정책 조건과 일치하지 않는 이름을 자동으로 생성하기 때문입니다.

이 문제를 해결하려면 다음 중 한 가지를 사용하십시오.
+ 이름이 관리형 정책과 일치하도록 `RoleName: ecsInstanceRole`을 `AWS::IAM::Role` 리소스에 추가합니다.
+ 인프라 역할에 인스턴스 역할 ARN을 대상으로 하는 명시적 `iam:PassRole` 인라인 정책을 추가합니다.

CloudFormation 템플릿 및 세부 단계는 [CloudFormation을 사용하여 인스턴스 프로파일 생성](managed-instances-instance-profile.md#create-instance-profile-cfn) 섹션을 참조하세요.

## 추가 문제 해결 리소스
<a name="security_iam_troubleshoot-additional-errors"></a>

다음 페이지에서는 오류 코드에 대한 정보를 제공합니다.
+  [Amazon ECS 중지된 작업 오류 메시지](stopped-task-error-codes.md) 
+  [Amazon ECS 서비스 이벤트 메시지 보기](service-event-messages.md) 