Passer au contenu principal

Comment utiliser le provisioning SCIM de Microsoft Entra

Ce document dĂ©crit comment configurer votre tenant Microsoft Entra afin de l’utiliser pour provisionner des employĂ©s et des groupes dans Riot.

💡 PrĂ©-requis : le provisionnement SCIM est inclus dans certaines offres Riot. Si vous y aviez dĂ©jĂ  accĂšs, il reste disponible sans dĂ©marche de votre part. Si la section « SCIM Provisioning » n'apparaĂźt pas dans votre workspace, contactez votre interlocuteur Riot ou notre Ă©quipe via le chat, ou Ă  l'adresse [email protected].

❶ Activer SCIM sur Riot

Connectez-vous Ă  votre workspace Riot, puis allez dans Settings > Workforce.

Une section intitulée « SCIM Provisioning » est disponible. Cliquez sur le bouton « Connect » pour commencer.

Sélectionnez « Microsoft », puis cliquez sur « Continue ».

Lors de la premiĂšre Ă©tape, vous devez vous connecter via le SSO Microsoft. Cliquez sur le bouton « Connect », puis connectez-vous Ă  Microsoft. Vous ĂȘtes redirigĂ© vers Riot une fois la connexion terminĂ©e.

❷ CrĂ©er une application Microsoft Entra pour le provisionnement SCIM

Connectez-vous au centre d'administration Microsoft Entra. Dans la barre latérale gauche, allez dans Entra ID > Applications d'entreprise.

Cliquez sur « New application ». Vous ĂȘtes redirigĂ© vers la galerie d'applications Microsoft Entra.

Cliquez sur « Create your own application ».

Dans le panneau de droite, saisissez « Riot SCIM Provisioning ». Le nom est libre, vous pouvez en utiliser un autre. Assurez-vous que l'option « Integrate any other application you don't find in the gallery (Non-gallery) » est bien sélectionnée.

Cliquez sur « CrĂ©er ». Une fois l'application créée, vous ĂȘtes redirigĂ© vers ses paramĂštres.

Cliquez sur « Provisioning ».

Cliquez sur « Connect your application ».

Assurez-vous que « Authentification Bearer » est sélectionnée dans le champ « Sélectionner la méthode d'authentification ».

Sur Riot, copiez l'« URL du point de terminaison SCIM » dans le champ « URL du locataire » de Microsoft Entra.

Cliquez sur « Générer un jeton Bearer » sur Riot, et copiez la valeur dans le champ « Jeton secret » de Microsoft Entra.

Cliquez sur « Tester la connexion ». Une notification vous indique que le test a réussi.

Vous pouvez maintenant cliquer sur « Create ».

❞ Configurer le provisionnement des groupes

Allez dans « Mappage des attributs ».

La configuration par défaut permet le provisionnement des groupes. Si vous ne souhaitez pas que Microsoft Entra crée des groupes dans Riot, cliquez sur « Provisionner les groupes Microsoft Entra ID », passez l'option « Activé » sur Non dans l'écran suivant, puis cliquez sur « Enregistrer ».

Les mappages d'attributs recommandés pour les groupes correspondent à la configuration par défaut, comme le montre la capture suivante :

âč Configurer le provisionnement des employĂ©s

Retournez dans « Mappage des attributs » (Attribute Mapping) et cliquez sur « Provision Microsoft Entra ID Users ».

La configuration par défaut envoie des données que Riot n'utilise pas. Effectuez les modifications suivantes :

  • displayName : supprimer.

  • emails[type eq "work"].value :

    • si l'attribut mail est correctement rempli dans votre tenant Entra, laissez-le tel quel ;

    • s'il ne l'est pas et que vous utilisez l'adresse e-mail comme userPrincipalName, cliquez sur « Modifier » (Edit) et sĂ©lectionnez userPrincipalName comme attribut source (Source Attribute).

  • name.formatted : supprimer.

  • Tout ce qui contient addresses[type eq "work"] : supprimer.

  • Tout ce qui contient phoneNumber : supprimer.

  • urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber : supprimer.

Cliquez sur « Enregistrer » (Save) pour sauvegarder ces modifications.

  • externalId : Modifier (Edit) > sĂ©lectionnez objectId comme attribut source (Source attribute) et cliquez sur OK.

  • Cliquez sur « Enregistrer » (Save).

Cliquez sur « Afficher les options avancées » (Show advanced options), puis sur « Modifier la liste des attributs pour customappsso » (Edit attribute list for customappsso), et effectuez les modifications suivantes :

  • emails[type eq "work"].value : cochez Obligatoire (Required).

  • name.givenName : cochez Obligatoire (Required).

  • name.familyName : cochez Obligatoire (Required).

Les mappages d'attributs recommandés (Attribute Mappings) sont illustrés dans la capture suivante :

âș Configurer les paramĂštres restants

Dans les paramÚtres de l'application, allez dans « Provisioning » et cliquez sur « Settings » pour afficher des paramÚtres supplémentaires :

  • Envoyer une notification par e-mail en cas d'Ă©chec : activez cette option pour ĂȘtre averti en cas d'erreur de provisionnement, saisissez votre adresse e-mail, puis cliquez sur « Save ».

  • PĂ©rimĂštre (Scope) : par dĂ©faut, Entra ne provisionne que les utilisateurs et groupes attribuĂ©s. Pour provisionner tous les utilisateurs et tous les groupes, sĂ©lectionnez cette option et cliquez sur « Save ».

Si vous avez laissé le Scope sur « Sync only assigned users and groups », attribuez maintenant vos utilisateurs et groupes :

  • allez dans « Users and groups » et cliquez sur « Add user/group » ;

  • cliquez sur « None Selected », sĂ©lectionnez des utilisateurs ou des groupes, puis cliquez sur « Assign ».

❻ Tester le provisionnement sur quelques utilisateurs

  • Allez dans « Provisioning on Demand » et recherchez les utilisateurs ou groupes Ă  provisionner Ă  la demande.

  • Si vous provisionnez un groupe, choisissez 5 utilisateurs au maximum, puis cliquez sur « Provision » pour vĂ©rifier que tout fonctionne.

❌ DĂ©marrer le provisionnement

  • Allez dans « Overview » et cliquez sur « Start Provisioning ».

  • Le provisionnement s'exĂ©cute Ă  intervalles fixes, toutes les 40 minutes. Il ne dĂ©marre donc pas immĂ©diatement : attendez que le service de provisionnement Microsoft Entra ait traitĂ© l'ensemble de vos utilisateurs et groupes.

À retenir

  • SCIM se connecte depuis Settings > Workforce, section « SCIM Provisioning ».

  • CĂŽtĂ© Entra, crĂ©ez une application hors galerie et renseignez l'URL du point de terminaison SCIM et le jeton Bearer gĂ©nĂ©rĂ©s par Riot.

  • Retirez les attributs inutiles et rendez obligatoires l'e-mail, le prĂ©nom et le nom.

  • Le provisionnement s'exĂ©cute toutes les 40 minutes.

Avez-vous trouvé la réponse à votre question ?