Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
AWS IAM Identity Center authentification pour OpenSearch UI
Avec AWS IAM Identity Center, votre équipe bénéficie d'une expérience d'authentification unique basée sur un navigateur. Vos utilisateurs se connectent avec leur AWS IAM Identity Center informations d'identification au lieu de générer des URL présignées.
Conditions préalables
-
Un AWS compte avec à la fois la base et le AWS IAM Identity Center Autorisations IAM. Pour plus d’informations sur les autorisations requises, consultez Référence de politique IAM pour OpenSearch UI.
-
AWS IAM Identity Center activé dans votre compte ou votre organisation. Notez si vous avez une instance d'organisation ou une instance de compte, car cela affecte certaines étapes de configuration.
-
Un rôle IAM doté à la fois de la politique d'autorisations requise et d'une politique de confiance. Vous créez ce rôle dans Étape 2 : création du rôle IAM.
-
Au moins un OpenSearch collection sans domaine ou sans serveur dans le AWS Région.
-
Au moins un utilisateur ou un groupe créé dans AWS IAM Identity Center.
Condition préalable supplémentaire pour une instance d'organisation qui utilise une clé gérée par le client
Si l'instance de votre organisation AWS IAM Identity Center utilise une clé gérée par le client pour le chiffrement au repos, vous devez accorder OpenSearch Autorisation de l'interface utilisateur pour déchiffrer les données d'identité avec cette clé. Sans cette autorisation, l'authentification unique échoue avec AccessDeniedException tandis que OpenSearch L'interface utilisateur valide le code d'autorisation.
Pour vérifier si votre instance utilise une clé gérée par le client, ouvrez le AWS IAM Identity Center
console, choisissez Réglages, choisissez le Gestion onglet et révision Clé de chiffrement des données IAM Identity Center au repos. S'il affiche un ARN de clé géré par le client plutôt qu'un AWS clé détenue, ajoutez les instructions suivantes à la politique de clé du compte de gestion où AWS IAM Identity Center est activé. Remplacer organization-id avec votre AWS ID d'organisation de l'organisation, au format 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}}" } } }
Pour plus d'informations, voir Clés gérées par le client dans le AWS IAM Identity Center Guide de l'utilisateur.
Étape 1 : Vérifiez que AWS IAM Identity Center est activé
Pour vérifier que AWS IAM Identity Center est activé
-
Ouvrez la AWS console IAM Identity Center
. -
Si la console affiche un tableau de bord contenant les détails de votre instance, AWS IAM Identity Center est activé. Notez s'il s'agit d'une instance d'organisation ou d'une instance de compte.
-
Si la console affiche une page de configuration, activez AWS IAM Identity Center avant de continuer.
Une instance d'organisation fonctionne sur tous les comptes de votre AWS Organisation des organisations, et il est recommandé pour une utilisation en production. Une instance de compte est limitée à un seul compte, qui convient aux tests et aux configurations isolées. Si votre compte appartient à une organisation gérée par quelqu'un d'autre, demandez à votre administrateur si AWS IAM Identity Center doit être activé au niveau de l'organisation.
Étape 2 : création du rôle IAM
AWS IAM Identity Center assume un rôle IAM lorsque les utilisateurs accèdent à votre OpenSearch Application d'interface utilisateur. Ce rôle nécessite une politique d'autorisations, qui définit ce qu'il peut faire, et une politique de confiance, qui définit qui peut assumer le rôle.
Utilisez la politique d'autorisations suivante. Remplacez les valeurs des espaces réservés par vos informations.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*" } ] }
Utilisez la politique de confiance suivante, qui permet AWS IAM Identity Center pour assumer le rôle :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sso.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Pour créer le rôle et associer la politique d'autorisations à AWS CLI, exécutez les commandes suivantes :
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/*" }] }'
Notez l'ARN du rôle. Vous le spécifiez à l'étape suivante. L'ARN a le format arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role.
Étape 3 : Créez l'application avec AWS IAM Identity Center activé
Pour commencer à créer l'application
-
Ouvrez le Amazon OpenSearch Console de service
. -
Dans le menu de navigation, choisissez OpenSearch Interface utilisateur (tableaux de bord).
-
Choisissez Créer une application.
-
Entrez un nom pour l'application.
-
Ajoutez au moins une source de données, soit OpenSearch domaine ou collection sans serveur.
Continuez à utiliser le même formulaire pour activer l'authentification unique et terminer la création de l'application.
Pour activer AWS IAM Identity Center et créez l'application
-
Sélectionnez le Authentification avec IAM Identity Center case à cocher.
-
Sélectionnez le rôle IAM que vous avez créé dans Étape 2 : création du rôle IAM.
-
(Facultatif) Configurez les administrateurs du tableau de bord.
-
Cliquez sur Créer.
Pour créer la même application avec AWS CLI, exécutez la commande suivante. Remplacez les valeurs des espaces réservés par vos informations.
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}}
Étape 4 : Attribuer des utilisateurs dans AWS IAM Identity Center
Pour affecter des utilisateurs ou des groupes à l'application
-
Ouvrez la AWS console IAM Identity Center
. -
Dans le menu de navigation, choisissez Demandes.
-
Choisissez l'application qui OpenSearch Je me suis inscrite automatiquement. Son nom correspond à votre OpenSearch Nom de l'application d'interface utilisateur.
-
Choisissez Assign users and groups (Attribuer des utilisateurs et des groupes).
-
Sélectionnez les utilisateurs ou les groupes qui ont besoin d'un accès, puis choisissez Attribuer.
Étape 5 : Vérifiez la configuration
Pour vérifier la configuration
-
En Amazonie OpenSearch Console de service, vérifiez que l'état de l'application est Actif, ce qui indique que l'application est prête à être utilisée.
-
Confirmez que Authentification avec IAM Identity Center est activé sur la page des détails de l'application.
-
Copiez l'URL de l'application depuis la page des détails de l'application.
-
Ouvrez l'URL de l'application dans un navigateur. Vous êtes redirigé vers le AWS IAM Identity Center page de connexion.
-
Connectez-vous avec votre AWS IAM Identity Center informations d'identification. Le OpenSearch Le sélecteur d'espace de travail de l'interface utilisateur apparaît.
Gestion des utilisateurs et des groupes par programmation
Lorsque vous créez un OpenSearch Application d'interface utilisateur avec AWS IAM Identity Center activé, OpenSearch L'interface utilisateur enregistre un AWS IAM Identity Center candidature. Vous devez affecter des utilisateurs à cette application pour qu'ils puissent se connecter. Il existe deux niveaux d'accès distincts :
- Affectation des candidatures
-
Contrôle qui peut se connecter à OpenSearch UI. Vous le gérez avec le
sso-admincommandes. - Administrateur de l'application
-
Contrôle qui peut modifier ou supprimer l'application et gérer ses espaces de travail. Vous le gérez avec
aws opensearch update-application. Pour plus d'informations sur les administrateurs d'applications, consultez Gestion des administrateurs d'applications.
Vous avez besoin de trois identifiants pour gérer les affectations.
| Identifiant | Comment l'obtenir |
|---|---|
| Le AWS IAM Identity Center ARN de l'application | aws opensearch get-application, dans iamIdentityCenterOptions.iamIdentityCenterApplicationArn |
| L'identifiant de la boutique d'identités | aws sso-admin list-instances, dans Instances[0].IdentityStoreId |
| L'identifiant de l'utilisateur ou du groupe | aws identitystore list-users ou aws identitystore
list-groups |
Les commandes suivantes permettent de rechercher un utilisateur par son nom d'utilisateur et un groupe par son nom d'affichage. Remplacez le placeholder values avec vos propres informations :
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
Les commandes suivantes attribuent un utilisateur ou un groupe à l'application et vérifient ou suppriment des attributions. Pour un groupe, définissez --principal-type pour GROUP et utilisez l'identifiant de groupe que vous avez trouvé précédemment comme identifiant 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 aucun utilisateur ou groupe n'existe encore dans votre banque d'identités, créez-le avec aws identitystore create-user ou aws identitystore
create-group, et ajoutez des membres avec aws identitystore
create-group-membership.
L'exemple de code Python suivant recherche un utilisateur par son nom d'utilisateur et l'affecte à l'application avec le AWS SDK pour 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", )
Résolution des problèmes AWS IAM Identity Center authentification
AWS IAM Identity Center les problèmes d'authentification proviennent généralement d'une politique de confiance qui omet sso.amazonaws.com, une politique d'autorisations pour laquelle les actions requises sont manquantes, ou un utilisateur qui n'est pas affecté à l'application. Le tableau suivant répertorie les symptômes courants, leurs causes probables et les moyens de les résoudre.
| Symptôme | Cause probable | Résolution |
|---|---|---|
| Un message qui AWS IAM Identity Center n'est pas activé apparaît lors de la création de l'application | Il n'y a aucune instance dans votre compte ou votre organisation | Activer AWS IAM Identity Center dans le AWS IAM Identity Center console |
| L'authentification unique redirige mais renvoie une erreur | La politique de confiance en matière de rôle n'inclut pas sso.amazonaws.com |
Mettez à jour la politique de confiance comme décrit dans Étape 2 : création du rôle IAM |
| Sign-in réussit mais l'utilisateur n'a pas accès | L'utilisateur n'est pas affecté à l'application | Attribuez l'utilisateur dans AWS IAM Identity Center console, comme décrit dans Étape 4 : Attribuer des utilisateurs dans AWS IAM Identity Center |
| L'accès est refusé après la connexion | La politique d'autorisation des rôles ne contient pas les actions requises | Vérifiez que le rôle est opensearch:ApplicationAccessAll et autorisation d'accès aux sources de données |
| L'application affiche AWS IAM Identity Center comme activé, mais la connexion échoue | Le rôle ARN ne correspond pas | Vérifiez que le rôle ARN dans les paramètres de l'application est le rôle qui possède les politiques de confiance et d'autorisations appropriées |
| L'application ne peut pas être créée avec AWS IAM Identity Center | AWS IAM Identity Center les autorisations sont manquantes | Vérifiez que votre principal IAM possède sso:CreateApplication, sso:PutApplicationGrant, et iam:PassRole |
| La page de connexion s'affiche mais aucun utilisateur ne peut se connecter | Aucun utilisateur n'est assigné dans AWS IAM Identity Center | Attribuez des utilisateurs à l'application dans AWS IAM Identity Center console |
Sign-in échoue avec un message indiquant que le code d'autorisation ne peut pas être validé, ou avec AccessDeniedException |
AWS IAM Identity Center utilise une clé gérée par le client sans la politique de clé requise | Ajoutez les principales déclarations de politique décrites plus haut dans cette rubrique |
| Un utilisateur ne peut pas se connecter peu de temps après avoir été assigné | L'assignation n'a pas encore été propagée | Attendez une à deux minutes, puis réessayez |
AccessDeniedException sur create-application-assignment |
Le sso:CreateApplicationAssignment l'autorisation est manquante |
Ajoutez le AWS IAM Identity Center autorisations répertoriées dans Référence de politique IAM pour OpenSearch UI |
ConflictException en mission |
L'utilisateur ou le groupe est déjà attribué | Confirmez avec list-application-assignments |