Come funziona Amazon Elastic Container Registry con IAM

Prima di utilizzare IAM per gestire l'accesso ad AmazonECR, è necessario comprendere quali IAM funzionalità sono disponibili per l'uso con AmazonECR. Per avere una panoramica generale del funzionamento di Amazon ECR e di altri AWS serviziIAM, consulta AWS Services That Work with IAM nella Guida per l'IAMutente.

ECRPolitiche basate sull'identità di Amazon

Con le politiche IAM basate sull'identità, puoi specificare azioni e risorse consentite o negate, nonché le condizioni in base alle quali le azioni sono consentite o negate. Amazon ECR supporta azioni, risorse e chiavi di condizione specifiche. Per conoscere tutti gli elementi utilizzati in una JSON policy, consulta IAMJSONPolicy Elements Reference nella Guida per l'IAMutente.

Azioni

Gli amministratori possono utilizzare AWS JSON le policy per specificare chi ha accesso a cosa. Cioè, quale principale può eseguire operazioni su quali risorse, e in quali condizioni.

L'Actionelemento di una JSON policy descrive le azioni che è possibile utilizzare per consentire o negare l'accesso a una policy. Le azioni politiche in genere hanno lo stesso nome dell' AWS APIoperazione associata. Esistono alcune eccezioni, come le azioni basate solo sulle autorizzazioni che non hanno un'operazione corrispondente. API Esistono anche alcune operazioni che richiedono più operazioni in una policy. Queste operazioni aggiuntive sono denominate operazioni dipendenti.

Includi le operazioni in una policy per concedere le autorizzazioni a eseguire l'operazione associata.

Le azioni politiche in Amazon ECR utilizzano il seguente prefisso prima dell'azione:ecr:. Ad esempio, per concedere a qualcuno l'autorizzazione a creare un ECR repository Amazon con l'ECRCreateRepositoryAPIoperazione Amazon, includi l'ecr:CreateRepositoryazione nella sua politica. Le istruzioni della policy devono includere un elemento Action o NotAction. Amazon ECR definisce il proprio set di azioni che descrivono le attività che puoi eseguire con questo servizio.

Per specificare più azioni in una sola istruzione, separa ciascuna di esse con una virgola come mostrato di seguito:

