本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 映像建置器的 Identity and Access Management 整合 **Topics** + [目標對象](#security-iam-audience) + [使用身分驗證](#security-iam-authentication) + [Image Builder 如何與 IAM 政策和角色搭配使用](security_iam_service-with-iam.md) + [在 Image Builder 中管理 S3 儲存貯體下載存取權的資料周邊](security-iam-data-perimeter.md) + [映像建置器身分型政策](security-iam-identity-based-policies.md) + [自訂工作流程的 IAM 許可](#security-iam-custom-workflows) + [Image Builder 資源型政策](#security-iam-resource-based-policies) + [使用 EC2 Image Builder 的 AWS 受管政策](security-iam-awsmanpol.md) + [使用映像建置器的 IAM 服務連結角色](image-builder-service-linked-role.md) + [對 Image Builder 中的 IAM 問題進行故障診斷](security_iam_troubleshoot.md) ## 目標對象 使用方式 AWS Identity and Access Management (IAM) 會根據您的角色而有所不同： + **服務使用者** — 若無法存取某些功能，請向管理員申請所需許可 (請參閱 [對 Image Builder 中的 IAM 問題進行故障診斷](security_iam_troubleshoot.md)) + **服務管理員** — 負責設定使用者存取權並提交相關許可請求 (請參閱 [Image Builder 如何與 IAM 政策和角色搭配使用](security_iam_service-with-iam.md)) + **IAM 管理員** — 撰寫政策以管理存取控制 (請參閱 [映像建置器身分型政策](security_iam_service-with-iam.md#security_iam_id-based-policy-examples)) ## 使用身分驗證 如需如何為 中的人員和程序提供身分驗證的詳細資訊 AWS 帳戶，請參閱《*IAM 使用者指南*》中的[身分](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)。 # 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 帳戶中，且由該帳戶所擁有。這表示具有管理存取權的使用者可以變更此角色的許可。不過，這樣可能會破壞此服務的功能。 # 在 Image Builder 中管理 S3 儲存貯體下載存取權的資料周邊 EC2 Image Builder 維護兩個 AWS 服務擁有的 S3 儲存貯體類別，其中包含在您帳戶中執行 Image Builder 工作負載所需的可下載資源。如果您使用資料周邊來控制對您環境中 Amazon S3 的存取，您可能需要明確允許存取這些儲存貯體。您可以使用儲存貯體 ARN 或儲存貯體 URL 來允許列出這些儲存貯體，具體取決於您如何控制對 Amazon S3 的存取。 **元件管理引導指令碼 （必要）** 此 S3 儲存貯體包含引導指令碼，可在用於建立映像的 EC2 執行個體上設定 AWS TOE 應用程式。Image Builder 需要下載指令碼的存取權，才能支援新映像的建置和測試。 + **S3 儲存貯體 ARN：** `arn::s3:::ec2imagebuilder-managed-resources--prod` + **S3 儲存貯體 URL：** `https://ec2imagebuilder-managed-resources-.s3..` **受管元件** 此 S3 儲存貯體包含 Amazon 受管元件的套件承載。Image Builder 需要存取，才能下載配方中設定的任何受管元件。 + **S3 儲存貯體 ARN：** `arn::s3:::ec2imagebuilder-toe--prod` + **S3 儲存貯體 URL：** `https://ec2imagebuilder-toe-.s3..` # 映像建置器身分型政策 **Topics** + [身分型政策最佳實務](#security-iam-service-policy-best-practices) + [使用映像建置器主控台](#sec-iam-id-based-policies-using-console) ## 身分型政策最佳實務 身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除映像建置器資源。這些動作可能會讓您的 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 Access Analyzer 提供 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)。 ## 使用映像建置器主控台 若要存取 EC2 Image Builder 主控台，您必須擁有一組最低許可。這些許可可讓您列出和檢視 中映像建置器資源的詳細資訊 AWS 帳戶。如果您建立比最基本必要許可更嚴格的身分型政策，則對於具有該政策的實體 (IAM 使用者或角色) 而言，主控台就無法如預期運作。 為了確保您的 IAM 實體可以使用 Image Builder 主控台，您必須將下列其中一個 AWS 受管政策連接到它們： + [AWSImageBuilderReadOnlyAccess 政策](security-iam-awsmanpol.md#sec-iam-manpol-AWSImageBuilderReadOnlyAccess) + [AWSImageBuilderFullAccess 政策](security-iam-awsmanpol.md#sec-iam-manpol-AWSImageBuilderFullAccess) 如需 Image Builder 受管政策的詳細資訊，請參閱 [使用 EC2 Image Builder 的 AWS 受管政策](security-iam-awsmanpol.md)。 **重要** 建立 Image Builder 服務連結角色需要此**AWSImageBuilderFullAccess**政策。當您將此政策連接到 IAM 實體時，您還必須連接下列自訂政策，並包含您要使用的資源，而這些資源名稱`imagebuilder`中沒有 ： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sns:Publish" ], "Resource": "arn:aws:sns:*:*:*imagebuilder*" }, { "Effect": "Allow", "Action": [ "iam:GetInstanceProfile" ], "Resource": "arn:aws:iam::*:instance-profile/*imagebuilder*" }, { "Effect": "Allow", "Action": "iam:PassRole", "Resource": [ "arn:aws:iam::*:instance-profile/*imagebuilder*", "arn:aws:iam::*:role/*imagebuilder*" ], "Condition": { "StringEquals": { "iam:PassedToService": "ec2.amazonaws.com" } } }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3::*:*imagebuilder*" } ] } ``` ------ 對於僅呼叫 AWS CLI 或 AWS API 的使用者，您不需要允許最低主控台許可。反之，只需允許存取符合您嘗試執行之 API 作業的動作就可以了。 ## 自訂工作流程的 IAM 許可 搭配 等特定步驟動作使用自訂工作流程時[RegisterImage](wfdoc-step-actions.md#wfdoc-step-action-register-image)，除了標準 Image Builder 受管政策之外，可能需要額外的 IAM 許可。本節說明自訂工作流程步驟動作所需的額外許可。 ### RegisterImage 步驟動作許可 `RegisterImage` 步驟動作需要特定的 Amazon EC2 許可，才能註冊 AMIs並選擇性地擷取快照標籤。使用 `includeSnapshotTags` 參數時，需要額外的許可來描述快照。 **RegisterImage 步驟動作的必要許可：** 對於所有資源，允許下列動作： + `ec2:RegisterImage` + `ec2:DescribeSnapshots` ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:RegisterImage", "ec2:DescribeSnapshots" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ec2:CreateTags" ], "Resource": "arn:aws:ec2:*::image/*", "Condition": { "StringEquals": { "ec2:CreateAction": "RegisterImage" } } } ] } ``` **許可詳細資訊：** + `ec2:RegisterImage` - 從快照註冊新的 AMIs 時需要 + `ec2:DescribeSnapshots` - 使用 `includeSnapshotTags: true`擷取快照標籤以與 AMI 標籤合併時需要 + `ec2:CreateTags` - 將標籤套用至已註冊的 AMI 時需要，包括映像建置器預設標籤和合併快照標籤 **注意** 只有在 `includeSnapshotTags` 參數設定為 時，才會使用 `ec2:DescribeSnapshots`許可`true`。如果您不使用此功能，您可以省略此許可。 **標籤合併行為：** 啟用 `includeSnapshotTags` 時，RegisterImage 步驟動作將： + 從區塊型設備映射中指定的第一個快照擷取標籤 + 排除任何 AWS 預留標籤 （索引鍵開頭為 "aws：" 的標籤） + 將快照標籤與映像建置器的預設 AMI 註冊標籤合併 + 當標籤索引鍵發生衝突時，優先使用 Image Builder 標籤 ## Image Builder 資源型政策 如需如何建立元件的詳細資訊，請參閱 [使用元件來自訂映像建置器映像](manage-components.md)。 ### 限制映像建置器元件對特定 IP 地址的存取 下列範例會將許可授予任何使用者，以在元件上執行任何映像建置器操作。不過，要求必須源自於條件中所指定的 IP 地址範圍。 此陳述式中的條件會識別允許之 Internet Protocol Version 4 (IPv4) IP 地址的 54.240.143.\$1 範圍，但有一個例外：54.240.143.188。 `Condition` 區塊使用 `IpAddress`和 `NotIpAddress`條件和 `aws:SourceIp` 條件金鑰，這是 AWS全局條件金鑰。如需這些條件索引鍵的詳細資訊，請參閱[在政策中指定條件](https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazon-s3-policy-keys.html)。`aws:sourceIp` IPv4 值會使用標準 CIDR 表示法。如需詳細資訊，請參閱《IAM 使用者指南》**中的 [IP 地址條件運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_IPAddress)。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "IBPolicyId1", "Statement": [ { "Sid": "IPAllow", "Effect": "Allow", "Action": "imagebuilder:GetComponent", "Resource": "arn:aws:imagebuilder:*::examplecomponent/*", "Condition": { "IpAddress": {"aws:SourceIp": "54.240.143.0/24"}, "NotIpAddress": {"aws:SourceIp": "54.240.143.188/32"} } } ] } ``` ------ # 使用 EC2 Image Builder 的 AWS 受管政策 AWS 受管政策是由 AWS AWS 受管政策建立和管理的獨立政策旨在為許多常用案例提供許可，以便您可以開始將許可指派給使用者、群組和角色。 請記住， AWS 受管政策可能不會授予特定使用案例的最低權限許可，因為這些許可可供所有 AWS 客戶使用。我們建議您定義特定於使用案例的[客戶管理政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies)，以便進一步減少許可。 您無法變更 AWS 受管政策中定義的許可。如果 AWS 更新受 AWS 管政策中定義的許可，則更新會影響政策連接的所有委託人身分 （使用者、群組和角色）。當新的 AWS 服務 啟動或新的 API 操作可供現有服務使用時， AWS 最有可能更新 AWS 受管政策。 如需詳細資訊，請參閱 *IAM 使用者指南*中的 [AWS 受管政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)。 ## AWSImageBuilderFullAccess 政策 **AWSImageBuilderFullAccess** 政策會針對其連接的角色授予 Image Builder 資源的完整存取權，允許該角色列出、描述、建立、更新和刪除 Image Builder 資源。此政策也會將目標許可授予所需的相關 AWS 服務 ，例如，驗證資源，或在 中顯示帳戶的目前資源 AWS 管理主控台。 ### 許可詳細資訊 此政策包含以下許可： + **映像建置器** – 授予管理存取權，讓角色可以列出、描述、建立、更新和刪除映像建置器資源。 + **Amazon EC2** – 授予 Amazon EC2 存取權 描述驗證資源存在或取得屬於帳戶之資源清單所需的動作。 + **IAM** – 授予存取權，以取得和使用名稱包含「imagebuilder」的執行個體描述檔、透過 `iam:GetRole` API 動作驗證 Image Builder 服務連結角色是否存在，以及建立 Image Builder 服務連結角色。 + **License Manager** – 授予存取權以列出資源的授權組態或授權。 + **Amazon S3** – 授予存取權以列出屬於帳戶的儲存貯體，以及名稱中具有「imagebuilder」的映像建置器儲存貯體。 + **Amazon SNS** – 將寫入許可授予 Amazon SNS，以驗證包含 "imagebuilder" 主題的主題擁有權。 若要檢視此政策的許可，請參閱 *AWS 受管政策參考*中的 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderFullAccess.html)。 ## AWSImageBuilderReadOnlyAccess 政策 此**AWSImageBuilderReadOnlyAccess**政策提供所有 Image Builder 資源的唯讀存取權。授予許可，以透過 `iam:GetRole` API 動作驗證 Image Builder 服務連結角色是否存在。 ### 許可詳細資訊 此政策包含以下許可： + **Image Builder** – 授予對 Image Builder 資源的唯讀存取權。 + **IAM** – 授予存取權，以透過 `iam:GetRole` API 動作驗證 Image Builder 服務連結角色是否存在。 若要檢視此政策的許可，請參閱 *AWS 受管政策參考*中的 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderReadOnlyAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSImageBuilderReadOnlyAccess.html)。 ## AWSServiceRoleForImageBuilder 政策 此**AWSServiceRoleForImageBuilder**政策允許 Image Builder AWS 服務 代表您呼叫 。 ### 許可詳細資訊 透過 Systems Manager 建立角色時，此政策會連接到 Image Builder 服務連結角色。如需 Image Builder 服務連結角色的詳細資訊，請參閱 [使用映像建置器的 IAM 服務連結角色](image-builder-service-linked-role.md)。 政策包含下列許可： + **CloudWatch Logs** – 授予建立 CloudWatch Logs 並將其上傳至名稱開頭為 之任何日誌群組的存取權`/aws/imagebuilder/`。 + **Amazon EC2** – 授予 Image Builder 在您的帳戶中建立、拍攝快照和註冊其建立和啟動 EC2 執行個體之映像 (AMIs) 的存取權。映像建置器會視需要使用相關的快照、磁碟區、網路介面、子網路、安全群組、授權組態和金鑰對，只要建立或使用的映像、執行個體和磁碟區都加上 `CreatedBy: EC2 Image Builder`或 的標籤`CreatedBy: EC2 Fast Launch`。 Image Builder 可以取得 Amazon EC2 映像、執行個體屬性、執行個體狀態、您帳戶可用的執行個體類型、啟動範本、子網路、主機和 Amazon EC2 資源標籤的相關資訊。 Image Builder 可以更新映像設定，以啟用或停用您帳戶中 Windows 執行個體的更快速啟動，其中映像會加上 標籤`CreatedBy: EC2 Image Builder`。 此外，Image Builder 可以啟動、停止和終止在您帳戶中執行的執行個體、共用 Amazon EBS 快照、建立和更新映像和啟動範本、取消註冊現有映像、新增標籤，以及跨您已透過**Ec2ImageBuilderCrossAccountDistributionAccess**政策授予許可給 的帳戶複寫映像。所有這些動作都需要映像建置器標記，如前所述。 + **Amazon ECR** – 若容器映像漏洞掃描需要，會授予 Image Builder 建立儲存庫的存取權，並標記其建立的資源以限制其操作範圍。也會授予 Image Builder 在擷取漏洞快照後刪除其為掃描建立之容器映像的存取權。 + **EventBridge** – 授予 Image Builder 建立和管理 EventBridge 規則的存取權。 + **IAM** – 授予 Image Builder 將帳戶中任何角色傳遞給 Amazon EC2 和 VM Import/Export 的存取權。 + **Amazon Inspector** – 授予 Image Builder 存取權，以判斷 Amazon Inspector 何時完成建置執行個體掃描，並收集設定為允許之映像的調查結果。 + **AWS KMS** – 授予 Amazon EBS 加密、解密或重新加密 Amazon EBS 磁碟區的存取權。這對於確保加密磁碟區在 Image Builder 建置映像時運作至關重要。 + **License Manager** – 授予 Image Builder 透過 更新 License Manager 規格的存取權`license-manager:UpdateLicenseSpecificationsForResource`。 + **Amazon SNS** – 針對您帳戶中的任何 Amazon SNS 主題授予寫入許可。 + **Systems Manager** – 授予 Image Builder 存取權，以列出 Systems Manager 命令及其調用、清查項目 、描述執行個體資訊和自動化執行狀態、描述執行個體置放支援的主機，以及取得命令調用詳細資訊。Image Builder 也可以傳送自動化訊號，並停止您帳戶中任何資源的自動化執行。 Image Builder 能夠對針對`"CreatedBy": "EC2 Image Builder"`下列指令碼檔案加上標籤的任何執行個體發出執行命令叫用：`AWS-RunPowerShellScript`、 `AWS-RunShellScript`或 `AWSEC2-RunSysprep`。Image Builder 能夠在您的帳戶中針對名稱開頭為 的自動化文件啟動 Systems Manager 自動化執行`ImageBuilder`。 Image Builder 也可以建立或刪除您帳戶中任何執行個體的狀態管理員關聯，只要關聯文件為 `AWS-GatherSoftwareInventory`，並在您的帳戶中建立 Systems Manager 服務連結角色。 Image Builder 能夠讀取公有參數存放區參數，以及讀取和更新字首為 的私有參數，`/imagebuilder/`以便使用 Image Builder 從新建置建立的輸出 AMI IDs 來更新參數值。 + **AWS STS** – 授予 Image Builder 存取權，以**EC2ImageBuilderDistributionCrossAccountRole**從您的帳戶擔任名為 的角色，以存取角色上的信任政策允許的任何帳戶。這用於跨帳戶映像分佈。 若要檢視此政策的許可，請參閱 *AWS 受管政策參考*中的 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSServiceRoleForImageBuilder.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSServiceRoleForImageBuilder.html)。 ## Ec2ImageBuilderCrossAccountDistributionAccess 政策 此**Ec2ImageBuilderCrossAccountDistributionAccess**政策會授予許可，讓 Image Builder 將映像分散到目標區域中的帳戶。此外，Image Builder 可以描述、複製標籤，並將標籤套用至帳戶中的任何 Amazon EC2 映像。此政策也授予透過 `ec2:ModifyImageAttribute` API 動作修改 AMI 許可的能力。 ### 許可詳細資訊 此政策包含以下許可： + **Amazon EC2** – Amazon EC2 會授予存取權，以描述、複製和修改映像的屬性，以及為帳戶中的任何 Amazon EC2 映像建立標籤。 若要檢視此政策的許可，請參閱 *AWS 受管政策參考*中的 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/Ec2ImageBuilderCrossAccountDistributionAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/Ec2ImageBuilderCrossAccountDistributionAccess.html)。 ## EC2ImageBuilderLifecycleExecutionPolicy 政策 此**EC2ImageBuilderLifecycleExecutionPolicy**政策授予 Image Builder 執行動作的許可，例如棄用、停用或刪除 Image Builder 映像資源及其基礎資源 (AMIs、快照），以支援映像生命週期管理任務的自動化規則。 ### 許可詳細資訊 此政策包含以下許可： + **Amazon EC2** – 授予 Amazon EC2 存取權，以在標記 的帳戶中對 Amazon Machine Image (AMIs) 執行下列動作`CreatedBy: EC2 Image Builder`。 + 啟用和停用 AMI。 + 啟用和停用映像棄用。 + 描述和取消註冊 AMI。 + 描述和修改 AMI 映像屬性。 + 刪除與 AMI 相關聯的磁碟區快照。 + 擷取資源的標籤。 + 從 AMI 新增或移除標籤以取代。 + **Amazon ECR** – 授予 Amazon ECR 存取權，以在具有 `LifecycleExecutionAccess: EC2 Image Builder`標籤的 ECR 儲存庫上執行下列批次動作。批次動作支援自動化容器映像生命週期規則。 + `ecr:BatchGetImage` + `ecr:BatchDeleteImage` 在標記 的 ECR 儲存庫的儲存庫層級授予存取權`LifecycleExecutionAccess: EC2 Image Builder`。 + **AWS 資源群組** – 授予 Image Builder 根據標籤取得資源的存取權。 + **EC2 Image Builder** – 授予 Image Builder 刪除 Image Builder 映像資源的存取權。 若要檢視此政策的許可，請參閱 *AWS 受管政策參考*中的 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2ImageBuilderLifecycleExecutionPolicy.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2ImageBuilderLifecycleExecutionPolicy.html)。 ## EC2InstanceProfileForImageBuilder 政策 此**EC2InstanceProfileForImageBuilder**政策會授予 EC2 執行個體使用映像建置器所需的最低許可。這不包括使用 Systems Manager Agent 所需的許可。 ### 許可詳細資訊 此政策包含以下許可： + **CloudWatch Logs** – 授予建立 CloudWatch Logs 並將其上傳至名稱開頭為 之任何日誌群組的存取權`/aws/imagebuilder/`。 + **Amazon EC2** – 授予存取權以描述磁碟區和快照、建立映像建置器建立的磁碟區或快照資源快照，以及建立映像建置器資源的標籤。 + **映像建置器** – 授予存取以取得任何映像建置器或 AWS Marketplace 元件。 + **AWS KMS** – 如果透過 加密，則會授予解密 Image Builder 元件的存取權 AWS KMS。 + **Amazon S3** – 授予存取權，以取得儲存在名稱開頭為 的 Amazon S3 儲存貯體中的物件`ec2imagebuilder-`，或具有 ISO 副檔名的資源。 若要檢視此政策的許可，請參閱 *AWS 受管政策參考*中的 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilder.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilder.html)。 ## EC2InstanceProfileForImageBuilderECRContainerBuilds 政策 此**EC2InstanceProfileForImageBuilderECRContainerBuilds**政策會授予使用 Image Builder 建置 Docker 映像時 EC2 執行個體所需的最低許可，然後將映像註冊並存放在 Amazon ECR 容器儲存庫中。這不包括使用 Systems Manager Agent 所需的許可。 ### 許可詳細資訊 此政策包含以下許可： + **CloudWatch Logs** – 授予建立 CloudWatch Logs 並將其上傳至名稱開頭為 之任何日誌群組的存取權`/aws/imagebuilder/`。 + **Amazon ECR** – 授予 Amazon ECR 取得、註冊和存放容器映像，以及取得授權字符的存取權。 + **映像建置器** – 授予取得映像建置器元件或容器配方的存取權。 + **AWS KMS** – 如果 Image Builder 元件或容器配方是透過 加密，則會授予其解密的存取權 AWS KMS。 + **Amazon S3** – 授予存取權，以取得儲存在名稱開頭為 的 Amazon S3 儲存貯體中的物件`ec2imagebuilder-`。 若要檢視此政策的許可，請參閱 *AWS 受管政策參考*中的 [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilderECRContainerBuilds.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilderECRContainerBuilds.html)。 ## AWS 受管政策的映像建置器更新 本節提供有關 Image Builder AWS 自此服務開始追蹤這些變更以來受管政策更新的資訊。如需此頁面變更的自動提醒，請訂閱映像建置器[文件歷史記錄](doc-history.md)頁面上的 RSS 摘要。 | 變更 | 描述 | Date | | --- | --- | --- | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2026 年 2 月 26 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更，以支援在配方和映像分佈期間使用 AWS Systems Manager (SSM) 參數存放區參數。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2025 年 7 月 23 日 | | [EC2InstanceProfileForImageBuilder](#sec-iam-manpol-EC2InstanceProfileForImageBuilder) – 更新現有政策 | Image Builder 對執行個體描述檔政策進行了下列變更，以支援更多 ISO 檔案下載的副檔名。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2025 年 5 月 19 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更，以支援匯入 Microsoft 用戶端作業系統 ISO 檔案作為基礎映像。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2024 年 12 月 30 日 | | [EC2InstanceProfileForImageBuilder](#sec-iam-manpol-EC2InstanceProfileForImageBuilder) – 更新現有政策 | Image Builder 對執行個體描述檔政策進行了下列變更，以支援從磁碟映像檔案建立映像。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2024 年 12 月 30 日 | | [EC2InstanceProfileForImageBuilder](#sec-iam-manpol-EC2InstanceProfileForImageBuilder) - 更新的政策 | Image Builder 已更新`EC2InstanceProfileForImageBuilder`政策，以允許 Image Builder 取得 AWS Marketplace 元件。 | 2024 年 12 月 2 日 | | [EC2ImageBuilderLifecycleExecutionPolicy](#sec-iam-manpol-EC2ImageBuilderLifecycleExecutionPolicy) – 新政策 | Image Builder 新增了包含映像生命週期管理許可的新`EC2ImageBuilderLifecycleExecutionPolicy`政策。 | 2023 年 11 月 17 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更，以提供執行個體置放支援。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2023 年 10 月 19 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更，以提供執行個體置放支援。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2023 年 9 月 28 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更，以允許 Image Builder 工作流程收集 AMI 和 ECR 容器映像組建的漏洞調查結果。新的許可支援 CVE 偵測和報告功能。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2023 年 3 月 30 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2022 年 3 月 22 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2022 年 2 月 21 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 對服務角色進行了下列變更： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2021 年 11 月 20 日 | | [AWSServiceRoleForImageBuilder](#sec-iam-manpol-AWSServiceRoleForImageBuilder) – 更新現有政策 | Image Builder 新增了新的許可，以修正多個庫存關聯導致映像建置卡住的問題。 | 2021 年 8 月 11 日 | | [AWSImageBuilderFullAccess](#sec-iam-manpol-AWSImageBuilderFullAccess) – 更新現有政策 | Image Builder 對完整存取角色進行了下列變更： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/imagebuilder/latest/userguide/security-iam-awsmanpol.html) | 2021 年 4 月 13 日 | | Image Builder 已開始追蹤變更 | Image Builder 開始追蹤其 AWS 受管政策的變更。 | 2021 年 4 月 2 日 | # 使用映像建置器的 IAM 服務連結角色 EC2 Image Builder 使用 AWS Identity and Access Management (IAM) [服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服務連結角色是直接連結至 Image Builder 的唯一 IAM 角色類型。服務連結角色由 Image Builder 預先定義，並包含服務 AWS 服務 代表您呼叫其他 所需的所有許可。 服務連結角色可讓設定 Image Builder 更有效率，因為您不必手動新增必要的許可。Image Builder 定義其服務連結角色的許可，除非另有定義，否則只有 Image Builder 可以擔任其角色。已定義的許可包括信任政策和許可政策。許可原則無法附加到其他任何 IAM 實體。 如需有關支援服務連結角色的其他 服務的資訊，請參閱[AWS 服務 該使用 IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，並在**服務連結角色**欄中尋找具有**是**的服務。選擇具有連結的**是**，以檢視該服務的服務連結角色文件。 ## Image Builder 的服務連結角色許可 Image Builder 使用**AWSServiceRoleForImageBuilder**服務連結角色，以允許 EC2 Image Builder 代表您存取 AWS 資源。服務連結角色信任 *imagebuilder.amazonaws.com* 服務擔任該角色。 您不需要手動建立這個服務連結角色。當您在 AWS 管理主控台、 AWS CLI或 AWS API 中建立第一個映像建置器映像時，映像建置器會為您建立服務連結角色。 下列動作會建立新的映像： + 在映像建置器主控台中執行管道精靈，以建立自訂映像。 + 使用下列其中一個 API 動作，或其對應的 AWS CLI 命令： + **[CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html)** API 動作 (**[create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)** 中的 AWS CLI)。 + **[ImportVmImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ImportVmImage.html)** API 動作 (**[import-vm-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-vm-image.html)** 中的 AWS CLI)。 + **[StartImagePipelineExecution](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_StartImagePipelineExecution.html)** API 動作 (**[start-image-pipeline-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/start-image-pipeline-execution.html)** 中的 AWS CLI)。 **重要** 如果已從您的帳戶刪除服務連結角色，您可以使用相同的程序再次建立該角色。當您建立第一個 EC2 Image Builder 資源時，Image Builder 會再次為您建立服務連結角色。 若要查看 的許可**AWSServiceRoleForImageBuilder**，請參閱 [AWSServiceRoleForImageBuilder 政策](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder)頁面。若要進一步了解如何設定服務連結角色的許可，請參閱《*IAM 使用者指南*》中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。 ## 從您的帳戶移除 Image Builder 服務連結角色 您可以使用 IAM 主控台 AWS CLI、 或 AWS API，從您的帳戶手動移除 Image Builder 的服務連結角色。不過，在執行此操作之前，您必須確保未啟用任何參考它的映像建置器資源。 **注意** 如果 Image Builder 服務在您嘗試刪除資源時使用角色，刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。 **清除`AWSServiceRoleForImageBuilder`角色使用的映像建置器資源** 1. 開始之前，請確認沒有任何管道建置正在執行。若要取消執行中的組建，請使用 中的 `cancel-image-creation`命令 AWS CLI。 ``` aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-east-1:123456789012:image-pipeline/sample-pipeline ``` 1. 變更所有管道排程以使用手動建置程序，如果您不會再次使用它們，請將其刪除。如需刪除資源的詳細資訊，請參閱 [刪除過期或未使用的映像建置器資源](delete-resources.md)。 **使用 IAM 刪除服務連結角色** 您可以使用 IAM 主控台 AWS CLI、 或 AWS API，從您的帳戶刪除`AWSServiceRoleForImageBuilder`角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。 ## Image Builder 服務連結角色支援的區域 Image Builder 支援在所有提供服務的 AWS 區域中使用服務連結角色。如需支援的 AWS 區域清單，請參閱 [AWS 區域和端點](what-is-image-builder.md#image-builder-regions)。 # 對 Image Builder 中的 IAM 問題進行故障診斷 **Topics** + [我無權在映像建置器中執行動作](#security_iam_troubleshoot-no-permissions) + [我未獲得執行 iam:PassRole 的授權](#security_iam_troubleshoot-passrole) + [我想要允許 以外的人員 AWS 帳戶 存取我的映像建置器資源](#security_iam_troubleshoot-cross-account-access) ## 我無權在映像建置器中執行動作 如果您收到錯誤，告知您未獲授權執行動作，您的政策必須更新，允許您執行動作。 下列範例錯誤會在`mateojackson` IAM 使用者嘗試使用主控台檢視一個虛構 `my-example-widget` 資源的詳細資訊，但卻無虛構 `imagebuilder:GetWidget` 許可時發生。 ``` User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: imagebuilder:GetWidget on resource: my-example-widget ``` 在此情況下，必須更新 `mateojackson` 使用者的政策，允許使用 `imagebuilder:GetWidget` 動作存取 `my-example-widget` 資源。 如果您需要協助，請聯絡您的 AWS 管理員。您的管理員提供您的簽署憑證。 ## 我未獲得執行 iam:PassRole 的授權 如果您收到錯誤，告知您無權執行 `iam:PassRole`動作，您的政策必須更新，以允許您將角色傳遞給 Image Builder。 有些 AWS 服務 可讓您將現有角色傳遞給該服務，而不是建立新的服務角色或服務連結角色。如需執行此作業，您必須擁有將角色傳遞至該服務的許可。 當名為 的 IAM `marymajor` 使用者嘗試使用主控台在 Image Builder 中執行動作時，會發生下列範例錯誤。但是，動作請求服務具備服務角色授予的許可。Mary 沒有將角色傳遞給服務的許可。 ``` User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole ``` 在這種情況下，Mary 的政策必須更新，允許她執行 `iam:PassRole` 動作。 如果您需要協助，請聯絡您的 AWS 管理員。您的管理員提供您的簽署憑證。 ## 我想要允許 以外的人員 AWS 帳戶 存取我的映像建置器資源 您可以建立一個角色，讓其他帳戶中的使用者或您組織外部的人員存取您的資源。您可以指定要允許哪些信任物件取得該角色。針對支援基於資源的政策或存取控制清單 (ACL) 的服務，您可以使用那些政策來授予人員存取您的資源的許可。 如需進一步了解，請參閱以下內容： + 若要了解 Image Builder 是否支援這些功能，請參閱 [Image Builder 如何與 IAM 政策和角色搭配使用](security_iam_service-with-iam.md)。 + 若要了解如何提供您擁有 AWS 帳戶 的資源存取權，請參閱《[IAM 使用者指南》中的在您 AWS 帳戶 擁有的另一個 中提供存取權給](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html) *IAM* 使用者。 + 若要了解如何將資源的存取權提供給第三方 AWS 帳戶，請參閱《*IAM 使用者指南*》中的[將存取權提供給第三方 AWS 帳戶 擁有](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)。 + 如需了解如何透過聯合身分提供存取權，請參閱《*IAM 使用者指南*》中的[將存取權提供給在外部進行身分驗證的使用者 (聯合身分)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)。 + 如需了解使用角色和資源型政策進行跨帳戶存取之間的差異，請參閱《IAM 使用者指南》**中的 [IAM 中的跨帳戶資源存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。