View a markdown version of this page

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

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

Passaggio 1: concedere l'autorizzazione IAM

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.

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

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

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

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

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

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

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

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.