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
-
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.
-
Un ruolo IAM che richiede l'accesso all'applicazione.
-
Il AWS CLI configurato con credenziali.
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}}" }] }'
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}}
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
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 |
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.