

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
<a name="application-auth-idc-prerequisites"></a>
+ 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](application-iam-policy-reference.md).
+ 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](#application-auth-idc-role).
+ 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
<a name="application-auth-idc-cmk"></a>

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](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-customer-managed-keys.html) nel *Centro identità AWS IAM Guida per l'utente*.

## Fase 1: Verificare che Centro identità AWS IAM è abilitato
<a name="application-auth-idc-verify-enabled"></a>

**Per verificarlo Centro identità AWS IAM è abilitato**

1. Apri la [AWS console Centro identità IAM](https://console.aws.amazon.com/singlesignon/).

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

1. 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
<a name="application-auth-idc-role"></a>

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
<a name="application-auth-idc-create"></a>

**Per iniziare a creare l'applicazione**

1. Aprire il [Amazon OpenSearch Console di servizio](https://console.aws.amazon.com/aos/home).

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

1. Scegli **Crea applicazione**.

1. Immetti un nome per l'applicazione.

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

1. Seleziona il ruolo IAM in cui hai creato [Passaggio 2: creare il ruolo IAM](#application-auth-idc-role).

1. (Facoltativo) Configurare gli amministratori del dashboard.

1. 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
<a name="application-auth-idc-assign"></a>

**Per assegnare utenti o gruppi all'applicazione**

1. Apri la [AWS console Centro identità IAM](https://console.aws.amazon.com/singlesignon/).

1. Nel menu di navigazione, scegli **Applicazioni**.

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

1. Seleziona **Assegna utenti e gruppi**.

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

## Fase 5: Verificare la configurazione
<a name="application-auth-idc-verify"></a>

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

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

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

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

1. 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
<a name="application-auth-idc-assignments"></a>

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](application-getting-started.md#managing-application-administrators).

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-group`e 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
<a name="application-auth-idc-troubleshooting"></a>

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](#application-auth-idc-role) | 
| 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](#application-auth-idc-assign) | 
| 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](application-iam-policy-reference.md) | 
| ConflictException su un incarico | L'utente o il gruppo è già assegnato | Conferma con list-application-assignments | 