View a markdown version of this page

Centro identità AWS IAM autenticazione per OpenSearch UI - Amazon OpenSearch Servizio

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à.

Centro identità AWS IAM autenticazione per OpenSearch UI

Con Centro identità AWS IAM, il tuo team ottiene un'esperienza di single sign-on basata su browser. I tuoi utenti accedono con il loro Centro identità AWS IAM credenziali anziché generare URL prefirmati.

Prerequisiti

  • Un AWS conto sia con la base che con Centro identità AWS IAM autorizzazioni IAM. Per ulteriori informazioni sulle autorizzazioni richieste, consulta Riferimento alla politica IAM per OpenSearch UI.

  • Centro identità AWS IAM abilitato nel tuo account o nella tua organizzazione. Nota se disponi di un'istanza dell'organizzazione o di un'istanza dell'account, poiché ciò influisce su alcuni passaggi di configurazione.

  • Un ruolo IAM con sia la politica di autorizzazioni richiesta che una politica di fiducia. Questo ruolo viene creato in Passaggio 2: creare il ruolo IAM.

  • Almeno una OpenSearch raccolta di domini o serverless in AWS Regione.

  • Almeno un utente o gruppo creato in Centro identità AWS IAM.

Prerequisito aggiuntivo per un'istanza dell'organizzazione che utilizza una chiave gestita dal cliente

Se l'istanza della tua organizzazione è Centro identità AWS IAM utilizza una chiave gestita dal cliente per la crittografia a riposo, è necessario concedere OpenSearch Autorizzazione dell'interfaccia utente per decrittografare i dati di identità con quella chiave. Senza questa autorizzazione, il Single Sign-on non riesce con AccessDeniedException mentre OpenSearch L'interfaccia utente convalida il codice di autorizzazione.

Per verificare se la tua istanza utilizza una chiave gestita dal cliente, apri il Centro identità AWS IAM console, scegli Impostazioni, scegli Direzione scheda e revisione Chiave per crittografare i dati di IAM Identity Center inattivi. Se mostra un ARN chiave gestito dal cliente anziché un AWS chiave posseduta, aggiungi le seguenti dichiarazioni alla politica chiave nell'account di gestione dove Centro identità AWS IAM è abilitato. Sostituisci organization-id con il tuo AWS ID dell'organizzazione, nel formato o-xxxxxxxxxx.

{ "Sid": "Allow_AWS_app_admins_in_the_same_AWS_organization_to_use_the_KMS_key", "Effect": "Allow", "Principal": "*", "Action": [ "kms:Decrypt" ], "Resource": "*", "Condition": { "StringEquals": { "aws:PrincipalOrgID": "{{organization-id}}" }, "StringLike": { "kms:ViaService": [ "sso.*.amazonaws.com", "identitystore.*.amazonaws.com" ] } } }, { "Sid": "Allow_managed_apps_to_use_the_KMS_Key", "Effect": "Allow", "Principal": "*", "Action": [ "kms:Decrypt" ], "Resource": "*", "Condition": { "Bool": { "aws:PrincipalIsAWSService": "true" }, "StringLike": { "kms:ViaService": [ "sso.*.amazonaws.com", "identitystore.*.amazonaws.com" ] }, "StringEquals": { "aws:SourceOrgID": "{{organization-id}}" } } }

Per ulteriori informazioni, vedere Chiavi gestite dal cliente nel Centro identità AWS IAM Guida per l'utente.

Fase 1: Verificare che Centro identità AWS IAM è abilitato

Per verificarlo Centro identità AWS IAM è abilitato
  1. Apri la AWS console Centro identità IAM.

  2. Se la console mostra una dashboard con i dettagli della tua istanza, Centro identità AWS IAM è abilitato. Nota se l'istanza è un'istanza dell'organizzazione o un'istanza dell'account.

  3. Se la console mostra una pagina di configurazione, abilita Centro identità AWS IAM prima di continuare.

Un'istanza dell'organizzazione funziona su tutti gli account del tuo AWS Organizzazione ed è consigliata per l'uso in produzione. Un'istanza di account è limitata a un singolo account, adatto a test e configurazioni isolate. Se il tuo account appartiene a un'organizzazione gestita da qualcun altro, chiedi al tuo amministratore se Centro identità AWS IAM deve essere abilitato a livello di organizzazione.

Passaggio 2: creare il ruolo IAM

Centro identità AWS IAM assume un ruolo IAM quando gli utenti accedono al tuo OpenSearch applicazione UI. Tale ruolo richiede una politica di autorizzazioni, che definisce cosa può fare il ruolo, e una politica di fiducia, che definisce chi può assumere il ruolo.

Utilizza la seguente politica di autorizzazioni. Sostituisci i valori segnaposto con le tue informazioni.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*" } ] }

Utilizza la seguente politica di fiducia, che consente Centro identità AWS IAM per assumere il ruolo:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sso.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Per creare il ruolo e allegare la politica delle autorizzazioni al AWS CLI, esegui i seguenti comandi:

