

**注意**: 新しい顧客のサインアップとアカウントのアップグレードは、Amazon WorkDocs では利用できなくなりました。移行手順については、[WorkDocs からデータを移行する方法](https://aws.amazon.com/blogs/business-productivity/how-to-migrate-content-from-amazon-workdocs)」を参照してください。

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

# Amazon WorkDocs ID ベースのポリシーの例
<a name="security_iam_id-based-policy-examples"></a>

**注記**  
セキュリティを強化するために、可能な限り IAM ユーザーではなくフェデレーティッドユーザーを作成してください。

デフォルトでは、IAM ユーザーとロールには WorkDocs リソースを作成または変更するアクセス許可はありません。また、 AWS マネジメントコンソール、 AWS CLI、または AWS API を使用してタスクを実行することはできません。IAM 管理者は、ユーザーとロールに必要な、指定されたリソースで特定の API オペレーションを実行する権限をユーザーとロールに付与する IAM ポリシーを作成する必要があります。続いて、管理者はそれらの権限が必要な IAM ユーザーまたはグループにそのポリシーをアタッチする必要があります。

**注記**  
下位互換性を確保するため、ポリシーに `zocalo` アクションを含めます。例えば:  

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Deny",
            "Action": [
            "zocalo:*",
            "workdocs:*"
            ],
            "Resource": "*"
        }
    ]
}
```

これらの JSON ポリシードキュメント例を使用して IAM の ID ベースのポリシーを作成する方法については、*「IAM User Guide」*(IAM ユーザーガイド) の[「Creating policies on the JSON tab」](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)(JSON タブでのポリシーの作成) をご参照ください。

**Topics**
+ [ポリシーに関するベストプラクティス](#security_iam_service-with-iam-policy-best-practices)
+ [WorkDocs コンソールの使用](#security_iam_id-based-policy-examples-console)
+ [ユーザーが自分の許可を表示できるようにする](#security_iam_id-based-policy-examples-view-own-permissions)
+ [WorkDocs リソースへの読み取り専用アクセスをユーザーに許可する](#security_iam_id-based-policy-examples-read-only-access)
+ [その他の WorkDocs アイデンティティベースのポリシーの例](#security_iam_id-based-policy-examples-more)

## ポリシーに関するベストプラクティス
<a name="security_iam_service-with-iam-policy-best-practices"></a>

ID ベースのポリシーは、ユーザーのアカウントで誰かが WorkDocs リソースを作成、アクセス、または削除できるかどうかを決定します。これらのアクションを実行すると、 AWS アカウントに料金が発生する可能性があります。アイデンティティベースポリシーを作成したり編集したりする際には、以下のガイドラインと推奨事項に従ってください:
+ ** AWS 管理ポリシーを開始し、最小特権のアクセス許可に移行する** – ユーザーとワークロードにアクセス許可の付与を開始するには、多くの一般的なユースケースにアクセス許可を付与する*AWS 管理ポリシー*を使用します。これらは で使用できます AWS アカウント。ユースケースに固有の AWS カスタマー管理ポリシーを定義することで、アクセス許可をさらに減らすことをお勧めします。詳細については、「*IAM ユーザーガイド*」の「[AWS マネージドポリシー](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)」または「[ジョブ機能のAWS マネージドポリシー](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)」を参照してください。
+ **最小特権を適用する** – IAM ポリシーで許可を設定する場合は、タスクの実行に必要な許可のみを付与します。これを行うには、特定の条件下で特定のリソースに対して実行できるアクションを定義します。これは、最小特権アクセス許可とも呼ばれています。IAM を使用して許可を適用する方法の詳細については、「*IAM ユーザーガイド*」の「[IAM でのポリシーとアクセス許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)」を参照してください。
+ **IAM ポリシーで条件を使用してアクセスをさらに制限する** - ポリシーに条件を追加して、アクションやリソースへのアクセスを制限できます。例えば、ポリシー条件を記述して、すべてのリクエストを SSL を使用して送信するように指定できます。条件を使用して、サービスアクションが などの特定の を通じて使用されている場合に AWS のサービス、サービスアクションへのアクセスを許可することもできます CloudFormation。詳細については、「*IAM ユーザーガイド*」の「[IAM JSON ポリシー要素:条件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)」を参照してください。
+ **IAM Access Analyzer を使用して IAM ポリシーを検証し、安全で機能的な権限を確保する** - IAM Access Analyzer は、新規および既存のポリシーを検証して、ポリシーが IAM ポリシー言語 (JSON) および IAM のベストプラクティスに準拠するようにします。IAM アクセスアナライザーは 100 を超えるポリシーチェックと実用的な推奨事項を提供し、安全で機能的なポリシーの作成をサポートします。詳細については、「*IAM ユーザーガイド*」の「[IAM Access Analyzer でポリシーを検証する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)」を参照してください。
+ **多要素認証 (MFA) を要求する** – で IAM ユーザーまたはルートユーザーを必要とするシナリオがある場合は AWS アカウント、MFA をオンにしてセキュリティを強化します。API オペレーションが呼び出されるときに MFA を必須にするには、ポリシーに MFA 条件を追加します。詳細については、「*IAM ユーザーガイド*」の「[MFA を使用した安全な API アクセス](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)」を参照してください。

IAM でのベストプラクティスの詳細については、「*IAM ユーザーガイド*」の「[IAM でのセキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)」を参照してください。

## WorkDocs コンソールの使用
<a name="security_iam_id-based-policy-examples-console"></a>

Amazon WorkDocs コンソールにアクセスするには、最小限の権限のセットが必要です。これらのアクセス許可により、 AWS アカウントの WorkDocs リソースの詳細を一覧表示および表示できます。最小限必要な権限よりも制限の厳しい ID ベースのポリシーを作成すると、コンソールは IAM ユーザーまたはロールエンティティに対して意図されたとおりに機能しなくなります。

これらのエンティティが WorkDocs コンソールを使用できるようにするには、次の AWS 管理ポリシーもエンティティにアタッチします。IAM ポリシーをアタッチすることの詳細は、*「IAM User Guide」*(IAM ユーザーガイド) の[「Adding permissions to a user」](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)(IAM ユーザーのアクセス許可の追加) を参照してください。
+ **AmazonWorkDocsFullAccess**
+ **AWSDirectoryServiceFullAccess**
+ **AmazonEC2FullAccess**

これらのポリシーは、WorkDocs リソース、 AWS Directory Service オペレーション、および Amazon WorkDocs が正しく動作するために必要な Amazon EC2 オペレーションへのフルアクセスをユーザーに付与します。 Amazon WorkDocs 

 AWS CLI または AWS API のみを呼び出すユーザーには、最小限のコンソールアクセス許可を付与する必要はありません。代わりに、実行しようとしている API オペレーションに一致するアクションのみへのアクセスが許可されます。

## ユーザーが自分の許可を表示できるようにする
<a name="security_iam_id-based-policy-examples-view-own-permissions"></a>

この例では、ユーザーアイデンティティにアタッチされたインラインおよびマネージドポリシーの表示を IAM ユーザーに許可するポリシーの作成方法を示します。このポリシーには、コンソールで、または AWS CLI または AWS API を使用してプログラムでこのアクションを実行するアクセス許可が含まれています。

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}
```

