AWS App Runner 不再開放給新客戶。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS App Runner 可用性變更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # App Runner 如何與 IAM 搭配使用 在您使用 IAM 管理對 的存取之前 AWS App Runner，您應該了解哪些 IAM 功能可與 App Runner 搭配使用。若要全面了解 App Runner 和其他 AWS 服務如何與 IAM 搭配使用，請參閱《IAM *使用者指南*》中的與 IAM [AWS 搭配使用的 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。 如需其他 App Runner 安全主題，請參閱 [App Runner 的安全性](security.md)。 **Topics** + [App Runner 身分型政策](#security_iam_service-with-iam-id-based-policies) + [App Runner 資源型政策](#security_iam_service-with-iam-resource-based-policies) + [以 App Runner 標籤為基礎的授權](#security_iam_service-with-iam-tags) + [App Runner 使用者許可](#security_iam_service-with-iam-users) + [App Runner IAM 角色](#security_iam_service-with-iam-roles) ## App Runner 身分型政策 使用 IAM 身分型政策，您可以指定允許或拒絕的動作和資源，以及在何種條件下允許或拒絕動作。App Runner 支援特定動作、資源和條件索引鍵。若要了解您在 JSON 政策中使用的所有元素，請參閱 *IAM 使用者指南*中的 [JSON 政策元素參考](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)。 ### 動作 管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。 JSON 政策的 `Action` 元素描述您可以用來允許或拒絕政策中存取的動作。政策會使用動作來授予執行相關聯動作的許可。 App Runner 中的政策動作在動作之前使用下列字首：`apprunner:`。例如，若要授予某人使用 Amazon EC2 `RunInstances` API 作業來執行 Amazon EC2 執行個體的許可，請在其政策中加入 `ec2:RunInstances` 動作。政策陳述式必須包含 `Action` 或 `NotAction` 元素。App Runner 會定義自己的一組動作，描述您可以使用此服務執行的任務。 若要在單一陳述式中指定多個動作，請用逗號分隔，如下所示： ``` "Action": [ "apprunner:CreateService", "apprunner:CreateConnection" ] ``` 您也可以使用萬用字元 (\*) 來指定多個動作。例如，若要指定開頭是 `Describe` 文字的所有動作，請包含以下動作： ``` "Action": "apprunner:Describe*" ``` 若要查看 App Runner 動作的清單，請參閱《*服務授權參考*》中的 [定義的動作 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-actions-as-permissions)。 ### Resources 管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。 `Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。若動作不支援資源層級許可，使用萬用字元 (\*) 表示該陳述式適用於所有資源。 ``` "Resource": "*" ``` App Runner 資源具有下列 ARN 結構： ``` arn:aws:apprunner:{{region}}:{{account-id}}:{{resource-type}}/{{resource-name}}[/{{resource-id}}] ``` 如需 ARNs 格式的詳細資訊，請參閱 中的 [Amazon Resource Name (ARNs) AWS 和服務命名空間](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)*AWS 一般參考*。 例如，若要在陳述式中指定 `my-service`服務，請使用下列 ARN： ``` "Resource": "arn:aws:apprunner:us-east-1:123456789012:service/my-service" ``` 若要指定屬於特定帳戶的所有服務，請使用萬用字元 (\*)： ``` "Resource": "arn:aws:apprunner:us-east-1:123456789012:service/*" ``` 有些 App Runner 動作無法在特定資源上執行，例如用於建立資源的動作。在這些情況下，您必須使用萬用字元 (\*)。 ``` "Resource": "*" ``` 若要查看 App Runner 資源類型及其 ARNs，請參閱*《服務授權參考*》中的 [定義的資源 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-resources-for-iam-policies)。若要了解您可以使用哪些動作指定每個資源的 ARN，請參閱 [AWS App Runner定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-actions-as-permissions)。 ### 條件索引鍵 管理員可以使用 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)。 App Runner 支援使用一些全域條件金鑰。若要查看所有 AWS 全域條件金鑰，請參閱《*IAM 使用者指南*》中的[AWS 全域條件內容金鑰](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。 App Runner 定義一組服務特定的條件金鑰。此外，App Runner 支援標籤型存取控制，其使用條件金鑰實作。如需詳細資訊，請參閱[以 App Runner 標籤為基礎的授權](#security_iam_service-with-iam-tags)。 若要查看 App Runner 條件索引鍵的清單，請參閱《*服務授權參考*》中的 [的條件索引鍵 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-policy-keys)。若要了解您可以使用條件金鑰的動作和資源，請參閱 [定義的動作 AWS App Runner](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsapprunner.html#awsapprunner-actions-as-permissions)。 ### 範例 若要檢視 App Runner 身分型政策的範例，請參閱 [App Runner 身分型政策範例](security_iam_id-based-policy-examples.md)。 ## App Runner 資源型政策 App Runner 不支援以資源為基礎的政策。 ## 以 App Runner 標籤為基礎的授權 您可以將標籤連接至 App Runner 資源，或在請求中將標籤傳遞至 App Runner。如需根據標籤控制存取，請使用 `apprunner:ResourceTag/{{key-name}}`、`aws:RequestTag/{{key-name}}` 或 `aws:TagKeys` 條件索引鍵，在政策的[條件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中，提供標籤資訊。如需標記 App Runner 資源的詳細資訊，請參閱[設定 App Runner 服務](manage-configure.md)。 若要檢視身分型政策範例，以根據該資源上的標籤來限制存取資源，請參閱 [根據標籤控制對 App Runner 服務的存取](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-widget-tags)。 ## App Runner 使用者許可 若要使用 App Runner，IAM 使用者需要 App Runner 動作的許可。授予許可給使用者的常見方法是將政策連接到 IAM 使用者或群組。如需管理使用者許可的詳細資訊，請參閱《[IAM 使用者指南》中的變更 IAM 使用者的許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html)。 ** App Runner 提供兩個可連接至使用者的受管政策。 + [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerReadOnlyAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerReadOnlyAccess.html) – 准許列出和檢視 App Runner 資源的詳細資訊。 + [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerFullAccess.html)– 授予所有 App Runner 動作的許可。 如需更精細地控制使用者許可，您可以建立自訂政策並將其連接到您的使用者。如需詳細資訊，請參閱《[IAM 使用者指南》中的建立 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。 ** 如需使用者政策的範例，請參閱 [使用者政策](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-users)。 ## App Runner IAM 角色 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)是 中具有特定許可 AWS 帳戶 的實體。 ### 服務連結角色 [服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)可讓 AWS 服務存取其他服務中的資源，以代表您完成 動作。服務連結角色會顯示在您的 IAM 帳戶中，並由該服務所擁有。IAM 管理員可以檢視，但不能編輯服務連結角色的許可。 App Runner 支援服務連結角色。如需建立或管理 App Runner 服務連結角色的資訊，請參閱 [使用 App Runner 的服務連結角色](security-iam-slr.md)。 ### 服務角色 此功能可讓服務代表您擔任[服務角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)。此角色可讓服務存取其他服務中的資源，以代表您完成動作。服務角色會出現在您的 IAM 帳戶中，且由該帳戶所擁有。這表示 IAM 使用者可以變更此角色的許可。不過，這樣可能會破壞此服務的功能。 App Runner 支援幾個服務角色。 #### 存取角色 存取角色是 App Runner 用來存取您帳戶中 Amazon Elastic Container Registry (Amazon ECR) 中映像的角色。在 Amazon ECR 中存取映像是必要的，而 Amazon ECR Public 則不需要。 在 Amazon ECR 中根據映像建立服務之前，請使用 IAM 建立服務角色。在您的服務角色[https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerServicePolicyForECRAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAppRunnerServicePolicyForECRAccess.html)中使用 受管政策。然後，當您在 [SourceConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_SourceConfiguration.html) 參數的 [AuthenticationConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_AuthenticationConfiguration.html) 成員中呼叫 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API，或使用 App Runner 主控台建立服務時，您可以將此角色傳遞給 App Runner。 **注意** 如果您為存取角色建立自己的自訂政策，請務必`"Resource": "*"`為 `ecr:GetAuthorizationToken`動作指定 。權杖可用於存取您有權存取的任何 Amazon ECR 登錄檔。 當您建立存取角色時，請務必新增信任政策，將 App Runner 服務主體宣告`build.apprunner.amazonaws.com`為信任的實體。 ##### 存取角色的信任政策 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "build.apprunner.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 如果您使用 App Runner 主控台來建立服務，主控台可以自動為您建立存取角色，並為新服務選擇該角色。主控台也會列出您帳戶中的其他角色，您可以視需要選取不同的角色。 #### 執行個體角色 執行個體角色是選用角色，App Runner 會用來提供許可給您 AWS 服務的運算執行個體所需的服務動作。如果您的應用程式程式碼呼叫 AWS 動作 (APIs)，您需要提供執行個體角色給 App Runner。您可以在執行個體角色中嵌入必要的許可，或建立您自己的自訂政策，並在執行個體角色中使用它。我們無法預測您的程式碼使用哪些 呼叫。因此，我們不會為此目的提供受管政策。 建立 App Runner 服務之前，請使用 IAM 建立具有所需自訂或內嵌政策的服務角色。然後，當您在 [InstanceConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_InstanceConfiguration.html) 參數`InstanceRoleArn`的成員中呼叫 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API，或使用 App Runner 主控台建立服務時，您可以將此角色傳遞給 App Runner 做為執行個體角色。 當您建立執行個體角色時，請務必新增信任政策，將 App Runner 服務主體宣告`tasks.apprunner.amazonaws.com`為信任的實體。 ##### 執行個體角色的信任政策 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "tasks.apprunner.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 如果您使用 App Runner 主控台來建立服務，主控台會列出帳戶中的角色，而且您可以選取為此目的建立的角色。 如需建立服務的資訊，請參閱 [建立 App Runner 服務](manage-create.md)。