Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo del plugin TIP per accedere Servizi AWS
La propagazione affidabile dell'identità (TIP) è una funzionalità Centro identità AWS IAM che consente agli amministratori di concedere autorizzazioni Servizi AWS in base agli attributi dell'utente, come le associazioni di gruppo. Con la propagazione affidabile delle identità, il contesto dell'identità viene aggiunto a un ruolo IAM per identificare l'utente che richiede l'accesso alle risorse. AWS Questo contesto viene propagato ad altri. Servizi AWS
Il contesto di identità comprende informazioni che vengono Servizi AWS utilizzate per prendere decisioni di autorizzazione quando ricevono richieste di accesso. Queste informazioni includono i metadati che identificano il richiedente (ad esempio, un utente IAM Identity Center), i dati Servizio AWS a cui viene richiesto l'accesso (ad esempio, Amazon Redshift) e l'ambito dell'accesso (ad esempio, accesso in sola lettura). Il destinatario Servizio AWS utilizza questo contesto e tutte le autorizzazioni assegnate all'utente per autorizzare l'accesso alle proprie risorse. Per ulteriori informazioni, vedere la panoramica sulla propagazione delle identità attendibili nella Guida per l' Centro identità AWS IAM utente.
Il plug-in TIP può essere utilizzato con Servizi AWS questo supporto per la propagazione affidabile delle identità. Come caso d'uso di riferimento, consulta Configurazione di un'applicazione Amazon Q Business utilizzando Centro identità AWS IAM nella Amazon Q Business User Guide.
Nota
Se utilizzi Amazon Q Business, consulta Configurazione di un'applicazione Amazon Q Business utilizzando Centro identità AWS IAM per istruzioni specifiche sul servizio.
Prerequisiti per l'utilizzo del plugin TIP
Per il funzionamento del plugin sono necessarie le seguenti risorse:
-
È necessario utilizzare il AWS SDK per Java o il AWS SDK per JavaScript.
-
Verifica che il servizio che stai utilizzando supporti la propagazione delle identità attendibili.
Consulta la colonna Abilita la propagazione delle identità affidabili tramite IAM Identity Center della tabella Applicazioni AWS gestite che si integrano con IAM Identity Center nella Guida per l'Centro identità AWS IAM utente.
-
Abilita IAM Identity Center e la propagazione affidabile delle identità.
Consulta i prerequisiti e le considerazioni TIP nella Guida per l'Centro identità AWS IAM utente.
-
È necessario disporre di un' Identity-Center-integrated applicazione.
Vedi le applicazioni AWS gestite o le applicazioni gestite dal cliente nella Guida Centro identità AWS IAM per l'utente.
-
Devi configurare un Trusted Token Issuer (TTI) e connettere il tuo servizio a IAM Identity Center.
Vedi Prerequisiti per emittenti di token affidabili e Attività per la configurazione di un emittente di token affidabile nella Guida per l'utente. Centro identità AWS IAM
Per utilizzare il plug-in TIP nel codice
-
Crea un'istanza del plug-in di propagazione dell'identità affidabile.
-
Crea un'istanza del client di servizio per interagire con il tuo client di servizio Servizio AWS e personalizza il client di servizio aggiungendo il plug-in di propagazione dell'identità affidabile.
Il plugin TIP accetta i seguenti parametri di input:
-
webTokenProvider: una funzione che il cliente implementa per ottenere un token OpenID dal proprio provider di identità esterno. -
accessRoleArn: l'ARN del ruolo IAM che deve essere assunto dal plug-in con il contesto di identità dell'utente per ottenere le credenziali con identità migliorata. -
applicationArn: la stringa identificativa univoca per il client o l'applicazione. Questo valore è un ARN dell'applicazione con autorizzazioni OAuth configurate. -
ssoOidcClient: (Facoltativo) Un client OIDC SSO, ad esempioSsoOidcClientper Java o per, con configurazioni definite dal cliente. client-sso-oidcJavaScript Se non viene fornito, verrà istanziato e utilizzato un client OIDC che utilizzaapplicationRoleArn. -
stsClient: (Facoltativo) Un AWS STS client con configurazioni definite dal cliente, utilizzato per assumere il contesto dell'identità dell'utente.accessRoleArnSe non viene fornito,applicationRoleArnverrà istanziato e utilizzato un AWS STS client che utilizza. -
applicationRoleArn: (Facoltativo) L'ARN del ruolo IAM da assumere inAssumeRoleWithWebIdentitymodo che l'OIDC e AWS STS i client possano essere avviati.-
Se non viene fornito, devono essere forniti entrambi
ssoOidcClientistsClientparametri. -
Se fornito, non
applicationRoleArnpuò avere lo stesso valore delaccessRoleArnparametro.applicationRoleArnviene utilizzato per creare STSClient, che viene utilizzato per assumere AccessRole. Se si utilizza lo stesso ruolo per entrambi iapplicationRoleruoliaccessRole, significherebbe utilizzare un ruolo che si assuma se stesso (presupposto del ruolo personale), il che è sconsigliato. AWS Vedi l'annuncio per maggiori dettagli.
-
Considerazioni sui parametri sso OidcClient, STSClient e applicativi RoleArn
Quando configuri il plug-in TIP, considera i seguenti requisiti di autorizzazione in base ai parametri forniti:
-
Se stai fornendo
ssoOidcClientestsClient:-
Le credenziali su
ssoOidcClientdevono essereoauth:CreateTokenWithIAMautorizzate a chiamare il centro di identità per ottenere il contesto utente specifico del centro di identità. -
Le credenziali
stsClientdevono essere attivatests:AssumeRolee lests:SetContextautorizzazioni attivate.accessRoleaccessRoledeve inoltre essere configurato con una relazione di fiducia con le credenziali attive.stsClient
-
-
Se stai fornendo
applicationRoleArn:-
applicationRoledovrebbe avere leoauth:CreateTokenWithIAMsts:SetContextautorizzazionists:AssumeRolee sulle risorse richieste (istanza iDCaccessRole), poiché verrà utilizzato per creare client OIDC e STS. -
applicationRoledovrebbe avere una relazione di fiducia con il provider di identità utilizzato per generare ilwebToken, in quantowebTokenverrà utilizzato per assumere l'ApplicationRole tramite la chiamata del plug-in. AssumeRoleWithWebIdentity
-
Esempio ApplicationRole di configurazione:
Politica di fiducia con il fornitore di token Web:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Federated": "arn:aws:iam::111122223333:oidc-provider/IDENTITY_PROVIDER_URL" }, "Action": "sts:AssumeRoleWithWebIdentity", "Condition": { "StringEquals": { "IDENTITY_PROVIDER_URL:aud": "CLIENT_ID_TO_BE_TRUSTED" } } } ] }
Politica di autorizzazione:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sts:AssumeRole", "sts:SetContext" ], "Resource": [ "arn:aws:iam::111122223333:role/accessRole" ] }, { "Effect": "Allow", "Action": [ "sso-oauth:CreateTokenWithIAM" ], "Resource": [ "*" ] } ] }
Esempi di codice che utilizzano TIP
Gli esempi seguenti mostrano come implementare il plug-in TIP nel codice utilizzando AWS SDK per Java o il AWS SDK per JavaScript.