Come funziona Amazon Elastic Container Registry con IAM

Prima di utilizzare IAM per gestire l'accesso ad Amazon ECR, è necessario comprendere quali funzioni IAM sono disponibili per l'uso con Amazon ECR. Per avere una visione di alto livello di come Amazon ECR e altri AWS servizi funzionano con IAM, consulta AWS Services That Work with IAM nella IAM User Guide.

Policy basate su Identità Amazon ECR

Con le policy basate su identità di IAM, è possibile specificare quali azioni e risorse sono consentite o rifiutate, nonché le condizioni in base alle quali le azioni sono consentite o rifiutate. Amazon ECR supporta specifiche operazioni, risorse e chiavi di condizione. Per informazioni su tutti gli elementi utilizzati in una policy JSON, consulta Documentazione di riferimento degli elementi delle policy JSON IAM nella Guida per l'utente IAM.

Azioni

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

L'elemento Action di una policy JSON descrive le azioni che è possibile utilizzare per consentire o negare l'accesso a un criterio. Le azioni politiche in genere hanno lo stesso nome dell'operazione AWS API associata. Ci sono alcune eccezioni, ad esempio le azioni di sola autorizzazione che non hanno un'operazione API corrispondente. 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 operazioni delle policy in Amazon ECR utilizzano il seguente prefisso prima dell'operazione: ecr:. Ad esempio, per concedere a qualcuno l'autorizzazione per creare un repository ECR mediante l'operazione API CreateRepository Amazon ECR, includi l'operazione ecr:CreateRepository nella policy. Le istruzioni della policy devono includere un elemento Action o NotAction. Amazon ECR definisce un proprio set di operazioni che descrivono le attività che puoi eseguire con quel 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 operazioni Amazon ECR, consulta Operazioni, risorse e chiavi di condizione per Amazon Elastic Container Registry nella Guida per l'utente di IAM.

Risorse

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

L'elemento JSON Resource della policy specifica l'oggetto o gli oggetti ai quali si applica l'azione. Le istruzioni devono includere un elemento Resource o un elemento NotResource. Come best practice, specifica una risorsa utilizzando il suo nome della risorsa Amazon (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": "*"

La risorsa del repository Amazon ECR dispone del seguente ARN:

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

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

Ad esempio, per specificare il repository my-repo nella regione us-east-1 nell'istruzione, utilizza il seguente 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 una singola istruzione, separa gli ARN con le virgole.

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

Per visualizzare un elenco dei tipi di risorse Amazon ECR e dei relativi ARN, consultare Risorse definite da Amazon Elastic Container Registry nella Guida per l'utente di IAM. Per informazioni sulle operazioni con cui è possibile specificare l'ARN di ogni risorsa, consultare Operazioni definite da Amazon Elastic Container Registry.

Chiavi di condizione

Gli amministratori possono utilizzare le policy AWS JSON 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 Condition in un'istruzione o più chiavi in un singolo elemento Condition, questi vengono valutati da AWS utilizzando un'operazione AND logica. Se si specificano più valori per una singola chiave di condizione, AWS valuta la condizione utilizzando un'operazione logica. OR 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, puoi autorizzare un utente IAM ad accedere a una risorsa solo se è stata taggata con il relativo nome utente IAM. Per ulteriori informazioni, consulta Elementi delle policy IAM: variabili e tag nella Guida per l'utente di IAM.

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'utente IAM.

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

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

Per visualizzare un elenco di chiavi di condizione Amazon ECR, consulta Chiave di condizione definita da Amazon Elastic Container Registry nella Guida per l'utente di IAM. 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 policy basate su identità Amazon ECR, consultare Esempi di policy basate su Identità di Amazon Elastic Container Registry.

Policy basate sulle risorse Amazon ECR

Le policy basate su risorse sono documenti di policy JSON che specificano le operazioni che possono essere eseguite da un'entità principale specificata su una risorsa Amazon ECR e in base a quali condizioni. Amazon ECR supporta policy di autorizzazione basate sulle risorse per i repository Amazon ECR. Le policy basate su risorse consentono di concedere l'autorizzazione all'utilizzo ad altri account per ogni risorsa. Puoi inoltre utilizzare una policy basata su risorse per consentire a un servizio AWS di accedere ai repository Amazon ECR.

Per consentire l'accesso a più account, è possibile specificare un intero account o entità IAM in un altro account come entità principale in una policy basata su 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 Differenza tra i ruoli IAM e le policy basate su risorse nella Guida per l'utente IAM.

Il servizio Amazon ECR supporta solo un tipo di policy basata su risorse detta policy di repository, che è collegata 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 Policy del repository privato.

Nota

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

Esempi

Per visualizzare esempi di policy basate su risorse Amazon ECR, consulta Esempi di policy di repository privati.

Autorizzazione basata sui tag Amazon ECR

Puoi collegare i tag alle risorse Amazon ECR o inoltrarli in una richiesta ad Amazon ECR. 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 sul tagging delle risorse di Amazon ECR, consultare Tagging di un repository privato.

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.

Ruoli IAM Amazon ECR

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

Utilizzo di credenziali temporanee con Amazon ECR

È possibile utilizzare credenziali temporanee per effettuare l'accesso con la federazione, assumere un ruolo IAM o un ruolo multi-account. Ottieni credenziali di sicurezza temporanee chiamando operazioni AWS STS API come AssumeRoleo. GetFederationToken

Amazon ECR supporta l'uso 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 conto dell'utente. I ruoli collegati ai servizi sono visualizzati nell'account IAM e sono di proprietà del servizio. Un amministratore IAM può visualizzare le autorizzazioni per i ruoli collegati ai servizi, ma non può modificarle.

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