本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Elastic Container Registry 如何使用 IAM
使用 IAM管理 Amazon 的存取權之前ECR,您應該了解哪些IAM功能可與 Amazon 搭配使用ECR。若要深入了解 Amazon ECR和其他 AWS 服務如何與 搭配使用IAM,請參閱IAM《 使用者指南》中的與 AWS 搭配使用的服務IAM。
Amazon ECR Identity 型政策
使用 IAM 身分型政策,您可以指定允許或拒絕的動作和資源,以及在何種條件下允許或拒絕動作。Amazon ECR支援特定動作、資源和條件索引鍵。若要了解您在JSON政策中使用的所有元素,請參閱 IAM 使用者指南中的IAMJSON政策元素參考。
動作
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作。
JSON 政策的 Action
元素說明您可以用來允許或拒絕政策中存取的動作。政策動作通常具有與相關聯 AWS API操作相同的名稱。有一些例外狀況,例如沒有相符API操作的僅限許可動作。也有一些作業需要政策中的多個動作。這些額外的動作稱為相依動作。
政策會使用動作來授予執行相關聯動作的許可。
Amazon 中的政策動作在動作之前ECR使用下列字首:ecr:
。例如,若要授予某人使用 Amazon ECRCreateRepository
API操作建立 Amazon ECR儲存庫的許可,請在其政策中包含 ecr:CreateRepository
動作。政策陳述式必須包含 Action
或 NotAction
元素。Amazon 會ECR定義自己的動作集,描述您可以使用此服務執行的任務。
若要在單一陳述式中指定多個動作,請用逗號分隔,如下所示:
"Action": [ "ecr:action1", "ecr:action2"
您也可以使用萬用字元 (*) 來指定多個動作。例如,若要指定開頭是 Describe
文字的所有動作,請包含以下動作:
"Action": "ecr:Describe*"
若要查看 Amazon ECR動作清單,請參閱IAM《 使用者指南》中的 Amazon Elastic Container Registry 的動作、資源和條件金鑰。
資源
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作。
Resource
JSON 政策元素會指定 動作套用的物件。陳述式必須包含 Resource
或 NotResource
元素。最佳實務是使用其 Amazon Resource Name (ARN) 指定資源。您可以針對支援特定資源類型的動作 (稱為資源層級許可) 來這麼做。
對於不支援資源層級許可的動作 (例如列出操作),請使用萬用字元 (*) 來表示陳述式適用於所有資源。
"Resource": "*"
Amazon ECR儲存庫資源具有下列 ARN:
arn:${Partition}:ecr:${Region}:${Account}:repository/${Repository-name}
如需 的格式詳細資訊ARNs,請參閱 Amazon Resource Names (ARNs) AWS 和服務命名空間。
例如,若要在陳述式的 us-east-1
區域中指定my-repo
儲存庫,請使用下列 ARN:
"Resource": "arn:aws:ecr:
us-east-1
:123456789012
:repository/my-repo"
若要指定屬於特定帳戶的所有儲存庫,請使用萬用字元 (*):
"Resource": "arn:aws:ecr:
us-east-1
:123456789012
:repository/*"
若要在單一陳述式中指定多個資源,ARNs請以逗號分隔 。
"Resource": [ "resource1", "resource2"
若要查看 Amazon ECR 資源類型及其 的清單ARNs,請參閱IAM《 使用者指南》中的 Amazon Elastic Container Registry 定義的資源。若要了解您可以使用哪些動作來指定每個資源ARN的 ,請參閱 Amazon Elastic Container Registry 定義的動作。
條件索引鍵
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作。
Condition
元素 (或 Condition
區塊) 可讓您指定使陳述式生效的條件。Condition
元素是選用項目。您可以建立使用條件運算子的條件運算式 (例如等於或小於),來比對政策中的條件和請求中的值。
若您在陳述式中指定多個 Condition
元素,或是在單一 Condition
元素中指定多個索引鍵, AWS 會使用邏輯 AND
操作評估他們。如果您為單一條件索引鍵指定多個值, 會使用邏輯OR
操作 AWS 評估條件。必須符合所有條件,才會授與陳述式的許可。
您也可以在指定條件時使用預留位置變數。例如,您可以只在使用者使用其 IAM 使用者名稱標記時,將存取資源的許可授予該 IAM 使用者。如需詳細資訊,請參閱IAM《 使用者指南》中的IAM政策元素:變數和標籤。
AWS 支援全域條件金鑰和服務特定的條件金鑰。若要查看所有 AWS 全域條件索引鍵,請參閱IAM《 使用者指南》中的AWS 全域條件內容索引鍵。
Amazon 會ECR定義自己的一組條件金鑰,也支援使用一些全域條件金鑰。若要查看所有 AWS 全域條件金鑰,請參閱 IAM 使用者指南中的AWS 全域條件內容金鑰。
大多數 Amazon ECR動作都支援 aws:ResourceTag
和 ecr:ResourceTag
條件金鑰。如需詳細資訊,請參閱使用標籤型存取控制。
若要查看 Amazon ECR條件金鑰清單,請參閱IAM《 使用者指南》中的 Amazon Elastic Container Registry 定義的條件金鑰。若要了解您可以搭配哪些動作和資源使用條件索引鍵,請參閱 Amazon Elastic Container Registry 定義的動作。
範例
若要檢視 Amazon ECR身分型政策的範例,請參閱 Amazon Elastic Container Registry 身分型政策的範例。
Amazon ECR 資源型政策
資源型政策是JSON政策文件,指定指定委託人可以在 Amazon ECR 資源上執行的動作,以及在哪些條件下執行的動作。Amazon ECR支援 Amazon ECR儲存庫的資源型許可政策。資源型政策可讓您依資源將使用許可授予至其他帳戶。您也可以使用資源型政策,允許 AWS 服務存取您的 Amazon ECR儲存庫。
若要啟用跨帳戶存取,您可以指定在其他帳戶內的所有帳戶或 IAM 實體,做為以資源為基礎政策的委託人。新增跨帳戶主體至資源型政策,只是建立信任關係的一半。當委託人和資源位於不同的 AWS 帳戶中時,您還必須授予委託人實體存取資源的許可。透過將身分型政策連接到實體來授予許可。不過,如果資源型政策會為相同帳戶中的委託人授予存取,這時就不需要額外的身分型政策。如需詳細資訊,請參閱IAM《 使用者指南》中的IAM角色與資源型政策的差異。
Amazon ECR服務僅支援一種名為儲存庫政策的資源型政策類型,該政策會連接至儲存庫。此政策會定義哪些委託人實體 (帳戶、使用者、角色和聯合身分使用者) 可在該儲存庫上執行動作。若要了解如何將資源型政策連接到儲存庫,請參閱 Amazon ECR 中的私有儲存庫政策。
注意
在 Amazon ECR儲存庫政策中,政策元素Sid
支援IAM政策中不支援的其他字元和間距。
範例
若要檢視以 Amazon ECR 資源為基礎的政策範例,請參閱 Amazon ECR 中的私有儲存庫政策範例、
根據 Amazon ECR標籤的授權
您可以將標籤連接至 Amazon ECR 資源,或將請求中的標籤傳遞至 Amazon ECR。如需根據標籤控制存取,請使用 ecr:ResourceTag/
、key-name
aws:RequestTag/
或 key-name
aws:TagKeys
條件索引鍵,在政策的條件元素中,提供標籤資訊。如需標記 Amazon ECR 資源的詳細資訊,請參閱在 Amazon 中標記私有存儲庫 ECR。
若要檢視身分型政策範例,以根據該資源上的標籤來限制存取資源,請參閱使用標籤型存取控制。
Amazon ECRIAM角色
IAM 角色是您 AWS 帳戶中具有特定許可的實體。
搭配 Amazon 使用暫時登入資料 ECR
您可以使用暫時登入資料登入聯合、取得 IAM 角色,或是取得跨帳戶角色。您可以透過呼叫 AWS STS API AssumeRole或 等操作來取得臨時安全登入資料GetFederationToken。
Amazon ECR支援使用臨時登入資料。
服務連結角色
服務連結角色可讓 AWS 服務存取其他服務中的資源,以代表您完成動作。服務連結角色會顯示在您的 IAM 帳戶中,並由該服務所擁有。IAM 管理員可以檢視,但不能編輯服務連結角色的許可。
Amazon ECR支援服務連結角色。如需詳細資訊,請參閱使用 Amazon 的服務連結角色 ECR。