View a markdown version of this page

AWS IAM Identity Center autenticación para OpenSearch UI - Amazon OpenSearch Servicio

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS IAM Identity Center autenticación para OpenSearch UI

Con AWS IAM Identity Center, tu equipo obtiene una experiencia de inicio de sesión único basada en un navegador. Tus usuarios inician sesión con sus AWS IAM Identity Center credenciales en lugar de generar URL prefirmadas.

Requisitos previos

  • Un AWS cuenta tanto con la base como con la AWS IAM Identity Center permisos de IAM. Para obtener más información sobre los permisos necesarios, consulte Referencia de políticas de IAM para OpenSearch UI.

  • AWS IAM Identity Center habilitados en tu cuenta u organización. Ten en cuenta si tienes una instancia de organización o una instancia de cuenta, ya que esto afecta a algunos pasos de configuración.

  • Un rol de IAM con la política de permisos requerida y una política de confianza. Este rol se crea en Paso 2: Crear el rol de IAM.

  • Al menos uno OpenSearch dominio o colección sin servidor en el AWS Región.

  • Al menos un usuario o grupo creado en AWS IAM Identity Center.

Requisito previo adicional para una instancia de organización que utilice una clave gestionada por el cliente

Si la instancia de su organización de AWS IAM Identity Center utiliza una clave gestionada por el cliente para el cifrado en reposo, debes concederla OpenSearch Permiso de interfaz de usuario para descifrar datos de identidad con esa clave. Sin este permiso, el inicio de sesión único falla con AccessDeniedException mientras OpenSearch La interfaz de usuario valida el código de autorización.

Para comprobar si tu instancia usa una clave gestionada por el cliente, abre el AWS IAM Identity Center consola, elige Ajustes, elige el Administración pestaña y revisión Clave para cifrar los datos de IAM Identity Center en reposo. Si muestra un ARN de clave administrada por el cliente en lugar de un AWS clave propia, añada las siguientes declaraciones a la política de claves de la cuenta de administración donde AWS IAM Identity Center está habilitada. Reemplazar organization-id con tu AWS ID de organización de la organización, en el 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 obtener más información, consulte Claves administradas por el cliente en el AWS IAM Identity Center Guía del usuario.

Paso 1: Verifique que AWS IAM Identity Center está activado

Para verificar eso AWS IAM Identity Center está activado
  1. Abra la AWS consola de IAM Identity Center.

  2. Si la consola muestra un panel con los detalles de la instancia, AWS IAM Identity Center está habilitada. Observe si la instancia es una instancia de organización o una instancia de cuenta.

  3. Si la consola muestra una página de configuración, habilita AWS IAM Identity Center antes de continuar.

Una instancia de organización funciona en todas las cuentas de tu AWS La organización es la organización y se recomienda su uso en producción. Una instancia de cuenta está limitada a una sola cuenta, lo que se adapta a las configuraciones aisladas y de prueba. Si tu cuenta pertenece a una organización que administra otra persona, pregunta a tu administrador si AWS IAM Identity Center debe estar habilitada a nivel de la organización.

Paso 2: Crear el rol de IAM

AWS IAM Identity Center asume una función de IAM cuando los usuarios acceden a su OpenSearch Aplicación de interfaz de usuario. Ese rol necesita una política de permisos, que defina lo que puede hacer el rol, y una política de confianza, que defina quién puede asumir el rol.

Utilice la siguiente política de permisos. Reemplace los valores de marcador de posición con su información.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*" } ] }

