**請注意**：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 的存取權之前，您需要了解哪些 IAM 功能可與 WorkDocs 搭配使用。若要全面了解 WorkDocs 和其他 AWS 服務如何與 IAM 搭配使用，請參閱《[AWS IAM 使用者指南》中的與 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 不支援服務角色。