App Runner 身分型政策 App Runner 資源型政策以 App Runner 標籤為基礎的授權 App Runner 使用者許可 App Runner IAM角色

App Runner 如何使用 IAM

使用 IAM 管理的存取權之前 AWS App Runner，您應該了解哪些IAM功能可與 App Runner 搭配使用。若要深入了解 App Runner 和其他 AWS 服務如何與搭配使用IAM，請參閱IAM《使用者指南》中的AWS 使用的服務IAM。

如需其他 App Runner 安全主題，請參閱應用程序運行器中的。

主題

App Runner 身分型政策
App Runner 資源型政策
以 App Runner 標籤為基礎的授權
App Runner 使用者許可
App Runner IAM角色

App Runner 身分型政策

使用 IAM 身分型政策，您可以指定允許或拒絕的動作和資源，以及在何種條件下允許或拒絕動作。App Runner 支援特定動作、資源和條件索引鍵。若要了解您在JSON政策中使用的所有元素，請參閱 IAM 使用者指南中的IAMJSON政策元素參考。

動作

管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個主體在什麼條件下可以對什麼資源執行哪些動作。

JSON 政策的 Action元素說明您可以用來允許或拒絕政策中存取的動作。政策動作通常具有與相關聯 AWS API操作相同的名稱。有一些例外狀況，例如沒有相符API操作的僅限許可動作。也有一些作業需要政策中的多個動作。這些額外的動作稱為相依動作。

政策會使用動作來授予執行相關聯動作的許可。

App Runner 中的政策動作在動作之前使用下列字首：apprunner:。例如，若要授予某人使用 Amazon EC2RunInstancesAPI操作執行 Amazon EC2執行個體的許可，請在其政策中包含 ec2:RunInstances動作。政策陳述式必須包含 Action 或 NotAction 元素。App Runner 會定義自己的動作集，描述您可以使用此服務執行的任務。

若要在單一陳述式中指定多個動作，請用逗號分隔，如下所示：


"Action": [
   "apprunner:CreateService",
   "apprunner:CreateConnection"
]

您也可以使用萬用字元 (*) 來指定多個動作。例如，若要指定開頭是 Describe 文字的所有動作，請包含以下動作：


"Action": "apprunner:Describe*"

若要查看 App Runner 動作清單，請參閱服務授權參考中的定義的動作 AWS App Runner。

資源

管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個主體在什麼條件下可以對什麼資源執行哪些動作。

Resource JSON 政策元素會指定動作套用的物件。陳述式必須包含 Resource 或 NotResource 元素。最佳實務是使用其 Amazon Resource Name (ARN) 指定資源。您可以針對支援特定資源類型的動作 (稱為資源層級許可) 來這麼做。

對於不支援資源層級許可的動作 (例如列出操作)，請使用萬用字元 (*) 來表示陳述式適用於所有資源。


"Resource": "*"

App Runner 資源具有下列ARN結構：


arn:aws:apprunner:region:account-id:resource-type/resource-name[/resource-id]

如需的格式詳細資訊ARNs，請參閱中的 Amazon Resource Names (ARNs) AWS 和服務命名空間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。若要了解您可以使用哪些動作來指定每個資源ARN的，請參閱定義的動作 AWS App Runner。

條件索引鍵

管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個主體在什麼條件下可以對什麼資源執行哪些動作。

Condition 元素 (或 Condition 區塊) 可讓您指定使陳述式生效的條件。Condition 元素是選用項目。您可以建立使用條件運算子的條件運算式 (例如等於或小於)，來比對政策中的條件和請求中的值。

若您在陳述式中指定多個 Condition 元素，或是在單一 Condition 元素中指定多個索引鍵， AWS 會使用邏輯 AND 操作評估他們。如果您為單一條件索引鍵指定多個值，會使用邏輯OR操作 AWS 評估條件。必須符合所有條件，才會授與陳述式的許可。

您也可以在指定條件時使用預留位置變數。例如，您可以只在使用者使用其 IAM 使用者名稱標記時，將存取資源的許可授予該 IAM 使用者。如需詳細資訊，請參閱IAM《使用者指南》中的IAM政策元素：變數和標籤。

AWS 支援全域條件索引鍵和服務特定條件索引鍵。若要查看所有 AWS 全域條件索引鍵，請參閱IAM《使用者指南》中的AWS 全域條件內容索引鍵。

App Runner 支援使用一些全域條件金鑰。若要查看所有 AWS 全域條件金鑰，請參閱 IAM 使用者指南中的AWS 全域條件內容金鑰。

App Runner 定義一組服務特定的條件金鑰。此外，App Runner 支援標籤型存取控制，其使用條件金鑰實作。如需詳細資訊，請參閱以 App Runner 標籤為基礎的授權。

若要查看 App Runner 條件索引鍵的清單，請參閱服務授權參考中的的條件索引鍵 AWS App Runner。若要了解您可以使用條件索引鍵的動作和資源，請參閱定義的動作 AWS App Runner。

範例

若要檢視 App Runner 身分型政策的範例，請參閱 App Runner 身分型政策範例。

App Runner 資源型政策

App Runner 不支援以資源為基礎的政策。

以 App Runner 標籤為基礎的授權

您可以將標籤連接至 App Runner 資源，或將請求中的標籤傳遞至 App Runner。如需根據標籤控制存取，請使用 apprunner:ResourceTag/key-name、aws:RequestTag/key-name 或 aws:TagKeys 條件索引鍵，在政策的條件元素中，提供標籤資訊。如需標記 App Runner 資源的詳細資訊，請參閱設定 App Runner 服務。