aws iam create-role \ --role-name OpenSearchUI-IDC-Role \ --assume-role-policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Principal":{"Service":"sso.amazonaws.com"}, "Action":"sts:AssumeRole" }] }' aws iam put-role-policy \ --role-name OpenSearchUI-IDC-Role \ --policy-name OpenSearchAppAccess \ --policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Action":"opensearch:ApplicationAccessAll", "Resource":"arn:aws:opensearch:{{region}}:{{account-id}}:application/*" }] }'

Nota l'ARN del ruolo . Lo specifichi nel passaggio successivo. L'ARN ha il formato arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role.

Fase 3: Creare l'applicazione con Centro identità AWS IAM abilitato

Per iniziare a creare l'applicazione
  1. Aprire il Amazon OpenSearch Console di servizio.

  2. Nel menu di navigazione, scegli OpenSearch Interfaccia utente (dashboard).

  3. Scegli Crea applicazione.

  4. Immetti un nome per l'applicazione.

  5. Aggiungere almeno una fonte di dati, una OpenSearch dominio o una raccolta serverless.

Continua nello stesso modulo per attivare il Single Sign-on e completare la creazione dell'applicazione.

Per abilitare Centro identità AWS IAM e creare l'applicazione
  1. Seleziona il Autenticazione con IAM Identity Center casella di controllo.

  2. Seleziona il ruolo IAM in cui hai creato Passaggio 2: creare il ruolo IAM.

  3. (Facoltativo) Configurare gli amministratori del dashboard.

  4. Scegli Crea.

Per creare la stessa applicazione con AWS CLI, esegui il seguente comando. Sostituisci i valori segnaposto con le tue informazioni.

aws opensearch create-application \ --name "{{application-name}}" \ --iam-identity-center-options '{ "enabled": true, "iamRoleForIdentityCenterApplicationArn": "arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role" }' \ --data-sources '[{ "dataSourceArn": "arn:aws:es:{{region}}:{{account-id}}:domain/{{domain-name}}" }]' \ --region {{region}}

Fase 4: Assegna gli utenti a Centro identità AWS IAM

Per assegnare utenti o gruppi all'applicazione
  1. Apri la AWS console Centro identità IAM.

  2. Nel menu di navigazione, scegli Applicazioni.

  3. Scegli l'applicazione che OpenSearch Mi sono registrato automaticamente. Il suo nome corrisponde al tuo OpenSearch Nome dell'applicazione UI.

  4. Seleziona Assegna utenti e gruppi.

  5. Seleziona gli utenti o i gruppi a cui è necessario accedere, quindi scegli Assegna.

Fase 5: Verificare la configurazione

Per verificare la configurazione
  1. In Amazon OpenSearch Console di servizio, conferma che lo stato dell'applicazione è Attivo, che indica che l'applicazione è pronta per l'uso.

  2. Conferma che Autenticazione con IAM Identity Center è abilitata nella pagina dei dettagli dell'applicazione.

  3. Copia l'URL dell'applicazione dalla pagina dei dettagli dell'applicazione.

  4. Apri l'URL dell'applicazione in un browser. Verrai reindirizzato al Centro identità AWS IAM pagina di accesso.

  5. Accedi con il tuo Centro identità AWS IAM credenziali. Le OpenSearch Viene visualizzato il selettore dell'area di lavoro dell'interfaccia utente.

Gestione di utenti e gruppi a livello di codice

Quando si crea un OpenSearch Applicazione UI con Centro identità AWS IAM abilitato, OpenSearch L'interfaccia utente registra un Centro identità AWS IAM applicazione. È necessario assegnare gli utenti a tale applicazione prima che possano accedere. Esistono due livelli di accesso separati:

Assegnazione della domanda

Controlla chi può accedere a OpenSearch UI. Lo gestisci con sso-admin comandi.

Amministratore dell'applicazione

Controlla chi può modificare o eliminare l'applicazione e gestirne gli spazi di lavoro. Lo gestisci con aws opensearch update-application. Per ulteriori informazioni sugli amministratori delle applicazioni, vedere Gestione degli amministratori delle applicazioni.

Sono necessari tre identificatori prima di gestire le assegnazioni.

Identificatore Come ottenerlo
Il Centro identità AWS IAM applicazione ARN aws opensearch get-application, nel iamIdentityCenterOptions.iamIdentityCenterApplicationArn
L'ID dell'archivio di identità aws sso-admin list-instances, nel Instances[0].IdentityStoreId
L'ID dell'utente o del gruppo aws identitystore list-users o aws identitystore list-groups

I comandi seguenti consentono di trovare un utente in base al nome utente e un gruppo in base al nome visualizzato. Sostituisci il placeholder values con le tue informazioni:

