本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Image Builder 如何與 IAM 政策和角色搭配使用
在您使用 IAM 管理 Image Builder 的存取權之前，請先了解哪些 IAM 功能可與 Image Builder 搭配使用。
若要全面了解 Image Builder 和其他 AWS 服務如何與大多數 IAM 功能搭配使用，請參閱《IAM *使用者指南*》中的[AWS 與 IAM 搭配使用的 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。
## Image Builder 的身分型政策
**支援身分型政策：**是
身分型政策是可以附加到身分 (例如 IAM 使用者、使用者群組或角色) 的 JSON 許可政策文件。這些政策可控制身分在何種條件下能對哪些資源執行哪些動作。如需了解如何建立身分型政策，請參閱《*IAM 使用者指南*》中的[透過客戶管理政策定義自訂 IAM 許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。
使用 IAM 身分型政策，您可以指定允許或拒絕的動作和資源，以及在何種條件下允許或拒絕動作。如要了解您在 JSON 政策中使用的所有元素，請參閱《*IAM 使用者指南*》中的 [IAM JSON 政策元素參考](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)。
### Image Builder 的身分型政策範例
若要檢視 Image Builder 身分型政策的範例，請參閱 [映像建置器身分型政策](#security_iam_id-based-policy-examples)。
## Image Builder 中的資源型政策
**支援資源型政策：**是
資源型政策是附加到資源的 JSON 政策文件。資源型政策的最常見範例是 IAM *角色信任政策*和 Amazon S3 *儲存貯體政策*。在支援資源型政策的服務中，服務管理員可以使用它們來控制對特定資源的存取權限。對於附加政策的資源，政策會定義指定的主體可以對該資源執行的動作以及在何種條件下執行的動作。您必須在資源型政策中[指定主體](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)。委託人可以包含帳戶、使用者、角色、聯合身分使用者或 AWS 服務。
如需啟用跨帳戶存取權，您可以在其他帳戶內指定所有帳戶或 IAM 實體作為資源型政策的主體。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的快帳戶資源存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。
## Image Builder 的政策動作
**支援政策動作：**是
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。
JSON 政策的 `Action` 元素描述您可以用來允許或拒絕政策中存取的動作。政策會使用動作來授予執行相關聯動作的許可。
若要查看映像建置器動作的清單，請參閱*《服務授權參考*》中的 [ EC2 Image Builder 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-actions-as-permissions)。
Image Builder 中的政策動作在動作之前使用下列字首：
```
imagebuilder
```
若要在單一陳述式中指定多個動作，請用逗號分隔。
```
"Action": [
"imagebuilder:action1",
"imagebuilder:action2"
]
```
若要檢視 Image Builder 身分型政策的範例，請參閱 [映像建置器身分型政策](#security_iam_id-based-policy-examples)。
## Image Builder 的政策資源
**支援政策資源：**是
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。
`Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。若動作不支援資源層級許可，使用萬用字元 (\$1) 表示該陳述式適用於所有資源。
```
"Resource": "*"
```
若要查看映像建置器資源類型及其 ARNs，請參閱*《服務授權參考*》中的 [ EC2 Image Builder 定義的資源](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-resources-for-iam-policies)。若要了解您可以使用哪些動作指定每個資源的 ARN，請參閱 [ EC2 Image Builder 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-actions-as-permissions)。
若要檢視 Image Builder 身分型政策的範例，請參閱 [映像建置器身分型政策](#security_iam_id-based-policy-examples)。
## Image Builder 的政策條件索引鍵
**支援服務特定政策條件金鑰：**是
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。
`Condition` 元素會根據定義的條件，指定陳述式的執行時機。您可以建立使用[條件運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)的條件運算式 (例如等於或小於)，來比對政策中的條件和請求中的值。若要查看所有 AWS 全域條件索引鍵，請參閱《*IAM 使用者指南*》中的[AWS 全域條件內容索引鍵](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。
若要查看映像建置器條件索引鍵的清單，請參閱*《服務授權參考*》中的 [ EC2 Image Builder 的條件索引鍵](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-policy-keys)。若要了解您可以使用條件金鑰的動作和資源，請參閱 [ EC2 Image Builder 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonec2imagebuilder.html#amazonec2imagebuilder-actions-as-permissions)。
若要檢視 Image Builder 身分型政策的範例，請參閱 [映像建置器身分型政策](#security_iam_id-based-policy-examples)。
## 映像建置器中的 ACLs
**支援 ACL：**否
存取控制清單 (ACL) 可控制哪些主體 (帳戶成員、使用者或角色) 擁有存取某資源的許可。ACL 類似於資源型政策，但它們不使用 JSON 政策文件格式。
## ABAC 搭配映像建置器
**支援 ABAC (政策中的標籤)：**部分
屬性型存取控制 (ABAC) 是一種授權策略，根據稱為標籤的屬性定義許可權。您可以將標籤連接至 IAM 實體 AWS 和資源，然後設計 ABAC 政策，以便在主體的標籤符合資源上的標籤時允許操作。
如需根據標籤控制存取，請使用 `aws:ResourceTag/key-name`、`aws:RequestTag/key-name` 或 `aws:TagKeys` 條件索引鍵，在政策的[條件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中，提供標籤資訊。
如果服務支援每個資源類型的全部三個條件金鑰，則對該服務而言，值為 **Yes**。如果服務僅支援某些資源類型的全部三個條件金鑰，則值為 **Partial**。
如需 ABAC 的詳細資訊，請參閱《*IAM 使用者指南*》中的[使用 ABAC 授權定義許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)。如要查看含有設定 ABAC 步驟的教學課程，請參閱《*IAM 使用者指南*》中的[使用屬性型存取控制 (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)。
## 搭配 Image Builder 使用臨時登入資料
**支援臨時憑證：**是
臨時登入資料提供 AWS 資源的短期存取權，當您使用聯合或切換角色時，會自動建立。 AWS 建議您動態產生臨時登入資料，而不是使用長期存取金鑰。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的臨時安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)與[可與 IAM 搭配運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。
## Image Builder 的跨服務主體許可
**支援轉寄存取工作階段 (FAS)：**是
轉送存取工作階段 (FAS) 使用呼叫 的委託人許可 AWS 服務，並結合 AWS 服務 請求向下游服務提出請求。如需提出 FAS 請求時的政策詳細資訊，請參閱[轉發存取工作階段](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)。
## Image Builder 的服務角色
**支援服務角色：**是
服務角色是服務擔任的 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)，可代您執行動作。IAM 管理員可以從 IAM 內建立、修改和刪除服務角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[建立角色以委派許可給 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。
**警告**
變更服務角色的許可可能會中斷 Image Builder 功能。只有在 Image Builder 提供指引時，才能編輯服務角色。
## Image Builder 的服務連結角色
**支援服務連結角色：**是
服務連結角色是連結至 的一種服務角色 AWS 服務。服務可以擔任代表您執行動作的角色。服務連結角色會出現在您的 中 AWS 帳戶 ，並由服務擁有。IAM 管理員可以檢視，但不能編輯服務連結角色的許可。
如需 Image Builder 服務連結角色的詳細資訊，請參閱 [使用映像建置器的 IAM 服務連結角色](image-builder-service-linked-role.md)。
## 映像建置器身分型政策
透過 IAM 身分型政策，您可以指定允許或拒絕的動作和資源，還有在何種條件下允許或拒絕動作。Image Builder 支援特定動作、資源和條件索引鍵。如需有關您在 JSON 政策中使用的所有元素的資訊，請參閱《*IAM 使用者指南*》中的 [Amazon EC2 Image Builder 的動作、資源和條件金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonec2imagebuilder.html)。
### 動作
Image Builder 中的政策動作在動作之前使用下列字首：`imagebuilder:`。政策陳述式必須包含 `Action` 或 `NotAction` 元素。Image Builder 會定義自己的一組動作，描述您可以使用此服務執行的任務。
若要在單一陳述式中指定多個動作，請用逗號分隔，如下所示：
```
"Action": [
"imagebuilder:action1",
"imagebuilder:action2"
]
```
您也可以使用萬用字元 (\$1) 來指定多個動作。例如，若要指定開頭是 `List` 文字的所有動作，請包含以下動作：
```
"Action": "imagebuilder:List*"
```
若要查看映像建置器動作的清單，請參閱《*IAM 使用者指南*》中的[適用於 的動作、資源和條件金鑰 AWS 服務](https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html)。
### 使用政策管理存取權
如需如何 AWS 透過建立政策並將其連接至 IAM 身分或 AWS 資源來管理 中存取的詳細資訊，請參閱《*IAM 使用者指南*[》中的政策和許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
與執行個體描述檔建立關聯的 IAM 角色必須具有許可，才能執行映像中包含的建置和測試元件。下列 IAM 角色政策必須連接到與執行個體描述檔相關聯的 IAM 角色：
+ EC2InstanceProfileForImageBuilder
+ EC2InstanceProfileForImageBuilderECRContainerBuilds
+ AmazonSSMManagedInstanceCore
### Resources
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。
`Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。若動作不支援資源層級許可，使用萬用字元 (\$1) 表示該陳述式適用於所有資源。
```
"Resource": "*"
```
ARN 由多個節點組成，可協助識別資源並確保名稱是唯一的。名稱中的最後一個節點在資源類型、名稱和 ID 的格式中包含數種變化。Image Builder 建立資源時，會使用下列格式：
`arn:aws:imagebuilder:region:owner:resource-type/resource-name/version/build-version`
**注意**
建置版本不一定會包含在資源 ARN 中。不過，某些 API 操作，例如 [GetComponent](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_GetComponent.html)，需要建置版本才能唯一識別要擷取的資源。
對於 Image Builder 在其配方中使用的資源，例如基礎映像或元件，擁有者節點可以是下列其中一項：
+ 資源擁有者的帳號
+ 對於 Amazon 受管資源： `aws`
+ 針對 AWS Marketplace 資源： `aws-marketplace`
下列範例顯示受管元件在 Linux 上安裝 Amazon CloudWatch 代理程式的 ARN：
```
arn:aws:imagebuilder:us-east-1:aws:component/amazon-cloudwatch-agent-linux/1.0.1/1
```
此範例顯示 中虛構受管元件的 ARN AWS Marketplace：
```
arn:aws:imagebuilder:us-east-1:aws-marketplace:component/example-linux-software-component/1.0.1
```
如需取得元件清單的詳細資訊，包括使用 擁有權篩選條件，請參閱 [列出映像建置器元件](component-details.md#list-components)。
**ARN 範例**
以下是您可以在 IAM 政策中指定的資源 ARNs 的一些範例：
+ 執行個體 ARN
```
"Resource": "arn:aws:imagebuilder:us-east-1:111122223333:instance/i-1234567890abcdef0"
```
+ 萬用字元 (\$1) 範例，用於指定指定帳戶的所有執行個體
```
"Resource": "arn:aws:imagebuilder:us-east-1:111122223333:instance/*"
```
+ 萬用字元 (\$1) 範例，用於指定受管映像工作流程的所有版本
```
"Resource": "arn:aws:imagebuilder:us-east-1:aws:workflow/build/build-image/*"
```
+ 受管映像 ARN
```
"Resource": "arn:aws:imagebuilder:us-east-1:aws:image/amazon-linux-2-arm64/2024.12.17/1"
```
+ 萬用字元 (\$1) 範例，用於指定受管映像的所有版本
```
"Resource": "arn:aws:imagebuilder:us-east-1:aws:image/amazon-linux-2-arm64/x.x.x"
```
許多 EC2 Image Builder API 動作涉及多個資源。若要在單一陳述式中指定多項資源，請使用逗號分隔 ARN。
```
"Resource": [
"resource1",
"resource2"
]
```
### 條件索引鍵
Image Builder 提供服務特定的條件金鑰，並支援使用一些全域條件金鑰。若要查看所有 AWS 全域條件金鑰，請參閱《*IAM 使用者指南*》中的[AWS 全域條件內容金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。提供下列服務特定的條件金鑰。
#### imagebuilder：CreatedResourceTagKeys
使用[字串運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String)。
使用此金鑰，依請求中是否存在標籤金鑰來篩選存取權。這可讓您管理 Image Builder 建立的資源。
**可用性** – 此金鑰僅適用於 `CreateInfrastrucutreConfiguration`和 `UpdateInfrastructureConfiguration` APIs。
#### imagebuilder：CreatedResourceTag/
使用[字串運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String)。
使用此金鑰，依連接至 Image Builder 建立之資源的標籤鍵值對篩選存取權。這可讓您透過定義的標籤來管理 Image Builder 資源。
**可用性** – 此金鑰僅適用於 `CreateInfrastrucutreConfiguration`和 `UpdateInfrastructureConfiguration` APIs。
#### imagebuilder：LifecyclePolicyResourceType
使用[字串運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String)。
使用此金鑰，依請求中指定的生命週期資源類型篩選存取權。
此金鑰的值可以是 `AMI_IMAGE`或 `CONTAINER_IMAGE`。
**可用性** – 此金鑰僅適用於 `CreateLifecyclePolicy`和 `UpdateLifecyclePolicy` APIs。
#### imagebuilder：Ec2MetadataHttpTokens
使用[字串運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String)。
使用此金鑰，依請求中指定的 EC2 執行個體中繼資料 HTTP 字符需求篩選存取權。
此金鑰的這個值可以是 `optional`或 `required`。
**可用性** – 此金鑰僅適用於 `CreateInfrastrucutreConfiguration`和 `UpdateInfrastructureConfiguration` APIs。
#### imagebuilder：StatusTopicArn
使用[字串運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String)。
使用此金鑰，在將發佈終端狀態通知的請求中，依 SNS 主題 ARN 篩選存取權。
**可用性** – 此金鑰僅適用於 `CreateInfrastrucutreConfiguration`和 `UpdateInfrastructureConfiguration` APIs。
### 範例
若要檢視 Image Builder 身分型政策的範例，請參閱 [映像建置器身分型政策](security-iam-identity-based-policies.md)。
## Image Builder 資源型政策
以資源為基礎的政策會指定指定主體可以在 Image Builder 資源上執行的動作，以及在哪些條件下執行的動作。Image Builder 支援元件、映像和映像配方的資源型許可政策。資源型政策可讓您依資源將使用許可授予至其他帳戶。您也可以使用資源型政策，允許 AWS 服務存取您的元件、映像和映像配方。
如需如何將資源型政策連接至元件、映像或映像配方的詳細資訊，請參閱 [與 共用映像建置器資源 AWS RAM](manage-shared-resources.md)。
**注意**
當您使用 Image Builder 更新資源政策時，更新會顯示在 RAM 主控台中。
## 以映像建置器標籤為基礎的授權
您可以將標籤連接至映像建置器資源，或在請求中將標籤傳遞至映像建置器。如需根據標籤控制存取，請使用 `imagebuilder:ResourceTag/key-name`、`aws:RequestTag/key-name` 或 `aws:TagKeys` 條件索引鍵，在政策的[條件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中，提供標籤資訊。如需標記映像建置器資源的詳細資訊，請參閱[從 標記資源 AWS CLI](tag-resources.md#cli-tag-resource)。
## 映像建置器 IAM 角色
[IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)是 內具有特定許可 AWS 帳戶 的實體。
### 搭配 Image Builder 使用臨時登入資料
您可以搭配聯合使用暫時憑證、擔任 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 操作來取得臨時安全登入資料。
### 服務連結角色
[服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)允許 AWS 服務 存取其他服務中的資源，以代表您完成 動作。服務連結角色會顯示在您的 IAM 帳戶中，並由該服務所擁有。具有管理存取權的使用者可以檢視，但不能編輯服務連結角色的許可。
Image Builder 支援服務連結角色。如需建立或管理 Image Builder 服務連結角色的資訊，請參閱 [使用映像建置器的 IAM 服務連結角色](image-builder-service-linked-role.md)。
### 服務角色
此功能可讓服務代表您擔任[服務角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)。此角色可讓服務存取其他服務中的資源，以代表您完成動作。服務角色會出現在您的 IAM 帳戶中，且由該帳戶所擁有。這表示具有管理存取權的使用者可以變更此角色的許可。不過，這樣可能會破壞此服務的功能。