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á.
Centro de Identidade do AWS IAM autenticação para OpenSearch UI
Com Centro de Identidade do AWS IAM, sua equipe obtém uma experiência de login único baseada em navegador. Seus usuários fazem login com seus Centro de Identidade do AWS IAM credenciais em vez de gerar URLs pré-assinados.
Pré-requisitos
-
Um AWS conta com a base e o Centro de Identidade do AWS IAM Permissões do IAM. Para mais informações sobre as permissões necessárias, consulte Referência de política do IAM para OpenSearch UI.
-
Centro de Identidade do AWS IAM ativado em sua conta ou organização. Observe se você tem uma instância da organização ou uma instância da conta, pois isso afeta algumas etapas de configuração.
-
Uma função do IAM com a política de permissões exigidas e uma política de confiança. Você cria essa função no Etapa 2: criar o perfil do IAM.
-
Pelo menos um OpenSearch domínio ou coleção sem servidor no AWS Região.
-
Pelo menos um usuário ou grupo criado no Centro de Identidade do AWS IAM.
Pré-requisito adicional para uma instância da organização que usa uma chave gerenciada pelo cliente
Se sua organização é uma instância de Centro de Identidade do AWS IAM usa uma chave gerenciada pelo cliente para criptografia em repouso, você deve conceder OpenSearch Permissão de interface do usuário para descriptografar dados de identidade com essa chave. Sem essa permissão, o logon único falha com AccessDeniedException enquanto OpenSearch A interface do usuário valida o código de autorização.
Para verificar se sua instância usa uma chave gerenciada pelo cliente, abra o Centro de Identidade do AWS IAM
console, escolha Configurações, escolha o Gestão guia e revisão Chave para criptografar dados do IAM Identity Center em repouso. Se mostrar uma chave gerenciada pelo cliente (ARN) em vez de uma AWS chave de propriedade, adicione as seguintes declarações à política de chaves na conta de gerenciamento em que Centro de Identidade do AWS IAM está habilitado. Substituir organization-id com o seu AWS ID da organização, no 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}}" } } }
Para obter mais informações, consulte Chaves gerenciadas pelo cliente na Centro de Identidade do AWS IAM Guia do usuário.
Etapa 1: verifique se Centro de Identidade do AWS IAM está habilitado
Para verificar isso Centro de Identidade do AWS IAM está habilitado
-
Se o console mostrar um painel com os detalhes da sua instância, Centro de Identidade do AWS IAM está habilitado. Observe se a instância é uma instância da organização ou uma instância da conta.
-
Se o console mostrar uma página de configuração, habilite Centro de Identidade do AWS IAM antes de continuar.
Uma instância organizacional funciona em todas as contas do seu AWS Organização da organização, e é recomendado para uso em produção. Uma instância de conta tem como escopo uma única conta, o que é adequado para testes e configurações isoladas. Se sua conta pertencer a uma organização gerenciada por outra pessoa, pergunte ao administrador se Centro de Identidade do AWS IAM deve ser habilitado no nível da organização.
Etapa 2: criar o perfil do IAM
Centro de Identidade do AWS IAM assume uma função do IAM quando os usuários acessam seu OpenSearch Aplicativo de interface do usuário. Essa função precisa de uma política de permissões, que define o que a função pode fazer, e de uma política de confiança, que define quem pode assumir a função.
Use a política de permissões a seguir. Substitua os valores de 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/*" } ] }
Use a seguinte política de confiança, que permite Centro de Identidade do AWS IAM para assumir a função:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sso.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Para criar a função e anexar a política de permissões ao AWS CLI, execute os seguintes comandos:
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/*" }] }'
Anote o ARN do perfil do . Você o especifica na próxima etapa. O ARN tem o formato arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role.
Etapa 3: Crie o aplicativo com Centro de Identidade do AWS IAM habilitado
Para começar a criar o aplicativo
-
No menu de navegação, escolha OpenSearch UI (painéis).
-
Selecione Criar aplicativo.
-
Insira um nome para o aplicativo.
-
Adicione pelo menos uma fonte de dados, seja uma OpenSearch domínio ou uma coleção sem servidor.
Continue no mesmo formulário para ativar o login único e finalizar a criação do aplicativo.
Para habilitar Centro de Identidade do AWS IAM e crie o aplicativo
-
Selecione o Autenticação com o IAM Identity Center caixa de seleção.
-
Selecione a função do IAM que você criou no Etapa 2: criar o perfil do IAM.
-
(Opcional) Configure os administradores do painel.
-
Escolha Criar.
Para criar o mesmo aplicativo com o AWS CLI, execute o comando a seguir. Substitua os valores de espaço reservado por suas próprias informações.
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}}
Etapa 4: atribuir usuários em Centro de Identidade do AWS IAM
Para atribuir usuários ou grupos ao aplicativo
-
No menu de navegação, escolha Aplicações.
-
Escolha o aplicativo que OpenSearch Eu me registrei automaticamente. Seu nome corresponde ao seu OpenSearch Nome do aplicativo de interface do usuário.
-
Escolha Atribuir usuários e grupos.
-
Selecione os usuários ou grupos que precisam de acesso e escolha Atribuir.
Etapa 5: Verificar a configuração
Para verificar a configuração
-
Na Amazônia OpenSearch Console de serviço, confirme se o status do aplicativo é Ativo, o que indica que o aplicativo está pronto para uso.
-
Confirme que Autenticação com o IAM Identity Center está ativado na página de detalhes do aplicativo.
-
Copie o URL do aplicativo na página de detalhes do aplicativo.
-
Abra o URL do aplicativo em um navegador. Você é redirecionado para o Centro de Identidade do AWS IAM página de login.
-
Faça login com seu Centro de Identidade do AWS IAM credenciais. O OpenSearch O seletor de espaço de trabalho da interface do usuário é exibido.
Gerenciando usuários e grupos de forma programática
Quando você cria um OpenSearch Aplicativo de interface do usuário com Centro de Identidade do AWS IAM habilitado, OpenSearch A interface do usuário registra um Centro de Identidade do AWS IAM aplicativo. Você deve atribuir usuários a esse aplicativo antes que eles possam entrar. Há dois níveis separados de acesso:
- Atribuição de inscrição
-
Controla quem pode fazer login no OpenSearch UI. Você gerencia isso com o
sso-admincomandos. - Administrador de aplicativos
-
Controla quem pode editar ou excluir o aplicativo e gerenciar seus espaços de trabalho. Você gerencia isso com
aws opensearch update-application. Para obter mais informações sobre administradores de aplicativos, consulte Gerenciar administradores de aplicação.
Você precisa de três identificadores antes de gerenciar as atribuições.
| Identificador | Como obtê-lo |
|---|---|
| O Centro de Identidade do AWS IAM aplicativo ARN | aws opensearch get-application, em iamIdentityCenterOptions.iamIdentityCenterApplicationArn |
| O ID do repositório de identidades | aws sso-admin list-instances, em Instances[0].IdentityStoreId |
| O ID do usuário ou do grupo | aws identitystore list-users ou aws identitystore
list-groups |
Os comandos a seguir localizam um usuário pelo nome de usuário e um grupo pelo nome de exibição. Substitua o placeholder values com suas próprias informações:
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
Os comandos a seguir atribuem um usuário ou grupo ao aplicativo e revisam ou removem atribuições. Para um grupo, defina --principal-type para GROUP e use a ID do grupo que você encontrou anteriormente como a ID principal:
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 um usuário ou grupo ainda não existir em seu repositório de identidades, crie-o com aws identitystore create-user ou aws identitystore
create-groupe adicione membros com aws identitystore
create-group-membership.
O exemplo de código Python a seguir procura um usuário pelo nome de usuário e atribui esse usuário ao aplicativo com a AWS SDK para 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", )
Solução de problemas Centro de Identidade do AWS IAM authentication
Centro de Identidade do AWS IAM problemas de autenticação geralmente vêm de uma política de confiança que omite sso.amazonaws.com, uma política de permissões sem as ações necessárias ou um usuário que não está atribuído ao aplicativo. A tabela a seguir lista os sintomas comuns, suas causas prováveis e como resolver cada um deles.
| Sintomas | Causa provável | Resolução |
|---|---|---|
| Uma mensagem que Centro de Identidade do AWS IAM não está habilitado aparece enquanto você cria o aplicativo | Não há nenhuma instância em sua conta ou organização | Habilitar Centro de Identidade do AWS IAM na Centro de Identidade do AWS IAM console |
| O logon único redireciona, mas retorna um erro | A política de confiança de funções não inclui sso.amazonaws.com |
Atualize a política de confiança conforme descrito em Etapa 2: criar o perfil do IAM |
| Sign-in é bem-sucedido, mas o usuário não tem acesso | O usuário não está atribuído ao aplicativo | Atribua o usuário no Centro de Identidade do AWS IAM console, conforme descrito em Etapa 4: atribuir usuários em Centro de Identidade do AWS IAM |
| O acesso é negado após o login | A política de permissões de função não possui as ações necessárias | Confirme se a função tem opensearch:ApplicationAccessAll e permissão para acessar as fontes de dados |
| O aplicativo mostra Centro de Identidade do AWS IAM estava habilitado, mas o login falha | A função ARN não corresponde | Confirme se a função ARN nas configurações do aplicativo é a função que tem as políticas de confiança e permissões corretas |
| O aplicativo não pode ser criado com Centro de Identidade do AWS IAM | Centro de Identidade do AWS IAM as permissões estão faltando | Confirme se seu diretor do IAM tem sso:CreateApplication, sso:PutApplicationGrant, e iam:PassRole |
| A página de login aparece, mas nenhum usuário pode entrar | Nenhum usuário está atribuído em Centro de Identidade do AWS IAM | Atribua usuários ao aplicativo no Centro de Identidade do AWS IAM console |
Sign-in falha com uma mensagem de que o código de autorização não pode ser validado ou com AccessDeniedException |
Centro de Identidade do AWS IAM usa uma chave gerenciada pelo cliente sem a política de chaves necessária | Adicione as principais declarações de política descritas anteriormente neste tópico |
| Um usuário não pode entrar logo após ser atribuído | A atribuição ainda não foi propagada | Aguarde de um a dois minutos e tente novamente |
AccessDeniedException na create-application-assignment |
O sso:CreateApplicationAssignment falta permissão |
Adicione o Centro de Identidade do AWS IAM permissões listadas em Referência de política do IAM para OpenSearch UI |
ConflictException em uma tarefa |
O usuário ou grupo já está atribuído | Confirme com list-application-assignments |