Setting up SCIM provisioning between CyberArk and IAM Identity Center

IAMIdentity Center prend en charge le provisionnement automatique (synchronisation) des informations utilisateur depuis CyberArk Directory Platform IAM Identity Center. Ce provisionnement utilise le protocole System for Cross-domain Identity Management (SCIM) v2.0. Vous configurez cette connexion à CyberArk l'aide de votre point de SCIM terminaison et de votre jeton d'accès IAM Identity Center. Lorsque vous configurez SCIM la synchronisation, 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 viaSAML.

Note

Avant de commencer le déploiementSCIM, 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, consultez la section Activer IAM Identity Center.

• Une SAML connexion entre votre CyberArk compte et IAM Identity Center, comme décrit dans CyberArkla documentation d'IAMIdentity Center.

• Associez le connecteur IAM Identity Center aux rôles, utilisateurs et organisations auxquels vous souhaitez autoriser l'accès Comptes AWS.

SCIMconsidérations

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 de l'application seront synchronisés avec Identity Center. IAM

• Le script de provisionnement n'est pris en charge que dans son état par défaut. Une fois modifié, le SCIM provisionnement 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 IAM l'application 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 d'IAMIdentity Center lorsque l'utilisateur est supprimé du CyberArk rôle.

  • Déprovisionner le comportement de l'utilisateur : 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 SCIM terminaison 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. SCIMpoint de terminaison : par exemple, https://scim.us-east-2.amazonaws.com/11111111111-2222-3333-4444-555555555555/scim/v2

   2. Jeton d'accès : choisissez Afficher le jeton pour copier la valeur.

   Avertissement

   C'est le seul moment où vous pouvez obtenir le SCIM point de terminaison et le jeton d'accès. Assurez-vous de copier ces valeurs avant de continuer. Vous saisirez ces valeurs pour configurer le provisionnement automatique Okta plus loin dans ce didacticiel.

5. 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 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 SCIM provisionnement.

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 SAML pour CyberArk (Applications > Web App). Consultez Prérequis.

2. Choisissez l'application IAMIdentity 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 SCIMpoint de terminaison depuis IAM Identity Center. Collez cette valeur dans le URL champ SCIMService, dans l'application CyberArk IAM Identity Center, définissez le type d'autorisation comme en-tête d'autorisation.

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 existants IAM d'Identity Center 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 IAM d'Identity Center.

(Facultatif) Étape 3 : configurer les 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 SAML assertion à 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 SAML pour CyberArk (Applications > Applications Web).

2. Accédez à l'option SAMLRéponse.

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'SAMLassertion à IAM Identity Center.

4. 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'IAMIdentity Center pour transmettre un Attribute élément dont l'Nameattribut est défini surhttps://aws.amazon.com/SAML/Attributes/AccessControl:{TagKey}. Cet élément vous permet de transmettre des attributs sous forme de balises de session dans l'SAMLassertion. Pour plus d'informations sur les balises de session, consultez la section Transmission de balises de session AWS STS dans le guide de IAM l'utilisateur.

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.