Definizione delle autorizzazioni della funzione Lambda con un ruolo di esecuzione

Il ruolo di esecuzione di una funzione Lambda è un ruolo AWS Identity and Access Management (IAM) che concede alla funzione l'autorizzazione per accedere ai Servizi AWS e alle risorse. Ad esempio, puoi creare un ruolo di esecuzione che ha l'autorizzazione per inviare i log ad Amazon CloudWatch e caricare i dati di traccia su AWS X-Ray. Questa pagina fornisce informazioni su come creare, visualizzare e gestire il ruolo di esecuzione di una funzione Lambda.

Lambda assume automaticamente il tuo ruolo di esecuzione quando richiami la tua funzione. Dovresti evitare di chiamare sts:AssumeRole manualmente per assumere il ruolo di esecuzione nel codice della funzione. Se il tuo caso d'uso richiede che il ruolo venga assunto autonomamente, dovrai includere il ruolo stesso come principale attendibile nella policy di attendibilità del ruolo. Per ulteriori informazioni su come modificare una policy di attendibilità del ruolo, consulta Modifica di una policy di attendibilità del ruolo (console) nella Guida per l'utente di IAM.

Affinché Lambda possa assumere correttamente il ruolo di esecuzione, la policy di attendibilità del ruolo deve specificare il principale del servizio Lambda (lambda.amazonaws.com) come servizio attendibile.

Creazione di un ruolo di esecuzione nella console di IAM

Per impostazione predefinita, Lambda crea un ruolo di esecuzione con autorizzazioni minime quando si crea una funzione nella console Lambda. In particolare, questo ruolo di esecuzione include la policy gestita da AWSLambdaBasicExecutionRole, che fornisce alla funzione le autorizzazioni di base per registrare gli eventi su Amazon CloudWatch Logs.

Per eseguire attività più significative, le funzioni in genere richiedono autorizzazioni aggiuntive. Ad esempio, è possibile che tu disponga di una funzione Lambda che risponde a un evento aggiornando le voci in un database Amazon DynamoDB. È possibile creare un ruolo di esecuzione con le autorizzazioni necessarie utilizzando la console IAM.

Per istruzioni dettagliate, consulta la sezione Creazione di un ruolo per un servizio AWS (console) nella Guida per l'utente di IAM.

Dopo aver creato il ruolo di esecuzione, collegalo alla funzione. Quando si crea una funzione nella console Lambda, potrai collegare alla funzione qualsiasi ruolo di esecuzione creato in precedenza. Se desideri associare un nuovo ruolo di esecuzione a una funzione esistente, segui i passaggi indicati in Aggiornamento del ruolo di esecuzione di una funzione.

Creazione e gestione di ruoli con la AWS CLI

Per creare un ruolo di esecuzione con AWS Command Line Interface (AWS CLI), utilizzare il comando create-role. Quando utilizzi questo comando, puoi specificare la policy di attendibilità in linea. La policy di attendibilità di un ruolo garantisce ai principali specificati l'autorizzazione per assumere tale ruolo. Nell'esempio seguente concedi al principale del servizio Lambda l'autorizzazione per assumere il ruolo. I requisiti per l'escape delle virgolette nella stringa JSON variano in base alla shell.

aws iam create-role \
  --role-name lambda-ex \
  --assume-role-policy-document '{"Version": "2012-10-17",		 	 	 "Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'

Puoi inoltre definire la policy di attendibilità per il ruolo utilizzando un file JSON separato. Nell'esempio seguente, trust-policy.json è un file che si trova nella directory attuale.

aws iam create-role \
  --role-name lambda-ex \
  --assume-role-policy-document file://trust-policy.json

Utilizza il comando attach-policy-to-role per aggiungere le autorizzazioni al ruolo. Il seguente comando aggiunge la policy gestita da AWSLambdaBasicExecutionRole al ruolo di esecuzione lambda-ex.

aws iam attach-role-policy --role-name lambda-ex --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

Dopo aver creato il ruolo di esecuzione, collegalo alla funzione. Quando si crea una funzione nella console Lambda, potrai collegare alla funzione qualsiasi ruolo di esecuzione creato in precedenza. Se desideri associare un nuovo ruolo di esecuzione a una funzione esistente, segui i passaggi indicati in Aggiornamento del ruolo di esecuzione di una funzione.

Garantisci l'accesso minimo ai privilegi per il tuo ruolo di esecuzione Lambda

Quando si crea per la prima volta un ruolo IAM per la funzione Lambda durante la fase di sviluppo, a volte è possibile concedere altre autorizzazioni oltre a quanto richiesto. Prima di pubblicare la funzione nell'ambiente di produzione, una best practice consiste nel modificare la policy in modo da includere solo le autorizzazioni richieste. Per ulteriori informazioni, consulta Applicazione delle autorizzazioni del privilegio minimo nella Guida per l'utente di IAM.

Utilizzare IAM Access Analyzer per identificare le autorizzazioni necessarie per la policy del ruolo di esecuzione IAM. IAM Access Analyzer esamina i log AWS CloudTrail relativo all'intervallo di date specificato e genera un modello di policy con solo le autorizzazioni utilizzate dalla funzione durante tale periodo. È possibile utilizzare il modello per creare una policy gestita con autorizzazioni granulari e quindi collegarla al ruolo IAM. In questo modo, si concedono solo le autorizzazioni necessarie al ruolo per interagire con le risorse AWS per il caso d'uso specifico.

Per ulteriori informazioni, consulta Generazione di policy basate sull'attività di accesso nella Guida per l'utente di IAM.