

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

# Autenticazione IAM per OpenSearch UI

Questo argomento illustra le autorizzazioni IAM minime richieste per accedere a un OpenSearch Applicazione UI che utilizza l'autenticazione IAM, senza Centro identità AWS IAM. Dopo aver completato questi passaggi, un ruolo IAM può accedere all'applicazione e interrogare le sue origini dati.

## Prerequisiti
<a name="application-auth-iam-prerequisites"></a>
+ Un OpenSearch Applicazione UI creata con l'autenticazione IAM. Per istruzioni sulla creazione di un'applicazione, consulta [Iniziare con OpenSearch interfaccia utente in Amazon OpenSearch Servizio](application-getting-started.md).
+ Un ruolo IAM che richiede l'accesso all'applicazione.
+ Il AWS CLI configurato con credenziali.

## Passaggio 1: concedere l'autorizzazione IAM
<a name="application-auth-iam-grant"></a>

La seguente politica IAM consente l'accesso all'interfaccia dell'applicazione. Collegala al ruolo IAM che richiede l'accesso e 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/{{application-id}}"
        }
    ]
}
```

L'assegnazione della risorsa a un singolo ID di applicazione garantisce il privilegio minimo di cui il ruolo ha bisogno. Per concedere invece l'accesso a tutte le applicazioni dell'account e della regione, utilizza una jolly:

```
"Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*"
```

Puoi allegare la stessa politica al AWS CLI:

```
aws iam put-role-policy \
    --role-name {{role-name}} \
    --policy-name OpenSearchAppAccess \
    --policy-document '{
      "Version":"2012-10-17",
      "Statement":[{
        "Effect":"Allow",
        "Action":"opensearch:ApplicationAccessAll",
        "Resource":"arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}"
      }]
    }'
```

**Nota**  
L'azione che concede l'accesso all'interfaccia dell'applicazione è `opensearch:ApplicationAccessAll`. Per ulteriori informazioni sulle autorizzazioni richieste da un'applicazione, vedere [Riferimento alla politica IAM per OpenSearch UI](application-iam-policy-reference.md).

Se gli utenti aprono l'applicazione anche da Console di gestione AWS, aggiungi la seguente dichiarazione, in modo che possano visualizzare l'applicazione nella console:

```
{
    "Effect": "Allow",
    "Action": "es:GetApplication",
    "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}"
}
```

## Passaggio 2: configura l'amministratore della dashboard
<a name="application-auth-iam-admin"></a>

Imposta quali responsabili IAM ricevono i privilegi di amministratore all'interno OpenSearch UI. Per concedere i privilegi di amministratore a tutti gli utenti autenticati, esegui il comando seguente:

```
aws opensearch update-application \
    --id {{application-id}} \
    --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"*"}]' \
    --region {{region}}
```

Per concedere i privilegi di amministratore a un singolo ruolo, specifica il ruolo ARN:

```
aws opensearch update-application \
    --id {{application-id}} \
    --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"arn:aws:iam::{{account-id}}:role/{{role-name}}"}]' \
    --region {{region}}
```

**Nota**  
L'impostazione dell'amministratore del dashboard controlla le funzionalità di amministratore all'interno dell'interfaccia, come la gestione dei modelli di indice e gli oggetti salvati. Non è necessario per accedere: la policy IAM nel passaggio 1 è sufficiente per accedere all'applicazione.

## Fase 3: verifica dell'accesso
<a name="application-auth-iam-verify"></a>

Puoi verificare l'accesso da un browser con un URL prefirmato o programmaticamente con le intestazioni di richiesta Signature Version 4.

### Verifica l'accesso da un browser
<a name="application-auth-iam-verify-browser"></a>

Il seguente esempio di codice Python genera un URL prefirmato Signature Version 4 che apri in un browser:

```
from botocore.session import Session
from botocore.auth import SigV4QueryAuth
from botocore.awsrequest import AWSRequest

session = Session()
cred = session.get_credentials().get_frozen_credentials()

endpoint = "{{application-endpoint}}"
region = "{{region}}"

url = f"https://{endpoint}/_login/"
request = AWSRequest(method="GET", url=url)
SigV4QueryAuth(cred, "opensearch", region, expires=300).add_auth(request)