aws identitystore list-users \ --identity-store-id {{identity-store-id}} \ --filters '[{"AttributePath":"UserName","AttributeValue":"{{user-name}}"}]' \ --region {{region}} \ --query 'Users[0].UserId' --output text aws identitystore list-groups \ --identity-store-id {{identity-store-id}} \ --filters '[{"AttributePath":"DisplayName","AttributeValue":"{{group-name}}"}]' \ --region {{region}} \ --query 'Groups[0].GroupId' --output text

I comandi seguenti assegnano un utente o un gruppo all'applicazione e controllano o rimuovono le assegnazioni. Per un gruppo, imposta --principal-type a GROUP e usa l'ID del gruppo che hai trovato in precedenza come ID principale:

aws sso-admin create-application-assignment \ --application-arn {{identity-center-application-arn}} \ --principal-id {{principal-id}} \ --principal-type USER \ --region {{region}} aws sso-admin list-application-assignments \ --application-arn {{identity-center-application-arn}} \ --region {{region}} aws sso-admin delete-application-assignment \ --application-arn {{identity-center-application-arn}} \ --principal-id {{principal-id}} \ --principal-type USER \ --region {{region}}

Se un utente o un gruppo non esiste ancora nel tuo archivio di identità, crealo con aws identitystore create-user o aws identitystore create-groupe aggiungi membri con aws identitystore create-group-membership.

Il seguente esempio di codice Python cerca un utente in base al nome utente e lo assegna all'applicazione con AWS SDK per Python (Boto3):

import boto3 region = "{{region}}" app_id = "{{application-id}}" opensearch = boto3.client("opensearch", region_name=region) sso_admin = boto3.client("sso-admin", region_name=region) identity_store = boto3.client("identitystore", region_name=region) app = opensearch.get_application(id=app_id) idc_app_arn = app["iamIdentityCenterOptions"]["iamIdentityCenterApplicationArn"] identity_store_id = sso_admin.list_instances()["Instances"][0]["IdentityStoreId"] users = identity_store.list_users( IdentityStoreId=identity_store_id, Filters=[{"AttributePath": "UserName", "AttributeValue": "{{user-name}}"}], ) user_id = users["Users"][0]["UserId"] sso_admin.create_application_assignment( ApplicationArn=idc_app_arn, PrincipalId=user_id, PrincipalType="USER", )

Risoluzione dei problemi Centro identità AWS IAM autenticazione

Centro identità AWS IAM i problemi di autenticazione di solito derivano da una politica di fiducia che omette sso.amazonaws.com, una politica di autorizzazioni in cui mancano le azioni richieste o un utente non assegnato all'applicazione. La tabella seguente elenca i sintomi più comuni, le loro cause probabili e come risolverli.

Caratteristiche Causa probabile Risoluzione
Un messaggio che Centro identità AWS IAM non è abilitato viene visualizzato durante la creazione dell'applicazione Non è presente alcuna istanza nel tuo account o nella tua organizzazione Abilita Centro identità AWS IAM nel Centro identità AWS IAM plancia
Il servizio Single Sign-on reindirizza ma restituisce un errore La politica di fiducia dei ruoli non include sso.amazonaws.com Aggiorna la politica di fiducia come descritto in Passaggio 2: creare il ruolo IAM
Sign-in ha esito positivo ma l'utente non ha accesso L'utente non è assegnato all'applicazione Assegna l'utente in Centro identità AWS IAM console, come descritto in Fase 4: Assegna gli utenti a Centro identità AWS IAM
L'accesso viene negato dopo l'accesso Nella politica delle autorizzazioni dei ruoli mancano le azioni richieste Conferma che il ruolo ha opensearch:ApplicationAccessAll e il permesso di accedere alle fonti di dati
L'applicazione mostra Centro identità AWS IAM è abilitato, ma l'accesso non riesce Il ruolo ARN non corrisponde Verifica che il ruolo ARN nelle impostazioni dell'applicazione sia il ruolo con le politiche di attendibilità e autorizzazioni corrette
L'applicazione non può essere creata con Centro identità AWS IAM Centro identità AWS IAM mancano le autorizzazioni Conferma che il tuo responsabile IAM ha sso:CreateApplication, sso:PutApplicationGrant, e iam:PassRole
Viene visualizzata la pagina di accesso ma nessun utente può accedere Non viene assegnato alcun utente Centro identità AWS IAM Assegna utenti all'applicazione in Centro identità AWS IAM plancia
Sign-in fallisce con un messaggio che indica che il codice di autorizzazione non può essere convalidato o con AccessDeniedException Centro identità AWS IAM utilizza una chiave gestita dal cliente senza la policy chiave richiesta Aggiungere le dichiarazioni politiche chiave descritte in precedenza in questo argomento
Un utente non può accedere subito dopo essere stato assegnato L'assegnazione non è stata ancora propagata Attendi uno o due minuti, quindi riprova
AccessDeniedException - create-application-assignment Il sso:CreateApplicationAssignment manca il permesso Aggiungere il Centro identità AWS IAM autorizzazioni elencate in Riferimento alla politica IAM per OpenSearch UI
ConflictException su un incarico L'utente o il gruppo è già assegnato Conferma con list-application-assignments