## WorkDocs リソースへの読み取り専用アクセスをユーザーに許可する
<a name="security_iam_id-based-policy-examples-read-only-access"></a>

次の AWS マネージド **AmazonWorkDocsReadOnlyAccess** ポリシーは、IAM ユーザーに WorkDocs リソースへの読み取り専用アクセスを許可します。このポリシーは、すべての WorkDocs `Describe`オペレーションへのアクセス権をユーザーに付与します。WorkDocs が VPCsとサブネットのリストを取得できるように、2 つの Amazon EC2 オペレーションにアクセスする必要があります。 Directory Service ディレクトリに関する情報を取得するには、 Directory Service `DescribeDirectories`オペレーションへのアクセスが必要です。

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "workdocs:Describe*",
                "ds:DescribeDirectories",
                "ec2:DescribeVpcs",
                "ec2:DescribeSubnets"
            ],
            "Resource": "*"
        }
    ]
}
```

## その他の WorkDocs アイデンティティベースのポリシーの例
<a name="security_iam_id-based-policy-examples-more"></a>

IAM 管理者は、IAM ロールまたはユーザーに WorkDocs API へのアクセスを許可する追加のポリシーを作成できます。詳細については、*WorkDocs デベロッパーガイド*」の[「管理アプリケーションの認証とアクセスコントロール](https://docs.aws.amazon.com/workdocs/latest/developerguide/creating-wd-iam.html)」を参照してください。