print(request.url)  # Open this URL in a browser
```

**Nota**  
Il `/_login/` l'URL prefirmato funziona solo in un browser. Non funziona con `curl` o altri client HTTP.

### Verifica l'accesso a livello di codice
<a name="application-auth-iam-verify-programmatic"></a>

Il seguente esempio di codice Python firma una richiesta all'endpoint dell'applicazione con le intestazioni Signature Version 4:

```
from botocore.session import Session
from botocore.auth import SigV4Auth
from botocore.awsrequest import AWSRequest
import subprocess

session = Session()
cred = session.get_credentials().get_frozen_credentials()

endpoint = "{{application-endpoint}}"
region = "{{region}}"

url = f"https://{endpoint}/"
request = AWSRequest(method="GET", url=url)
SigV4Auth(cred, "opensearch", region).add_auth(request)

cmd = ["curl", "-s", "-w", "\nHTTP: %{http_code}\n", "-D", "-"]
for k, v in request.headers.items():
    cmd.extend(["-H", f"{k}: {v}"])
cmd.append(url)

result = subprocess.run(cmd, capture_output=True, text=True)
print(result.stdout)
```

Viene restituita una richiesta andata a buon fine `HTTP/1.1 302 Found` con un `location` intestazione di `/app/workspace_initial`. Una richiesta che restituisce `HTTP/1.1 403 Forbidden` indica un problema con la policy IAM.

## Signature (versione 4): dettagli di firma
<a name="application-auth-iam-sigv4"></a>

La tabella seguente elenca i parametri di Signature Version 4 che OpenSearch Mi aspetto.


| Parametro | Valore | 
| --- | --- | 
| Nome del servizio | opensearch | 
| Algoritmo | AWS4-HMAC-SHA256 | 
| Intestazioni firmate | host, come minimo | 
| Scadenza dell'URL prefirmato | Si consigliano non più di 300 secondi | 

**Importante**  
Il nome del servizio Signature Version 4 è `opensearch`. Firmare con `es` o `aoss` causa il fallimento della richiesta.

## Riepilogo della configurazione
<a name="application-auth-iam-summary"></a>

La tabella seguente elenca i controlli di ciascun livello di configurazione.


| Livello | Configurazione | È necessario accedere? | 
| --- | --- | --- | 
| Policy IAM | opensearch:ApplicationAccessAll sull'applicazione ARN | Sì | 
| Policy IAM | es:GetApplication sull'applicazione ARN | Solo per aprire l'applicazione dal Console di gestione AWS | 
| Configurazione dell’applicazione | opensearchDashboards.dashboardAdmin.users | No, controlla solo le funzionalità dell'amministratore | 

## Risoluzione dei problemi di autenticazione IAM
<a name="application-auth-iam-troubleshooting"></a>

I problemi di autenticazione IAM di solito derivano da un'azione politica mancante, da un URL prefirmato utilizzato all'esterno di un browser o da una richiesta firmata con il nome di servizio sbagliato. La tabella seguente elenca i sintomi più comuni, le loro probabili cause e come risolverli.


| Caratteristiche | Causa probabile | Risoluzione | 
| --- | --- | --- | 
| 403 Forbidden quando si apre l'URL dell'applicazione | Il opensearch:ApplicationAccessAll manca il permesso | Aggiungi la policy IAM dal passaggio 1 | 
| 403 con un messaggio che non sei autorizzato a eseguire es:GetApplication | Manca l'autorizzazione della console | Inserisci es:GetApplication sull'applicazione ARN. Questo è richiesto solo per Console di gestione AWS accesso | 
| 400 Bad Request sul /\_login/ con curl | Il /\_login/ l'endpoint funziona solo in un browser | Usa l'autenticazione dell'intestazione Signature Version 4 su / per l'accesso programmatico | 
| L'URL prefirmato restituisce SignatureDoesNotMatch | Il nome del servizio Signature Version 4 è errato | Firma la richiesta con opensearch, non es o aoss | 
| È possibile aprire l'applicazione ma mancano le funzionalità di amministratore | L'amministratore del dashboard non è configurato | Esegui update-application con opensearchDashboards.dashboardAdmin.users, come descritto nel passaggio 2 | 
| L'URL prefirmato è scaduto | L'URL è stato generato più di 300 secondi prima | Genera un nuovo URL prefirmato. Gli URL prefirmati sono di breve durata | 

Per ulteriori informazioni sulle azioni IAM, OpenSearch Usi dell'interfaccia utente, vedi [Riferimento alla politica IAM per OpenSearch UI](application-iam-policy-reference.md).