"Action": [
      "ecr:action1",
      "ecr:action2"

È possibile specificare più azioni tramite caratteri jolly (*). Ad esempio, per specificare tutte le azioni che iniziano con la parola Describe, includi la seguente azione:

"Action": "ecr:Describe*"

Per visualizzare un elenco di ECR azioni Amazon, consulta Actions, Resources and Condition Keys for Amazon Elastic Container Registry nella Guida per l'IAMutente.

Risorse

Gli amministratori possono utilizzare AWS JSON le policy per specificare chi ha accesso a cosa. Cioè, quale principale può eseguire operazioni su quali risorse, e in quali condizioni.

L'elemento Resource JSON policy specifica l'oggetto o gli oggetti a cui si applica l'azione. Le istruzioni devono includere un elemento Resourceo un elemento NotResource. Come best practice, specifica una risorsa utilizzando il relativo Amazon Resource Name (ARN). Puoi eseguire questa operazione per azioni che supportano un tipo di risorsa specifico, note come autorizzazioni a livello di risorsa.

Per le azioni che non supportano le autorizzazioni a livello di risorsa, ad esempio le operazioni di elenco, utilizza un carattere jolly (*) per indicare che l'istruzione si applica a tutte le risorse.

"Resource": "*"

Una risorsa del ECR repository Amazon ha quanto segue: ARN

arn:${Partition}:ecr:${Region}:${Account}:repository/${Repository-name}

Per ulteriori informazioni sul formato diARNs, consulta Amazon Resource Names (ARNs) e AWS Service Namespaces.

Ad esempio, per specificare il my-repo repository nella us-east-1 regione nella tua dichiarazione, utilizza quanto segue: ARN

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/my-repo"

Per specificare tutti i repository che appartengono a un account specifico, utilizza il carattere jolly (*):

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/*"

Per specificare più risorse in un'unica istruzione, separale ARNs con virgole.

"Resource": [
      "resource1",
      "resource2"

Per visualizzare un elenco dei tipi di ECR risorse Amazon e relativiARNs, consulta Resources Defined by Amazon Elastic Container Registry nella Guida per l'IAMutente. Per sapere con quali azioni è possibile specificare il tipo ARN di ciascuna risorsa, consulta Actions Defined by Amazon Elastic Container Registry.

Chiavi di condizione

Gli amministratori possono utilizzare AWS JSON le policy per specificare chi ha accesso a cosa. Cioè, quale principale può eseguire azioni su quali risorse, e in quali condizioni.

L'elemento Condition(o blocco Condition) consente di specificare le condizioni in cui un'istruzione è in vigore. L'elemento Conditionè facoltativo. Puoi compilare espressioni condizionali che utilizzano operatori di condizione, ad esempio uguale a o minore di, per soddisfare la condizione nella policy con i valori nella richiesta.

Se specifichi più elementi Conditionin un'istruzione o più chiavi in un singolo elemento Condition, questi vengono valutati da AWS utilizzando un'operazione ANDlogica. Se si specificano più valori per una singola chiave di condizione, AWS valuta la condizione utilizzando un'operazione logicaOR. Tutte le condizioni devono essere soddisfatte prima che le autorizzazioni dell'istruzione vengano concesse.

Puoi anche utilizzare variabili segnaposto quando specifichi le condizioni. Ad esempio, è possibile concedere a un IAM utente l'autorizzazione ad accedere a una risorsa solo se è contrassegnata con il suo nome IAM utente. Per ulteriori informazioni, consulta gli elementi IAM della politica: variabili e tag nella Guida IAM per l'utente.

AWS supporta chiavi di condizione globali e chiavi di condizione specifiche del servizio. Per visualizzare tutte le chiavi di condizione AWS globali, consulta le chiavi di contesto delle condizioni AWS globali nella Guida per l'IAMutente.

Amazon ECR definisce il proprio set di chiavi di condizione e supporta anche l'utilizzo di alcune chiavi di condizione globali. Per visualizzare tutte le chiavi di condizione AWS globali, consulta AWS Global Condition Context Keys nella Guida IAM per l'utente.

La maggior parte ECR delle azioni di Amazon supporta le chiavi aws:ResourceTag e ecr:ResourceTag condition. Per ulteriori informazioni, consulta Uso del controllo degli accessi basato su tag.

Per visualizzare un elenco di chiavi di ECR condizione di Amazon, consulta Condition Keys Defined by Amazon Elastic Container Registry nella Guida per l'IAMutente. Per informazioni su operazioni e risorse con cui è possibile utilizzare una chiave di condizione, consultare Operazioni definite da Amazon Elastic Container Registry.

Esempi

Per visualizzare esempi di politiche ECR basate sull'identità di Amazon, consulta. Esempi di policy basate su Identità di Amazon Elastic Container Registry

Politiche basate ECR sulle risorse di Amazon

Le politiche basate sulle risorse sono documenti di JSON policy che specificano quali azioni uno specifico committente può eseguire su una ECR risorsa Amazon e in quali condizioni. Amazon ECR supporta politiche di autorizzazione basate sulle risorse per gli archivi Amazon. ECR Le policy basate su risorse consentono di concedere l'autorizzazione all'utilizzo ad altri account per ogni risorsa. Puoi anche utilizzare una politica basata sulle risorse per consentire a un AWS servizio di accedere ai tuoi repository Amazon. ECR

Per abilitare l'accesso tra più account, puoi specificare un intero account o IAM entità in un altro account come principale in una politica basata sulle risorse. L'aggiunta di un principale multi-account a una policy basata sulle risorse rappresenta solo una parte della relazione di trust. Quando il principale e la risorsa si trovano in AWS account diversi, è inoltre necessario concedere all'entità principale l'autorizzazione ad accedere alla risorsa. Concedi l'autorizzazione collegando una policy basata sull'identità all'entità. Tuttavia, se una policy basata su risorse concede l'accesso a un'entità principale nello stesso account, non sono richieste ulteriori policy basate su identità. Per ulteriori informazioni, consulta In che modo IAM i ruoli differiscono dalle politiche basate sulle risorse nella Guida per l'IAMutente.

Il ECR servizio Amazon supporta solo un tipo di politica basata sulle risorse chiamata policy di repository, che è allegata a un repository. Questa policy definisce quali entità principali (account, utenti, ruoli e utenti federati) possono eseguire operazioni sul repository. Per informazioni su come collegare una policy basata su risorse a un repository, consulta Politiche di repository privato in Amazon ECR.

Nota

In una policy di ECR repository Amazon, l'elemento policy Sid supporta caratteri e spaziature aggiuntivi non supportati nelle IAM policy.

Esempi

Per visualizzare esempi di politiche ECR basate sulle risorse di Amazon, consulta, Esempi di policy relative agli archivi privati in Amazon ECR

Autorizzazione basata sui ECR tag Amazon

Puoi allegare tag alle ECR risorse Amazon o passare i tag in una richiesta ad AmazonECR. Per controllare l'accesso basato su tag, fornisci informazioni sui tag nell'elemento condizione di una policy utilizzando le chiavi di condizione ecr:ResourceTag/key-name, aws:RequestTag/key-name o aws:TagKeys. Per ulteriori informazioni sull'etichettatura ECR delle risorse Amazon, consultaTaggare un archivio privato in Amazon ECR.

Per visualizzare una policy basata sulle identità di esempio per limitare l'accesso a una risorsa basata su tag su tale risorsa, consulta Uso del controllo degli accessi basato su tag.

ECRIAMRuoli Amazon

Un IAMruolo è un'entità all'interno del tuo AWS account che dispone di autorizzazioni specifiche.

Utilizzo di credenziali temporanee con Amazon ECR

Puoi utilizzare credenziali temporanee per accedere con la federazione, assumere un IAM ruolo o assumere un ruolo tra account. È possibile ottenere credenziali di sicurezza temporanee chiamando AWS STS API operazioni come o. AssumeRoleGetFederationToken

Amazon ECR supporta l'utilizzo di credenziali temporanee.

Ruoli collegati ai servizi

I ruoli collegati ai AWS servizi consentono ai servizi di accedere alle risorse di altri servizi per completare un'azione per tuo conto. I ruoli collegati ai servizi vengono visualizzati nell'IAMaccount e sono di proprietà del servizio. Un IAM amministratore può visualizzare ma non modificare le autorizzazioni per i ruoli collegati al servizio.

Amazon ECR supporta ruoli collegati ai servizi. Per ulteriori informazioni, consulta Utilizzo di ruoli collegati ai servizi per Amazon ECR.