**참고**: Amazon WorkDocs에서는 새 고객 가입 및 계정 업그레이드를 더 이상 사용할 수 없습니다. 여기에서 마이그레이션 단계에 대해 알아봅니다. [ WorkDocs에서 데이터를 마이그레이션하는 방법](https://aws.amazon.com/blogs/business-productivity/how-to-migrate-content-from-amazon-workdocs).

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

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

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

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

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

IAM 자격 증명 기반 정책을 사용하면 허용 또는 거부된 작업을 지정할 수 있습니다. WorkDocs는 특정 작업을 지원합니다. 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` 요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 정책 작업은 일반적으로 연결된 AWS API 작업과 이름이 동일합니다. 일치하는 API 작업이 없는 권한 *전용 작업* 같은 몇 가지 예외도 있습니다. 정책에서 여러 작업이 필요한 몇 가지 작업도 있습니다. 이러한 추가 작업을 일컬어 *종속 작업*이라고 합니다.

연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.

WorkDocs의 정책 작업은 작업 앞에 접두사를 사용합니다`workdocs:`. 예를 들어 WorkDocs `DescribeUsers` API 작업을 실행할 수 있는 권한을 부여하려면 해당 정책에 `workdocs:DescribeUsers` 작업을 포함합니다. 정책 문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. WorkDocs는이 서비스로 수행할 수 있는 작업을 설명하는 고유한 작업 세트를 정의합니다.

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

```
"Action": [
      "workdocs:DescribeUsers",
      "workdocs:CreateUser"
```

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

```
"Action": "workdocs:Describe*"
```



**참고**  
이전 버전과의 호환성을 보장하려면 `zocalo` 작업을 포함하세요. 예시:  

```
"Action": [
"zocalo:*",
"workdocs:*"
],
```

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

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

WorkDocs는 정책에서 리소스 ARNs을 지정하는 기능을 지원하지 않습니다.

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

WorkDocs는 서비스별 조건 키를 제공하지 않지만 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) 참조하세요.

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



WorkDocs 자격 증명 기반 정책의 예를 보려면 섹션을 참조하세요[Amazon WorkDocs 보안 인증 기반 정책 예제](security_iam_id-based-policy-examples.md).

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

WorkDocs는 리소스 기반 정책을 지원하지 않습니다.

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

WorkDocs는 리소스 태그 지정 또는 태그 기반 액세스 제어를 지원하지 않습니다.

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

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

### WorkDocs에서 임시 자격 증명 사용
<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 작업을 호출하여 임시 보안 자격 증명을 얻습니다.

WorkDocs는 임시 자격 증명 사용을 지원합니다.

### 서비스 연결 역할
<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 관리자는 서비스 연결 역할의 권한을 볼 수 있지만 편집할 수 없습니다.

WorkDocs는 서비스 연결 역할을 지원하지 않습니다.

### 서비스 역할
<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 관리자가 이 역할에 대한 권한을 변경할 수 있습니다. 그러나 권한을 변경하면 서비스의 기능이 손상될 수 있습니다.

WorkDocs는 서비스 역할을 지원하지 않습니다.