Utilice la siguiente política de confianza, que permite AWS IAM Identity Center para asumir el rol:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sso.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Para crear el rol y adjuntar la política de permisos al AWS CLI, ejecute los siguientes 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/*" }] }'

Apunte el ARN del rol . Lo especificará en el paso siguiente. El ARN tiene el formato arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role.

Paso 3: Crea la aplicación con AWS IAM Identity Center enabled

Para empezar a crear la aplicación
  1. Abra el Amazon OpenSearch Consola de servicio.

  2. En el menú de navegación, elige OpenSearch Interfaz de usuario (paneles).

  3. Elija Creación de aplicación.

  4. Escriba un nombre para la aplicación.

  5. Agregue al menos una fuente de datos, ya sea una OpenSearch dominio o una colección sin servidor.

Continúe con el mismo formulario para activar el inicio de sesión único y terminar de crear la aplicación.

Para habilitar AWS IAM Identity Center y crear la aplicación
  1. Seleccione el Autenticación con IAM Identity Center casilla de verificación.

  2. Seleccione el rol de IAM que creó en Paso 2: Crear el rol de IAM.

  3. (Opcional) Configure los administradores del panel de control.

  4. Seleccione Crear.

Para crear la misma aplicación con AWS CLI, ejecute el siguiente comando. Reemplace los valores de marcador de posición con su información.

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}}

Paso 4: Asigne usuarios en AWS IAM Identity Center

Para asignar usuarios o grupos a la aplicación
  1. Abra la AWS consola de IAM Identity Center.

  2. En el menú de navegación, elija Aplicaciones.

  3. Elija la aplicación que OpenSearch La interfaz de usuario se registró automáticamente. Su nombre coincide con el tuyo OpenSearch Nombre de la aplicación de interfaz de usuario.

  4. Elija Asignar usuarios y grupos.

  5. Seleccione los usuarios o grupos que necesitan acceso y, a continuación, elija Asignar.

Paso 5: Verificar la configuración

Para verificar la configuración
  1. En el Amazonas OpenSearch Consola de servicio, confirme que el estado de la solicitud es Activa, lo que indica que la aplicación está lista para usarse.

  2. Confirme que Autenticación con IAM Identity Center está habilitada en la página de detalles de la aplicación.

  3. Copie la URL de la aplicación desde la página de detalles de la aplicación.

  4. Abra la URL de la aplicación en un navegador. Se le redirigirá a AWS IAM Identity Center página de inicio de sesión.

  5. Inicia sesión con tu AWS IAM Identity Center credenciales. El OpenSearch Aparece el selector de espacio de trabajo de la interfaz

Administrar usuarios y grupos mediante programación

Al crear un OpenSearch Aplicación de interfaz de usuario con AWS IAM Identity Center habilitada, OpenSearch La interfaz de usuario registra un AWS IAM Identity Center aplicación. Debe asignar usuarios a esa aplicación antes de que puedan iniciar sesión. Hay dos niveles de acceso distintos:

Asignación de aplicaciones

Controla quién puede iniciar sesión en OpenSearch UI. Lo gestionas con el sso-admin comandos.

Administrador de aplicaciones

Controla quién puede editar o eliminar la aplicación y administrar sus espacios de trabajo. La administras con aws opensearch update-application. Para obtener más información acerca de los administradores de aplicaciones, consulte Administrar los administradores de aplicaciones.

Necesitas tres identificadores antes de gestionar las tareas.

Identificador ¿Cómo obtenerlo
El AWS IAM Identity Center ARN de la aplicación aws opensearch get-application, en iamIdentityCenterOptions.iamIdentityCenterApplicationArn
El ID del almacén de identidades aws sso-admin list-instances, en Instances[0].IdentityStoreId
El ID de usuario o grupo aws identitystore list-users o aws identitystore list-groups

Los siguientes comandos buscan un usuario por su nombre de usuario y un grupo por su nombre para mostrar. Sustituya el placeholder values con su propia información:

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

Los siguientes comandos asignan un usuario o un grupo a la aplicación y revisan o eliminan las asignaciones. Para un grupo, defina --principal-type a GROUP y usa el ID de grupo que encontraste anteriormente como el 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}}

Si aún no existe un usuario o un grupo en tu almacén de identidades, créalo con aws identitystore create-user o aws identitystore create-group, y añadir miembros con aws identitystore create-group-membership.

El siguiente ejemplo de código de Python busca un usuario por su nombre de usuario y lo asigna a la aplicación con el 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", )

Resolución de problemas AWS IAM Identity Center autenticación

AWS IAM Identity Center los problemas de autenticación suelen provenir de una política de confianza que omite sso.amazonaws.com, una política de permisos a la que le faltan las acciones obligatorias o un usuario que no está asignado a la aplicación. En la tabla siguiente se enumeran los síntomas comunes, sus causas probables y cómo resolver cada uno de ellos.

Síntoma Causa probable Resolución
Un mensaje que AWS IAM Identity Center no está activado aparece al crear la aplicación No hay ninguna instancia en tu cuenta u organización Habilitar AWS IAM Identity Center en el AWS IAM Identity Center consola
El inicio de sesión único redirige pero devuelve un error La política de confianza de roles no incluye sso.amazonaws.com Actualice la política de confianza tal como se describe en Paso 2: Crear el rol de IAM
Sign-in se realiza correctamente, pero el usuario no tiene acceso El usuario no está asignado a la aplicación Asigne el usuario en AWS IAM Identity Center consola, tal y como se describe en Paso 4: Asigne usuarios en AWS IAM Identity Center
Se deniega el acceso después de iniciar sesión Faltan las acciones necesarias en la política de permisos de funciones Confirme que el rol tiene opensearch:ApplicationAccessAll y permiso para acceder a las fuentes de datos
La aplicación muestra AWS IAM Identity Center como activado, pero no se puede iniciar sesión El ARN del rol no coincide Confirme que el ARN del rol en la configuración de la aplicación es el rol que tiene las políticas de confianza y permisos correctas
La aplicación no se puede crear con AWS IAM Identity Center AWS IAM Identity Center faltan los permisos Confirme que su director de IAM tiene sso:CreateApplication, sso:PutApplicationGrant, y iam:PassRole
Aparece la página de inicio de sesión, pero ningún usuario puede iniciar sesión No hay ningún usuario asignado AWS IAM Identity Center Asigne usuarios a la aplicación en AWS IAM Identity Center consola
Sign-in falla con un mensaje que indica que el código de autorización no se puede validar, o con AccessDeniedException AWS IAM Identity Center utiliza una clave gestionada por el cliente sin la política de claves requerida Agregue las declaraciones de política clave descritas anteriormente en este tema
Un usuario no puede iniciar sesión poco después de haber sido asignado La asignación aún no se ha propagado Espere uno o dos minutos e inténtelo de nuevo
AccessDeniedException del create-application-assignment El sso:CreateApplicationAssignment falta el permiso Agregue el AWS IAM Identity Center permisos listados en Referencia de políticas de IAM para OpenSearch UI
ConflictException en una tarea El usuario o grupo ya está asignado Confirme con list-application-assignments