Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Wie Amazon Elastic Container Registry mit IAM funktioniert
Bevor Sie IAM verwenden, um den Zugriff auf Amazon ECR zu verwalten, sollten Sie verstehen, welche IAM-Features für die Verwendung mit Amazon ECR verfügbar sind. Einen allgemeinen Überblick darüber, wie Amazon ECR und andere AWS Services mit IAM zusammenarbeiten, finden Sie unter AWS Services That Work with IAM im IAM-Benutzerhandbuch.
Themen
Identitätsbasierte Amazon-ECR-Richtlinien
Mit identitätsbasierten IAM-Richtlinien können Sie angeben, welche Aktionen und Ressourcen zugelassen oder abgelehnt werden. Darüber hinaus können Sie die Bedingungen festlegen, unter denen Aktionen zugelassen oder abgelehnt werden. Amazon ECR unterstützt bestimmte Aktionen, Ressourcen und Zustandsschlüssel. Informationen zu sämtlichen Elementen, die Sie in einer JSON-Richtlinie verwenden, finden Sie in der IAM-Referenz für JSON-Richtlinienelemente im IAM-Benutzerhandbuch.
Aktionen
Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer Zugriff auf was hat. Das heißt, welcher Prinzipal Aktionen für welche Ressourcen und unter welchen Bedingungen ausführen kann.
Das Element Action
einer JSON-Richtlinie beschreibt die Aktionen, mit denen Sie den Zugriff in einer Richtlinie zulassen oder verweigern können. Richtlinienaktionen haben normalerweise denselben Namen wie der zugehörige AWS API-Vorgang. Es gibt einige Ausnahmen, z. B. Aktionen, die nur mit Genehmigung durchgeführt werden können und für die es keinen passenden API-Vorgang gibt. Es gibt auch einige Operationen, die mehrere Aktionen in einer Richtlinie erfordern. Diese zusätzlichen Aktionen werden als abhängige Aktionen bezeichnet.
Schließen Sie Aktionen in eine Richtlinie ein, um Berechtigungen zur Durchführung der zugeordneten Operation zu erteilen.
Richtlinienaktionen in Amazon ECR verwenden das folgende Präfix vor der Aktion: ecr:
. Um beispielsweise jemandem die Erlaubnis zu erteilen, ein Amazon ECR-Repository mit der Amazon ECR-CreateRepository
API-Operation zu erstellen, nehmen Sie die ecr:CreateRepository
-Aktion in seine Richtlinie auf. Richtlinienanweisungen müssen entweder ein – Action
oder ein NotAction
-Element enthalten. Amazon ECR definiert einen eigenen Satz von Aktionen, die Aufgaben beschreiben, die Sie mit diesem Service durchführen können.
Um mehrere Aktionen in einer einzigen Anweisung anzugeben, trennen Sie sie wie folgt durch Kommata:
"Action": [ "ecr:action1", "ecr:action2"
Sie können auch Platzhalter verwenden, um mehrere Aktionen anzugeben. Beispielsweise können Sie alle Aktionen festlegen, die mit dem Wort Describe
beginnen, einschließlich der folgenden Aktion:
"Action": "ecr:Describe*"
Eine Liste der Amazon-ECR-Aktionen finden Sie unter Aktionen, Ressourcen und Zustandsschlüssel für Amazon Elastic Container Registry im IAM User Guide.
Ressourcen
Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer auf was Zugriff hat. Das heißt, welcher Prinzipal Aktionen für welche Ressourcen und unter welchen Bedingungen ausführen kann.
Das JSON-Richtlinienelement Resource
gibt die Objekte an, auf welche die Aktion angewendet wird. Anweisungen müssen entweder ein – Resource
oder ein NotResource
-Element enthalten. Als bewährte Methode geben Sie eine Ressource mit dem zugehörigen Amazon-Ressourcennamen (ARN) an. Sie können dies für Aktionen tun, die einen bestimmten Ressourcentyp unterstützen, der als Berechtigungen auf Ressourcenebene bezeichnet wird.
Verwenden Sie für Aktionen, die keine Berechtigungen auf Ressourcenebene unterstützen, z. B. Auflistungsoperationen, einen Platzhalter (*), um anzugeben, dass die Anweisung für alle Ressourcen gilt.
"Resource": "*"
Eine Amazon ECR-Repository-Ressource hat den folgenden ARN:
arn:${Partition}:ecr:${Region}:${Account}:repository/${Repository-name}
Weitere Informationen zum Format von ARNs finden Sie unter Amazon Resource Names (ARNs) und AWS Service Namespaces.
Um beispielsweise das my-repo
-Repository in der us-east-1
- Region in Ihrer Anweisung anzugeben, verwenden Sie den folgenden ARN:
"Resource": "arn:aws:ecr:
us-east-1
:123456789012
:repository/my-repo"
Um alle Repositorys anzugeben, die zu einem bestimmten Konto gehören, verwenden Sie den Platzhalter (*):
"Resource": "arn:aws:ecr:
us-east-1
:123456789012
:repository/*"
Um mehrere Ressourcen in einer einzigen Anweisung anzugeben, trennen Sie sie durch Kommas. ARNs
"Resource": [ "resource1", "resource2"
Eine Liste der Amazon ECR-Ressourcentypen und ihrer ARNs Eigenschaften finden Sie unter Von Amazon Elastic Container Registry definierte Ressourcen im IAM-Benutzerhandbuch. Um zu erfahren, mit welchen Aktionen Sie den ARN einer jeden Ressource angeben können, siehe Von Amazon Elastic Container Registry definierte Aktionen.
Bedingungsschlüssel
Administratoren können mithilfe von AWS JSON-Richtlinien angeben, wer auf was Zugriff hat. Das heißt, welcher Prinzipal kann Aktionen für welche Ressourcen und unter welchen Bedingungen ausführen.
Das Element Condition
(oder Condition
block) ermöglicht Ihnen die Angabe der Bedingungen, unter denen eine Anweisung wirksam ist. Das Element Condition
ist optional. Sie können bedingte Ausdrücke erstellen, die Bedingungsoperatoren verwenden, z. B. ist gleich oder kleiner als, damit die Bedingung in der Richtlinie mit Werten in der Anforderung übereinstimmt.
Wenn Sie mehrere Condition
-Elemente in einer Anweisung oder mehrere Schlüssel in einem einzelnen Condition
-Element angeben, wertet AWS diese mittels einer logischen AND
-Operation aus. Wenn Sie mehrere Werte für einen einzelnen Bedingungsschlüssel angeben, AWS wertet die Bedingung mithilfe einer logischen OR
Operation aus. Alle Bedingungen müssen erfüllt werden, bevor die Berechtigungen der Anweisung gewährt werden.
Sie können auch Platzhaltervariablen verwenden, wenn Sie Bedingungen angeben. Beispielsweise können Sie einem IAM-Benutzer die Berechtigung für den Zugriff auf eine Ressource nur dann gewähren, wenn sie mit dessen IAM-Benutzernamen gekennzeichnet ist. Weitere Informationen finden Sie unter IAM-Richtlinienelemente: Variablen und Tags im IAM-Benutzerhandbuch.
AWS unterstützt globale Bedingungsschlüssel und dienstspezifische Bedingungsschlüssel. Eine Übersicht aller AWS globalen Bedingungsschlüssel finden Sie unter Kontextschlüssel für AWS globale Bedingungen im IAM-Benutzerhandbuch.
Amazon ECR definiert seinen eigenen Satz von Konditionsschlüsseln und unterstützt auch die Verwendung einiger globaler Konditionsschlüssel. Eine Übersicht aller AWS globalen Bedingungsschlüssel finden Sie unter AWS Globale Bedingungskontextschlüssel im IAM-Benutzerhandbuch.
Die meisten Amazon ECR-Aktionen unterstützen dieaws:ResourceTag
und ecr:ResourceTag
Bedingungsschlüssel. Weitere Informationen finden Sie unter Verwenden Tag-basierter Zugriffskontrolle.
Eine Liste der Amazon-ECR-Bedingungsschlüssel finden Sie unter Condition Keys Defined by Amazon Elastic Container Registry im IAM-Benutzerhandbuch. Um zu erfahren, mit welchen Aktionen und Ressourcen Sie einen Bedingungsschlüssel verwenden können, siehe Actions Defined by Amazon Elastic Container Registry.
Beispiele
Beispiele für identitätsbasierte Amazon ECR-Richtlinien finden Sie unterBeispiele für identitätsbasierte Amazon Elastic Container Service-Richtlinien .
Ressourcenbasierte Amazon-ECR-Richtlinien
Ressourcenbasierte Richtlinien sind JSON-Richtliniendokumente, die angeben, welche Aktionen ein bestimmter Auftraggeber auf einer Amazon ECR-Ressource durchführen kann und unter welchen Bedingungen. Amazon ECR unterstützt ressourcenbasierte Berechtigungsrichtlinien für Amazon ECR-Repositories. Ressourcenbasierte Richtlinien ermöglichen die Erteilung von Nutzungsberechtigungen für andere -Konten pro Ressource. Sie können auch eine ressourcenbasierte Richtlinie verwenden, AWS um einem Dienst den Zugriff auf Ihre Amazon ECR-Repositories zu ermöglichen.
Um kontoübergreifenden Zugriff zu ermöglichen, können Sie ein gesamtes Konto oder IAM-Entitäten in einem anderen Konto als Prinzipal in einer ressourcenbasierten Richtlinie angeben. Durch das Hinzufügen eines kontoübergreifenden Auftraggebers zu einer ressourcenbasierten Richtlinie ist nur die halbe Vertrauensbeziehung eingerichtet. Wenn sich der Principal und die Ressource in unterschiedlichen AWS Konten befinden, müssen Sie der Prinzipalentität auch die Erlaubnis erteilen, auf die Ressource zuzugreifen. Sie erteilen Berechtigungen, indem Sie der Entität eine identitätsbasierte Richtlinie anfügen. Wenn jedoch eine ressourcenbasierte Richtlinie Zugriff auf einen Prinzipal in demselben Konto gewährt, benötigen Sie in der identitätsbasierten Richtlinie keine zusätzlichen Amazon ECR-Repository-Berechtigungen. Weitere Informationen finden Sie unter Wie sich IAM-Rollen von ressourcenbasierten Richtlinien unterscheiden im IAM-Benutzerhandbuch.
Der Amazon ECR-Service unterstützt nur einen Typ von ressourcenbasierten Richtlinien, die sogenannte Repository Policy, die an ein Repository angehängt wird. Diese Richtlinie definiert, welche Prinzipal-Entitäten (Konten, Benutzer, Rollen und verbundene Benutzer) Aktionen auf dem Container durchführen können. Weitere Informationen zum Anfügen einer ressourcenbasierten Richtlinie an ein Repository finden Sie unter Richtlinien für private Repositorys in Amazon ECR.
Anmerkung
In einer Amazon ECR-Repository-Richtlinie unterstützt das Richtlinienelement Sid
zusätzliche Zeichen und Entfernungen, die in IAM-Richtlinien nicht unterstützt werden.
Beispiele
Beispiele für ressourcenbasierte Amazon ECR-Richtlinien finden Sie unter Beispiele für Richtlinien für private Repositorien in Amazon ECR,
Autorisierung basierend auf Amazon ECR-Tags
Sie können Tags an Amazon ECR-Ressourcen anhängen oder Tags in einer Anfrage an Amazon ECR übergeben. Um den Zugriff auf der Grundlage von Tags zu steuern, geben Sie im Bedingungselement einer Richtlinie Tag-Informationen an, indem Sie die Schlüssel ecr:ResourceTag/
, key-name
aws:RequestTag/
, oder key-name
aws:TagKeys
Bedingung verwenden. Weitere Informationen zum Taggen von Amazon ECR-Ressourcen finden Sie unter Kennzeichnen eines privaten Repositorys in Amazon ECR.
Ein Beispiel für eine identitätsbasierte Richtlinie zur Einschränkung des Zugriffs auf eine Ressource auf der Grundlage der Markierungen dieser Ressource finden Sie unter Verwenden Tag-basierter Zugriffskontrolle.
Amazon ECR IAM-Rollen
Eine IAM-Rolle ist eine Entität innerhalb Ihres AWS Kontos, die über bestimmte Berechtigungen verfügt.
Verwendung temporärer Anmeldeinformationen mit Amazon ECR
Sie können temporäre Anmeldeinformationen verwenden, um sich über einen Verbund anzumelden, eine IAM-Rolle anzunehmen oder eine kontenübergreifende Rolle anzunehmen. Sie erhalten temporäre Sicherheitsanmeldedaten, indem Sie AWS STS API-Operationen wie AssumeRoleoder GetFederationTokenaufrufen.
Amazon ECR unterstützt die Verwendung temporärer Anmeldeinformationen.
Service-verknüpfte Rollen
Mit dienstbezogenen Rollen können AWS Dienste auf Ressourcen in anderen Diensten zugreifen, um eine Aktion in Ihrem Namen auszuführen. Serviceverknüpfte Rollen werden in Ihrem IAM-Konto angezeigt und gehören zum Service. Ein IAM-Administrator kann die Berechtigungen für serviceverknüpfte Rollen anzeigen, aber nicht bearbeiten.
Amazon ECR unterstützt Service-verknüpfte Rollen. Weitere Informationen finden Sie unter Verwendung von dienstgebundenen Rollen für Amazon ECR.