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

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

# 타사 개발자에게 WorkDocs APIs에 대한 권한 부여
<a name="wd-iam-crossacct"></a>

타사 개발자 또는 다른 AWS 계정을 사용하는 사용자에게 액세스 권한을 부여할 수 있습니다. 이렇게 하려면 IAM 역할을 생성하고 WorkDocs API 허용 정책을 연결합니다.

이런 형태의 액세스가 필요한 경우는 다음과 같습니다.
+ 개발자는 동일한 조직에 속하지만 개발자의 AWS 계정이 WorkDocs AWS 계정과 다릅니다.
+ 기업이 타사 애플리케이션 개발자에게 WorkDocs API 액세스 권한을 부여하려는 경우.

이 두 시나리오에는 개발자 AWS 계정과 WorkDocs 사이트를 호스팅하는 다른 계정이라는 AWS 두 개의 계정이 관여합니다.

계정 관리자가 IAM 역할을 생성할 수 있도록 개발자는 다음 정보를 제공해야 합니다.
+  AWS 계정 ID
+ 고객이 개발자 확인에 사용하는 고유 `External ID`. 자세한 내용은 [AWS 리소스에 대한 액세스 권한을 타사에 부여할 때 외부 ID를 사용하는 방법을 참조하세요](url-iam-user;id_roles_create_for-user_externalid.html).
+ 애플리케이션이 액세스해야 하는 WorkDocs APIs. IAM 기반의 정책 제어는 세심한 제어가 가능하며 개별 API 수준에서 정책의 허용 또는 거부를 정의할 수 있습니다. WorkDocs APIs 목록은 [WorkDocs API 참조](https://docs.aws.amazon.com/workdocs/latest/APIReference/)를 참조하세요.

다음은 교차 계정 액세스를 위한 IAM 구성에 수반되는 단계를 설명하는 절차입니다.

**크로스 계정 액세스를 위해 IAM을 구성하려면**

1. WorkDocs API 권한 정책을 생성하고 이를 `WorkDocsAPIReadOnly` 정책이라고 합니다.

1. WorkDocs 사이트를 호스팅하는 AWS 계정의 IAM 콘솔에서 새 역할을 생성합니다.

   1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) IAM 콘솔을 엽니다.

   1. 콘솔의 탐색 창에서 **역할**을 클릭한 다음 **새 역할 생성**을 클릭합니다.

   1. **Role name(역할 이름)**에 이 역할의 목적을 확인할 수 있는 역할 이름을 입력합니다(예: `workdocs_app_role`). 역할 이름은 AWS 계정 내에서 고유해야 합니다. 이름을 입력한 후 **다음 단계**를 클릭합니다.

   1. **역할 유형 선택** 페이지에서 **Role for Cross-Account Access(교차 계정 액세스의 역할)**를 선택한 다음 만들 역할의 유형을 선택합니다.
      + 사용자 ** AWS 계정과 리소스 계정 모두의 관리자이거나 두 계정이 동일한 회사에 속하는 경우 소유한 계정 간에 액세스 권한 제공을** 선택합니다. 사용자, 역할 및 액세스할 리소스가 모두 같은 계정에 있을 때도 이 옵션을 선택합니다.
      + WorkDocs 사이트를 소유**한 AWS 계정의 관리자이고 애플리케이션 개발자 AWS 계정의 사용자에게 권한을 부여하려는 경우 계정과 타사 계정 간에 액세스 권한 제공을** 선택합니다. 이 옵션을 선택하면 외부 ID(타사가 제공해야 함)를 지정하여 타사가 리소스에 액세스하기 위해 해당 역할을 사용할 수 있는 상황을 추가로 제어해야 합니다. 자세한 내용은 [AWS 리소스에 대한 액세스를 타사에 부여할 때 외부 ID를 사용하는 방법](url-iam-user;id_roles_create_for-user_externalid.html)을 참조하십시오.

   1. 다음 페이지에서 리소스에 대한 액세스 권한을 부여할 AWS 계정 ID를 지정하고 타사 액세스의 경우 **외부 ID**도 입력합니다.

   1. **다음 단계**를 클릭하여 정책을 연결합니다.

1. **정책 연결** 페이지에서 이전에 생성된 WorkDocs API 권한 정책을 검색하고 정책 옆의 상자를 선택하고 **다음 단계를** 클릭합니다.

1. 세부 정보를 검토하고 향후 참조를 위해 역할 ARN을 복사한 후 **Create Role(역할 만들기)**를 클릭하여 역할 생성을 완료합니다.

1. 역할 ARN을 개발자와 공유합니다. 다음은 역할 ARN의 예입니다.

   ```
   arn:aws:iam::AWS-ACCOUNT-ID:role/workdocs_app_role
   ```