As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Autenticação IAM para OpenSearch UI
Este tópico aborda as permissões mínimas do IAM necessárias para acessar um OpenSearch Aplicativo de interface de usuário que usa autenticação IAM, sem Centro de Identidade do AWS IAM. Depois de concluir essas etapas, uma função do IAM pode entrar no aplicativo e consultar suas fontes de dados.
Pré-requisitos
-
Um OpenSearch Aplicativo de interface do usuário criado com autenticação IAM. Para obter instruções sobre como criar um aplicativo, consulte Começando com o OpenSearch interface de usuário na Amazon OpenSearch Serviço.
-
Uma função do IAM que precisa acessar o aplicativo.
-
O AWS CLI configurado com credenciais.
Etapa 1: conceder a permissão do IAM
A política do IAM a seguir concede acesso à interface do aplicativo. Anexe-o à função do IAM que precisa ser acessada e substitua os valores do espaço reservado por suas próprias informações:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}" } ] }
Definir o escopo do recurso para uma única ID de aplicativo concede o menor privilégio que a função precisa. Em vez disso, para conceder acesso a todos os aplicativos na conta e na região, use um curinga:
"Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*"
Você pode anexar a mesma política ao 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}}" }] }'
A ação que concede acesso à interface do aplicativo é opensearch:ApplicationAccessAll. Para obter mais informações sobre as permissões que um aplicativo exige, consulte Referência de política do IAM para OpenSearch UI.
Se seus usuários também abrirem o aplicativo a partir do Console de gerenciamento da AWS, adicione a seguinte declaração para que eles possam visualizar o aplicativo no console:
{ "Effect": "Allow", "Action": "es:GetApplication", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}" }
Etapa 2: Configurar o administrador do painel
Defina quais diretores do IAM recebem privilégios de administrador OpenSearch UI. Para conceder privilégios de administrador a todos os usuários autenticados, execute o seguinte comando:
aws opensearch update-application \ --id {{application-id}} \ --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"*"}]' \ --region {{region}}
Para conceder privilégios de administrador a uma única função, especifique o ARN da função:
aws opensearch update-application \ --id {{application-id}} \ --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"arn:aws:iam::{{account-id}}:role/{{role-name}}"}]' \ --region {{region}}
A configuração do administrador do painel controla os recursos do administrador dentro da interface, como gerenciamento de padrões de índice e objetos salvos. Você não precisa dela para fazer login — a política do IAM na etapa 1 é suficiente para acessar o aplicativo.
Etapa 3: Verificar o acesso
Você pode verificar o acesso de um navegador com uma URL pré-assinada ou programaticamente com os cabeçalhos de solicitação Signature Versão 4.
Verificar o acesso a partir de um navegador
O exemplo de código Python a seguir gera um URL pré-assinado Signature versão 4 que você abre em um navegador:
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
O /_login/ O URL pré-assinado funciona somente em um navegador. Não funciona com curl ou outros clientes HTTP.
Verifique o acesso programaticamente
O exemplo de código Python a seguir assina uma solicitação para o endpoint do aplicativo com cabeçalhos 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)
Uma solicitação bem-sucedida retorna HTTP/1.1 302 Found com um location cabeçalho de /app/workspace_initial. Uma solicitação que retorna HTTP/1.1 403 Forbidden indica um problema com a política do IAM.
Detalhes de assinatura do Signature Versão 4
A tabela a seguir lista os parâmetros do Signature Versão 4 que OpenSearch Eu espero.
| Parâmetro | Valor |
|---|---|
| Nome do serviço | opensearch |
| Algoritmo | AWS4-HMAC-SHA256 |
| Cabeçalhos assinados | host, no mínimo |
| Expiração de URL pré-assinada | Não são recomendados mais de 300 segundos |
O nome do serviço Signature Version 4 é opensearch. Assinando com es ou aoss faz com que a solicitação falhe.
Resumo da configuração
A tabela a seguir lista o que cada camada de configuração controla.
| Camada | Configuração | É necessário fazer login? |
|---|---|---|
| Política do IAM | opensearch:ApplicationAccessAll no aplicativo ARN |
Sim |
| Política do IAM | es:GetApplication no aplicativo ARN |
Somente para abrir o aplicativo a partir do Console de gerenciamento da AWS |
| Configuração do aplicativo | opensearchDashboards.dashboardAdmin.users |
Não, ele controla somente os recursos do administrador |
Solução de problemas de autenticação do IAM
Os problemas de autenticação do IAM geralmente vêm de uma ação política ausente, de um URL pré-assinado usado fora de um navegador ou de uma solicitação assinada com o nome de serviço errado. A tabela a seguir lista os sintomas comuns, suas causas prováveis e como resolver cada um deles.
| Sintomas | Causa provável | Resolução |
|---|---|---|
403 Forbidden quando você abre o URL do aplicativo |
O opensearch:ApplicationAccessAll falta permissão |
Adicione a política do IAM da etapa 1 |
403 com uma mensagem que você não está autorizado a executar es:GetApplication |
A permissão do console está ausente | Adicionar es:GetApplication no aplicativo ARN. Isso é necessário apenas para Console de gerenciamento da AWS acesso |
400 Bad Request em /_login/ com curl |
O /_login/ o endpoint funciona somente em um navegador |
Use a autenticação de cabeçalho Signature Versão 4 em / para acesso programático |
O URL pré-assinado retorna SignatureDoesNotMatch |
O nome do serviço Signature Version 4 está errado | Assine a solicitação com opensearch, não es ou aoss |
| Você pode abrir o aplicativo, mas faltam recursos de administrador | O administrador do painel não está configurado | Corra update-application com opensearchDashboards.dashboardAdmin.users, conforme descrito na etapa 2 |
| O URL pré-assinado expirou | O URL foi gerado mais de 300 segundos antes | Gere um novo URL pré-assinado. URLs pré-assinados duram pouco |
Para obter mais informações sobre as ações do IAM que OpenSearch Usos da interface do usuário, consulte Referência de política do IAM para OpenSearch UI.