若要檢視身分型政策範例，以根據該資源上的標籤來限制存取資源，請參閱根據標籤控制對 App Runner 服務的存取。

App Runner 使用者許可

若要使用 App Runner，IAM使用者需要 App Runner 動作的許可。將政策連接至使用者或群組，是將許可授予IAM使用者的常見方式。如需管理使用者許可的詳細資訊，請參閱IAM《使用者指南》中的變更IAM使用者的許可。

App Runner 提供兩個可連接至使用者的受管政策。

AWSAppRunnerReadOnlyAccess – 准許列出和檢視有關 App Runner 資源的詳細資訊。
AWSAppRunnerFullAccess – 授予許可給所有 App Runner 動作。

如需更精細地控制使用者許可，您可以建立自訂政策並將其連接至使用者。如需詳細資訊，請參閱IAM《使用者指南》中的建立IAM政策。

如需使用者政策的範例，請參閱使用者政策。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "apprunner:List*",
        "apprunner:Describe*"
      ],
      "Resource": "*"
    }
  ]
}


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "iam:CreateServiceLinkedRole",
      "Resource": [
        "arn:aws:iam::*:role/aws-service-role/apprunner.amazonaws.com/AWSServiceRoleForAppRunner",
        "arn:aws:iam::*:role/aws-service-role/networking.apprunner.amazonaws.com/AWSServiceRoleForAppRunnerNetworking"
      ],
      "Condition": {
        "StringLike": {
          "iam:AWSServiceName": [
            "apprunner.amazonaws.com",
            "networking.apprunner.amazonaws.com"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": "*",
      "Condition": {
        "StringLike": {
          "iam:PassedToService": "apprunner.amazonaws.com"
        }
      }
    },
    {
      "Sid": "AppRunnerAdminAccess",
      "Effect": "Allow",
      "Action": "apprunner:*",
      "Resource": "*"
    }
  ]
}

App Runner IAM角色

IAM 角色是中具有特定許可 AWS 帳戶的實體。

服務連結角色

服務連結角色可讓 AWS 服務存取其他服務中的資源，以代表您完成動作。服務連結角色會顯示在您的 IAM 帳戶中，並由該服務所擁有。IAM 管理員可以檢視，但不能編輯服務連結角色的許可。

App Runner 支援服務連結角色。如需建立或管理 App Runner 服務連結角色的資訊，請參閱將服務連結角色用於應用程式執行。

服務角色

此功能可讓服務代表您擔任服務角色。此角色可讓服務存取其他服務中的資源，以代表您完成動作。服務角色會出現在您的 IAM 帳戶，且由該帳戶所擁有。這表示IAM使用者可以變更此角色的許可。不過，這樣可能會破壞此服務的功能。

App Runner 支援幾個服務角色。

存取角色

存取角色是 App Runner 用來存取您帳戶中 Amazon Elastic Container Registry (AmazonECR) 中影像的角色。在 Amazon 中存取映像是必要的ECR，而 Amazon ECR Public 則不需要。在 Amazon 中根據映像建立服務之前ECR，請使用 IAM建立服務角色，並在其中使用 AWSAppRunnerServicePolicyForECRAccess 受管政策。然後，當您在 SourceConfiguration 參數AuthenticationConfiguration的成員CreateServiceAPI中呼叫，或使用 App Runner 主控台建立服務時，您可以將此角色傳遞給 App Runner。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ecr:GetDownloadUrlForLayer",
        "ecr:BatchCheckLayerAvailability",
        "ecr:BatchGetImage",
        "ecr:DescribeImages",
        "ecr:GetAuthorizationToken"
      ],
      "Resource": "*"
    }
  ]
}

注意

如果您為存取角色建立自己的自訂政策，請務必"Resource": "*"為 ecr:GetAuthorizationToken動作指定。權杖可用於存取您能夠存取的任何 Amazon ECR登錄檔。

當您建立存取角色時，請務必新增信任政策，將 App Runner 服務主體宣告build.apprunner.amazonaws.com為信任的實體。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "build.apprunner.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

如果您使用 App Runner 主控台來建立服務，主控台可以自動為您建立存取角色，並為新服務選擇該角色。主控台也會列出您帳戶中的其他角色，如果您願意，可以選擇不同的角色。

執行個體角色

執行個體角色是選用角色，App Runner 會使用它來提供許可，以 AWS 提供您服務的運算執行個體所需的服務動作。如果您的應用程式程式碼呼叫 AWS 動作 ()，您需要提供執行個體角色給 App RunnerAPIs。您可以在執行個體角色中內嵌必要的許可，或建立您自己的自訂政策，並在執行個體角色中使用它。我們無法預測您的程式碼使用哪些呼叫。因此，我們不會為此目的提供受管政策。

建立 App Runner 服務之前，請使用 IAM建立具有所需自訂或內嵌政策的服務角色。然後，當您在 InstanceConfiguration 參數InstanceRoleArn的成員CreateServiceAPI中呼叫，或使用 App Runner 主控台建立服務時，您可以將此角色傳遞給 App Runner 做為執行個體角色。

當您建立執行個體角色時，請務必新增信任政策，將 App Runner 服務主體宣告tasks.apprunner.amazonaws.com為信任的實體。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "tasks.apprunner.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

如果您使用 App Runner 主控台來建立服務，主控台會列出您帳戶中的角色，而且您可以選擇您為此目的建立的角色。

如需建立服務的資訊，請參閱建立 App Runner 服務。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

身分與存取管理

身分型政策範例