WorkDocs APIs - Amazon WorkDocs

注意: 新しい顧客のサインアップとアカウントのアップグレードは、Amazon WorkDocs では利用できなくなりました。移行手順については、WorkDocs からデータを移行する方法」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

WorkDocs APIs

サードパーティー開発者、または別の AWS アカウントを使用しているユーザーにアクセス権を付与できます。これを行うには、IAM ロールを作成し、WorkDocs API 許可ポリシーをアタッチします。

このアクセスのフォームは、以下のシナリオで必要です。

  • 開発者は同じ組織に属していますが、開発者の AWS アカウントは WorkDocs AWS アカウントとは異なります。

  • 企業がサードパーティーのアプリケーション開発者に WorkDocs API アクセスを許可する場合。

どちらのシナリオでも、開発者の AWS AWS アカウントと WorkDocs サイトをホストする別のアカウントの 2 つのアカウントが関係しています。

開発者は、アカウント管理者が IAM ロールを作成できるように、以下の情報を提供する必要があります。

次の手順は、クロスアカウントアクセスのための IAM の設定に含まれるステップについて説明しています。

クロスアカウントアクセスに対して IAM を設定するには

  1. WorkDocs API アクセス許可ポリシーを作成し、WorkDocsAPIReadOnlyポリシーを呼び出します。

  2. WorkDocs サイトをホストする AWS アカウントの IAM コンソールで新しいロールを作成します。

    1. にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/iam/ で IAM コンソールを開きます。

    2. コンソールのナビゲーションペインで [Roles] (ロール) をクリックし、[Create New Role] (新しいロールの作成) をクリックします。

    3. [Role name] (ロール名) ボックスにそのロールの目的を見分けやすくするロール名を入力します。例えば、workdocs_app_role です。ロール名は AWS アカウント内で一意である必要があります。ロール名を入力したら、[Next step] (次のステップ) をクリックします。

    4. [Select Role Type] (ロールタイプの選択) ページで、[Role for Cross-Account Access] (クロスアカウントアクセスのロール) セクションを選択し、作成するロールのタイプを選択します。

      • ユーザーアカウントとリソース AWS アカウントの両方の管理者である場合、または両方のアカウントが同じ会社に属している場合は、所有するアカウント間のアクセスを提供するを選択します。このオプションは、ユーザー、ロール、アクセスされるリソースがすべて同じアカウントに属している場合にも選択します。

      • WorkDocs サイトを所有するアカウントの管理者であり、アプリケーションデベロッパー AWS アカウントからユーザーに許可を付与する場合は、 AWS アカウントとサードパーティーアカウント間のアクセスを提供するを選択します。このオプションでは、お客様は、第三者によって提供される外部 ID を指定して、第三者がロールを使用してお客様のリソースにアクセスできる環境に対して、管理性を強化する必要があります。詳細については、「How to Use an External ID When Granting Access to Your AWS Resources to a Third Party」(AWS リソースへのアクセス権を第三者に付与するときに外部 ID を使用する方法) をご参照ください。

    5. 次のページで、リソースへのアクセスを許可する AWS アカウント ID を指定し、サードパーティーのアクセスの場合は外部 ID を入力します。

    6. [Next Step] (次のステップ) をクリックして、ポリシーをアタッチします。

  3. ポリシーのアタッチページで、前に作成した WorkDocs API アクセス許可ポリシーを検索し、ポリシーの横にあるボックスを選択し、次のステップをクリックします。

  4. 詳細を確認し、今後の参照用にロール ARN をコピーして、[Create Role] (ロールの作成) をクリックしてロールの作成を完了します。

  5. ロール ARN を開発者と共有します。ロール ARN の例を以下に示します。

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