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.
Setting up SCIM provisioning between CyberArk and IAM Identity Center
IAM Identity Center prend en charge le provisionnement automatique (synchronisation) des informations utilisateur depuis CyberArk Directory Platform dans IAM Identity Center. Ce provisionnement utilise le protocole SCIM (System for Cross-Domain Identity Management) v2.0. Pour de plus amples informations, veuillez consulter Utilisation de la fédération d'identité SAML et SCIM avec des fournisseurs d'identité externes.
Vous configurez cette connexion dans CyberArk à l'aide de votre point de terminaison SCIM et de votre jeton d'accès IAM Identity Center. Lorsque vous configurez la synchronisation SCIM, vous créez un mappage de vos attributs utilisateur dans CyberArk aux attributs nommés dans IAM Identity Center. Cela entraîne la correspondance des attributs attendus entre IAM Identity Center et CyberArk.
Ce guide est basé sur CyberArk à partir d'août 2021. Les étapes à suivre pour les nouvelles versions peuvent varier. Ce guide contient quelques remarques concernant la configuration de l'authentification des utilisateurs via SAML.
Note
Avant de commencer à déployer SCIM, nous vous recommandons de consulter d'abord leConsidérations relatives à l'utilisation du provisionnement automatique. Passez ensuite en revue les autres considérations dans la section suivante.
Rubriques
Prérequis
Vous aurez besoin des éléments suivants avant de pouvoir commencer :
-
CyberArk abonnement ou essai gratuit. Pour vous inscrire à un essai gratuit, rendez-vous sur CyberArk
. -
Un compte compatible avec IAM Identity Center (gratuit
). Pour plus d'informations, voir Activer le centre d'identité IAM. -
Une connexion SAML depuis votre CyberArk compte auprès d'IAM Identity Center, comme décrit dans CyberArk documentation pour IAM Identity Center
. -
Associez le connecteur IAM Identity Center aux rôles, utilisateurs et organisations auxquels vous souhaitez autoriser l'accès Comptes AWS.
Considérations relatives au SCIM
Les points suivants sont à prendre en compte lors de l'utilisation CyberArk fédération pour IAM Identity Center :
-
Seuls les rôles mappés dans la section Provisioning des applications seront synchronisés avec IAM Identity Center.
-
Le script de provisionnement n'est pris en charge que dans son état par défaut. Une fois modifié, le provisionnement SCIM peut échouer.
-
Un seul attribut de numéro de téléphone peut être synchronisé et l'attribut par défaut est « téléphone professionnel ».
-
-
Si le mappage des rôles dans CyberArk L'application IAM Identity Center a été modifiée, le comportement ci-dessous est attendu :
-
Si les noms de rôles sont modifiés, aucune modification n'est apportée aux noms de groupes dans IAM Identity Center.
-
Si les noms des groupes sont modifiés, de nouveaux groupes seront créés dans IAM Identity Center, les anciens groupes resteront mais n'auront aucun membre.
-
-
Le comportement de synchronisation et de déprovisionnement des utilisateurs peut être configuré à partir du CyberArk Application IAM Identity Center, assurez-vous de configurer le bon comportement pour votre organisation. Voici les options qui s'offrent à vous :
-
Remplacez (ou non) les utilisateurs du répertoire Identity Center par le même nom principal.
-
Déprovisionner les utilisateurs du centre d'identité IAM lorsque l'utilisateur est retiré du CyberArk rôle.
-
Déprovisionner le comportement des utilisateurs : désactiver ou supprimer.
-
Étape 1 : activer le provisionnement dans IAM Identity Center
Dans cette première étape, vous utilisez la console IAM Identity Center pour activer le provisionnement automatique.
Pour activer le provisionnement automatique dans IAM Identity Center
-
Une fois que vous avez rempli les conditions requises, ouvrez la console IAM Identity Center
. -
Choisissez Paramètres dans le volet de navigation de gauche.
-
Sur la page Paramètres, recherchez la zone Informations de provisionnement automatique, puis choisissez Activer. Cela active immédiatement le provisionnement automatique dans IAM Identity Center et affiche les informations nécessaires sur le point de terminaison SCIM et le jeton d'accès.
-
Dans la boîte de dialogue de provisionnement automatique entrant, copiez le point de terminaison SCIM et le jeton d'accès. Vous devrez les coller ultérieurement lorsque vous configurerez le provisionnement dans votre IdP.
-
Point de terminaison SCIM : par exemple, https://scim.
us-east-2.amazonaws.com/ /scim/v211111111111-2222-3333-4444-555555555555 -
Jeton d'accès : choisissez Afficher le jeton pour copier la valeur.
Avertissement
C'est le seul moment où vous pouvez obtenir le point de terminaison SCIM et le jeton d'accès. Assurez-vous de copier ces valeurs avant de continuer. Vous saisirez ces valeurs pour configurer le provisionnement automatique dans votre IdP plus loin dans ce didacticiel.
-
-
Choisissez Close (Fermer).
Maintenant que vous avez configuré le provisionnement dans la console IAM Identity Center, vous devez effectuer les tâches restantes à l'aide du CyberArk Application IAM Identity Center. Ces étapes sont décrites dans la procédure suivante.
Étape 2 : configurer le provisionnement dans CyberArk
Utilisez la procédure suivante dans le CyberArk Application IAM Identity Center pour permettre le provisionnement avec IAM Identity Center. Cette procédure suppose que vous avez déjà ajouté le CyberArk Application IAM Identity Center pour votre CyberArk console d'administration sous Web Apps. Si vous ne l'avez pas encore fait, reportez-vous auPrérequis, puis suivez cette procédure pour configurer le provisionnement SCIM.
Pour configurer le provisionnement dans CyberArk
-
Ouvrez le fichier CyberArk Application IAM Identity Center que vous avez ajoutée dans le cadre de la configuration de SAML pour CyberArk (Applis > Application Web). Consultez Prérequis.
-
Choisissez l'application IAM Identity Center et accédez à la section Provisioning.
-
Cochez la case Activer le provisionnement pour cette application et choisissez Live Mode.
-
Dans la procédure précédente, vous avez copié la valeur du point de terminaison SCIM depuis IAM Identity Center. Collez cette valeur dans le champ URL du service SCIM, dans le CyberArk L'application IAM Identity Center a défini le type d'autorisation comme en-tête d'autorisation.
-
Définissez le type d'en-tête sur Bearer Token.
-
À partir de la procédure précédente, vous avez copié la valeur du jeton d'accès dans IAM Identity Center. Collez cette valeur dans le champ Bearer Token du CyberArk Application IAM Identity Center.
-
Cliquez sur Vérifier pour tester et appliquer la configuration.
-
Dans les options de synchronisation, choisissez le comportement approprié pour lequel vous souhaitez effectuer le provisionnement sortant à partir de CyberArk pour travailler. Vous pouvez choisir de remplacer (ou non) les utilisateurs IAM Identity Center existants par un nom principal et un comportement de déprovisionnement similaires.
-
Sous Cartographie des rôles, configurez le mappage à partir de CyberArk rôles, sous le champ Nom du groupe IAM Identity Center, sous le groupe de destination.
-
Cliquez sur Enregistrer en bas de page une fois que vous avez terminé.
-
Pour vérifier que les utilisateurs ont été correctement synchronisés avec IAM Identity Center, revenez à la console IAM Identity Center et sélectionnez Utilisateurs. Utilisateurs synchronisés depuis CyberArk apparaîtra sur la page Utilisateurs. Ces utilisateurs peuvent désormais être affectés à des comptes et peuvent se connecter au sein d'IAM Identity Center.
(Facultatif) Étape 3 : configurer les attributs utilisateur dans CyberArk pour le contrôle d'accès (ABAC) dans IAM Identity Center
Il s'agit d'une procédure facultative pour CyberArk si vous choisissez de configurer des attributs pour IAM Identity Center afin de gérer l'accès à vos AWS ressources. Les attributs que vous définissez dans CyberArk sont transmis dans une assertion SAML à IAM Identity Center. Vous créez ensuite un ensemble d'autorisations dans IAM Identity Center pour gérer l'accès en fonction des attributs que vous avez transmis CyberArk.
Avant de commencer cette procédure, vous devez d'abord activer la Attributs pour le contrôle d’accès fonctionnalité. Pour plus d'informations sur cette étape, consultez Activer et configurer les attributs pour le contrôle d'accès.
Pour configurer les attributs utilisateur dans CyberArk pour le contrôle d'accès dans IAM Identity Center
-
Ouvrez le fichier CyberArk Application IAM Identity Center que vous avez installée dans le cadre de la configuration de SAML pour CyberArk (Applis > Applications Web).
-
Accédez à l'option SAML Response.
-
Sous Attributs, ajoutez les attributs appropriés au tableau en suivant la logique ci-dessous :
-
Le nom de l'attribut est le nom d'attribut d'origine de CyberArk.
-
La valeur d'attribut est le nom d'attribut envoyé dans l'assertion SAML à IAM Identity Center.
-
-
Choisissez Save (Enregistrer).
(Facultatif) Transmission d'attributs pour le contrôle d'accès
Vous pouvez éventuellement utiliser la Attributs pour le contrôle d’accès fonctionnalité d'IAM Identity Center pour transmettre un Attribute élément dont l'Nameattribut est défini sur. https://aws.amazon.com/SAML/Attributes/AccessControl: Cet élément vous permet de transmettre des attributs en tant que balises de session dans l'assertion SAML. Pour plus d'informations sur les balises de session, consultez la section Transmission de balises de session AWS STS dans le guide de l'utilisateur IAM.{TagKey}
Pour transmettre des attributs en tant que balises de session, incluez l'élément AttributeValue qui spécifie la valeur de la balise. Par exemple, pour transmettre la paire clé-valeur du tagCostCenter = blue, utilisez l'attribut suivant.
<saml:AttributeStatement> <saml:Attribute Name="https://aws.amazon.com/SAML/Attributes/AccessControl:CostCenter"> <saml:AttributeValue>blue </saml:AttributeValue> </saml:Attribute> </saml:AttributeStatement>
Si vous devez ajouter plusieurs attributs, incluez un Attribute élément distinct pour chaque balise.
