

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon WorkMail에서 IAM을 사용하는 방법
<a name="security_iam_service-with-iam"></a>

IAM을 사용하여 Amazon WorkMail에 대한 액세스를 관리하기 전에 Amazon WorkMail에서 사용할 수 있는 IAM 기능을 이해해야 합니다. Amazon WorkMail 및 기타 AWS 서비스에서 IAM을 사용하는 방법을 전체적으로 알아보려면 *IAM 사용 설명서*의 [AWS IAM으로 작업하는 서비스를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하세요.

**Topics**
+ [Amazon WorkMail 자격 증명 기반 정책](#security_iam_service-with-iam-id-based-policies)
+ [Amazon WorkMail 리소스 기반 정책](#security_iam_service-with-iam-resource-based-policies)
+ [Amazon WorkMail 태그 기반 권한 부여](#security_iam_service-with-iam-tags)
+ [Amazon WorkMail IAM 역할](#security_iam_service-with-iam-roles)

## Amazon WorkMail 자격 증명 기반 정책
<a name="security_iam_service-with-iam-id-based-policies"></a>

IAM ID 기반 정책을 사용하면 허용되거나 거부되는 작업과 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. Amazon WorkMail은 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 *IAM 사용 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요.

### 작업
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다.

JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.

Amazon WorkMail의 정책 작업은 작업 앞에 `workmail:` 접두사를 사용합니다. 예를 들어 `ListUsers` Amazon WorkMail API 작업을 사용하여 사용자 목록을 검색하는 권한을 부여하려면 해당 정책에 `workmail:ListUsers` 작업을 포함합니다. 정책 문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. Amazon WorkMail은 이 서비스로 수행할 수 있는 태스크를 설명하는 고유한 작업 집합을 정의합니다.

명령문 하나에 여러 태스크를 지정하려면 다음과 같이 쉼표로 구분합니다.

```
"Action": [
      "workmail:ListUsers",
      "workmail:DeleteUser"
```

와일드카드(\$1)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, `List`라는 단어로 시작하는 모든 작업을 지정하려면 다음 작업을 포함합니다.

```
"Action": "workmail:List*"
```



Amazon WorkMail 작업의 목록을 보려면 *IAM 사용 설명서*의 [Amazon WorkMail에서 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html#amazonworkmail-actions-as-permissions)을 참조하세요.

### 리소스
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다.

`Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\$1)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.

```
"Resource": "*"
```

Amazon WorkMail은 Amazon WorkMail 조직에 대한 리소스 수준 권한을 지원합니다.

Amazon WorkMail 조직 리소스에는 다음과 같은 ARN이 있습니다.

```
arn:aws:workmail:${Region}:${Account}:organization/${OrganizationId}
```

ARN 형식에 대한 자세한 내용은 [Amazon 리소스 이름(ARNs) 및 AWS 서비스 네임스페이스를 참조하세요](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).

예를 들어 문에서 `m-n1pq2345678r901st2u3vx45x6789yza` 조직을 지정하려면 다음 ARN을 사용합니다.

```
"Resource": "arn:aws:workmail:us-east-1:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza"
```

특정 계정에 속하는 모든 조직을 지정하려면 와일드카드(\$1)를 사용합니다.

```
"Resource": "arn:aws:workmail:us-east-1:111122223333:organization/*"
```

리소스 생성 작업과 같은 일부 Amazon WorkMail 작업은 특정 리소스에서 수행할 수 없습니다. 이러한 경우, 와일드카드(\$1)를 사용해야 합니다.

```
"Resource": "*"
```

Amazon WorkMail 리소스 유형 및 해당 ARN의 목록을 보려면 *IAM 사용 설명서*의 [Amazon WorkMail에서 정의한 리소스](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html#amazonworkmail-resources-for-iam-policies)를 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업에 대해 알아보려면 [Amazon WorkMail의 작업, 리소스 및 조건 키](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonworkmail.html)를 참조하십시오.

### 조건 키
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

Amazon WorkMail는 다음과 같은 전역 조건 키를 지원합니다.
+ `aws:CurrentTime`
+ `aws:EpochTime`
+ `aws:MultiFactorAuthAge`
+ `aws:MultiFactorAuthPresent`
+ `aws:PrincipalOrgID`
+ `aws:PrincipalArn`
+ `aws:RequestedRegion`
+ `aws:SecureTransport`
+ `aws:UserAgent`

다음 예제 정책은 `eu-west-1` AWS 리전에서 MFA 인증 IAM 보안 주체에 속한 Amazon WorkMail 콘솔에 대한 액세스 권한만 부여합니다.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ses:Describe*",
                "ses:Get*",
                "workmail:Describe*",
                "workmail:Get*",
                "workmail:List*",
                "workmail:Search*",
                "lambda:ListFunctions",
                "iam:ListRoles",
                "logs:DescribeLogGroups",
                "cloudwatch:GetMetricData"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestedRegion": [
                        "eu-west-1"
                    ]
                },
                "Bool": {
                    "aws:MultiFactorAuthPresent": true
                }
            }
        }
    ]
}
```

------

모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 참조하세요.

Amazon WorkMail에서 지원하는 유일한 서비스별 조건 키는 `workmail:ImpersonationRoleId`입니다.

다음 예제 정책은 `AssumeImpersonationRole` 작업의 범위를 특정 WorkMail 조직 및 위장 역할로 축소합니다.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "workmail:AssumeImpersonationRole"
      ],
      "Resource": "arn:aws:workmail:us-east-1:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza",
      "Condition": {
        "StringEquals": {
          "workmail:ImpersonationRoleId":"12345678-1234-1234-1234-123456789012"
        }
      }
    }
  ]
}
```

------

### 예제
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



Amazon WorkMail 자격 증명 기반 정책 예제를 보려면 [Amazon WorkMail 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md) 부분을 참조하세요.

## Amazon WorkMail 리소스 기반 정책
<a name="security_iam_service-with-iam-resource-based-policies"></a>

Amazon WorkMail은 리소스 기반 정책을 지원하지 않습니다.

## Amazon WorkMail 태그 기반 권한 부여
<a name="security_iam_service-with-iam-tags"></a>

Amazon WorkMail 리소스에 태그를 연결하거나 Amazon WorkMail에 대한 요청에서 태그를 전달할 수 있습니다. 태그에 근거하여 액세스를 제어하려면 `aws:ResourceTag/key-name`, `aws:RequestTag/key-name`또는 `aws:TagKeys`조건 키를 사용하여 정책의 [조건 요소](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)에 태그 정보를 제공합니다. Amazon WorkMail 리소스 태그 지정에 대한 자세한 내용은 [조직 태깅](org-tag.md) 부분을 참조하세요.

## Amazon WorkMail IAM 역할
<a name="security_iam_service-with-iam-roles"></a>

[IAM 역할은](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 특정 권한이 있는 AWS 계정 내 엔터티입니다.

### Amazon WorkMail에서 임시 보안 인증 사용
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

임시 보안 인증을 사용하여 페더레이션을 통해 로그인하거나, IAM 역할을 맡거나, 교차 계정 역할을 맡을 수 있습니다. [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) 또는 [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)과 같은 AWS STS API 작업을 호출하여 임시 보안 자격 증명을 얻습니다.

Amazon WorkMail은 임시 보안 인증 사용을 지원합니다.

### 서비스 연결 역할
<a name="security_iam_service-with-iam-roles-service-linked"></a>

[서비스 연결 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) 사용하면 AWS 서비스가 다른 서비스의 리소스에 액세스하여 사용자를 대신하여 작업을 완료할 수 있습니다. 서비스 연결 역할은 IAM 계정에 나타나고 서비스가 소유합니다. IAM 관리자는 서비스 연결 역할의 권한을 볼 수 있지만 편집할 수 없습니다.

Amazon WorkMail은 서비스 연결 역할을 지원합니다. Amazon WorkMail 서비스 연결 역할 생성 또는 관리에 대한 자세한 정보는 [Amazon WorkMail에 대해 서비스 연결 역할 사용](using-service-linked-roles.md) 부분을 참조하세요.

### 서비스 역할
<a name="security_iam_service-with-iam-roles-service"></a>

이 기능을 사용하면 서비스가 사용자를 대신하여 [서비스 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)을 수임할 수 있습니다. 이 역할을 사용하면 서비스가 다른 서비스의 리소스에 액세스해 사용자를 대신해 작업을 완료할 수 있습니다. 서비스 역할은 IAM 계정에 나타나고, 해당 계정이 소유합니다. 즉, IAM 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다.

Amazon WorkMail은 서비스 역할을 지원합니다.