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 IAM Identity Center. Ce provisionnement utilise le protocole SCIM (System for Cross-Domain Identity Management) v2.0. Vous configurez cette connexion à 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 avec CyberArk les attributs nommés dans IAM Identity Center. Cela entraîne la correspondance des attributs attendus entre IAM Identity Center etCyberArk.

Ce guide est basé sur CyberArk la version d'août 2021. Les étapes à suivre pour les nouvelles versions peuvent varier. Ce guide contient quelques remarques concernant la configuration de l'authentification utilisateur 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.

Prérequis

Vous aurez besoin des éléments suivants avant de pouvoir commencer :

• CyberArkabonnement 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 entre votre CyberArk compte et IAM Identity Center, comme décrit dans la CyberArkdocumentation d'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

Voici les points à prendre en compte lors de l'utilisation CyberArk de la 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 l'application CyberArk IAM Identity Center est modifié, 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 de l'application CyberArk IAM Identity Center. Assurez-vous de configurer le comportement adapté à 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éprovisionnez les utilisateurs du centre d'identité IAM lorsque l'utilisateur est supprimé 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

1. Une fois que vous avez rempli les conditions requises, ouvrez la console IAM Identity Center.

2. Choisissez Paramètres dans le volet de navigation de gauche.

3. 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.

4. Dans la boîte de dialogue de provisionnement automatique entrant, copiez chacune des valeurs des options suivantes. Vous devrez les coller ultérieurement lorsque vous configurerez le provisionnement dans votre IdP.

   1. Point de terminaison SCIM

   2. Jeton d'accès

5. Choisissez Fermer.

Maintenant que vous avez configuré le provisionnement dans la console IAM Identity Center, vous devez effectuer les tâches restantes à l'aide de l'application CyberArk 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 l'application CyberArk IAM Identity Center pour activer le provisionnement avec IAM Identity Center. Cette procédure suppose que vous avez déjà ajouté l'application CyberArk IAM Identity Center à votre console CyberArk 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

1. Ouvrez l'application CyberArk IAM Identity Center que vous avez ajoutée dans le cadre de la configuration de SAML pour CyberArk (Applications > Web App). veuillez consulter Prérequis.

2. Choisissez l'application IAM Identity Center et accédez à la section Provisioning.

3. Cochez la case Activer le provisionnement pour cette application et choisissez Live Mode.

4. 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 l'application CyberArk IAM Identity Center, définissez le type d'autorisation comme en-tête d'autorisation. Assurez-vous de supprimer la barre oblique à la fin de l'URL.

5. Définissez le type d'en-tête sur Bearer Token.

6. À 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 de l'application CyberArk IAM Identity Center.

7. Cliquez sur Vérifier pour tester et appliquer la configuration.

8. Dans les options de synchronisation, choisissez le comportement approprié pour lequel vous souhaitez que le provisionnement sortant fonctionneCyberArk. Vous pouvez choisir de remplacer (ou non) les utilisateurs IAM Identity Center existants par un nom principal et un comportement de déprovisionnement similaires.

9. Sous Mappage des rôles, configurez le mappage à partir CyberArk des rôles, dans le champ Nom, vers le groupe IAM Identity Center, sous le groupe de destination.

10. Cliquez sur Enregistrer en bas de page une fois que vous avez terminé.

11. 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. Les utilisateurs synchronisés depuis CyberArk apparaîtront 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 : Configuration des attributs utilisateur CyberArk pour le contrôle d'accès (ABAC) dans IAM Identity Center

Il s'agit d'une procédure facultative 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 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 transmisCyberArk.

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 CyberArk pour le contrôle d'accès dans IAM Identity Center

1. Ouvrez l'application CyberArk IAM Identity Center que vous avez installée dans le cadre de la configuration de SAML pour CyberArk (Apps > Web Apps).

2. Accédez à l'option SAML Response.

3. Sous Attributs, ajoutez les attributs appropriés au tableau en suivant la logique ci-dessous :

   1. Le nom de l'attribut est le nom d'attribut d'origine deCyberArk.

   2. La valeur d'attribut est le nom d'attribut envoyé dans l'assertion SAML à IAM Identity Center.

4. Choisissez 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:{TagKey} 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 STSdans le guide de l'utilisateur IAM.

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.