Configurer la passerelle SCIM

TABLE DES MATIÈRES
Introduction
Rôles et responsabilités
Prérequis
Préparer Lära LMS
Créer l’application d’entreprise
Configurer le provisionnement
Mapper et synchroniser les utilisateurs
Synchroniser les branches et les groupes
Gérer les profils de droits
Mises à jour après la création
Valider en préproduction
Passer en production
Dépannage

Notes
I. Le connecteur SCIM est configuré dans le cadre d’un projet d’implantation. L’URL du locataire (Tenant URL) et le jeton secret (Secret Token) sont transmis de façon sécurisée par l’équipe Lära.
II. La validation complète sur le portail de préproduction est obligatoire avant toute synchronisation en production.
III. Le présent article suppose que les intervenants disposent des droits nécessaires dans Microsoft Entra ID et dans Lära LMS. Les accès doivent respecter le principe du moindre privilège.
IV. Le jeton secret ne doit jamais être inséré dans un document public, une capture d’écran ou un courriel non protégé. Il doit être renouvelé selon les pratiques de sécurité de l’organisation.

Introduction

SCIM (System for Cross-domain Identity Management) est une norme qui automatise l’échange d’informations sur les utilisateurs et les groupes entre Microsoft Entra ID et Lära LMS. La passerelle SCIM de Lära reçoit les données autorisées par le client, crée les éléments correspondants dans le LMS, puis applique les mises à jour ultérieures sans exiger une gestion manuelle de chaque compte.

Dans cette intégration, Microsoft Entra ID demeure la source des données synchronisées. Lära LMS reçoit les utilisateurs, leurs champs mappés, leurs appartenances ainsi que deux types de groupes : les branches de l’organigramme et les groupes administratifs. Le périmètre, les règles et les identifiants utilisés doivent être approuvés avant l’activation.

Rôles et responsabilités

La réussite de la synchronisation dépend d’un partage clair des responsabilités. Les décisions fonctionnelles doivent être prises avant la configuration technique.
IntervenantResponsabilités principales
Équipe d’implantation LäraDéfinir avec le client le périmètre; préparer le LMS, les champs personnalisés, les branches, les groupes et les profils de droits; confirmer les règles de mapping; coordonner la préproduction et l’acceptation.
Développeur interne LäraCréer et configurer la passerelle SCIM propre au projet; appliquer les règles approuvées; stocker les identifiants de liaison nécessaires; analyser les journaux techniques et corriger les erreurs du connecteur.
TI du clientCréer l’application d’entreprise dans Microsoft Entra ID; configurer les attributs, mappages, groupes et affectations; protéger le jeton; démarrer et surveiller le provisionnement; fournir les résultats et erreurs de test.
Administrateurs LäraValider les comptes créés; repositionner manuellement les branches dans la hiérarchie; vérifier les groupes et profils de droits; approuver les résultats de préproduction et surveiller les effets fonctionnels après la mise en production.

Prérequis

Avant de créer l’application, réunissez les décisions, accès et données ci-dessous. Une configuration incomplète peut créer des doublons, des comptes mal classés ou des droits trop élevés.
#PrérequisValidation attendue
1Portails Lära de préproduction et de production disponiblesLes essais seront faits en préproduction avec un jeu de données représentatif.
2Accès administratifs appropriésLes personnes autorisées peuvent gérer Lära LMS, Microsoft Entra ID, l’application d’entreprise et les attributs d’extension.
3Périmètre de synchronisation approuvéLes utilisateurs et groupes à affecter à l’application sont connus; un petit groupe pilote est prévu.
4Clé d’unicité stableL’attribut qui identifie durablement un utilisateur est défini et ne sera pas recyclé.
5Mapping des champs approuvéLa source Entra, la cible Lära, le format, les valeurs par défaut et le propriétaire de chaque champ sont consignés.
6Structure organisationnelle définieLes groupes Entra de type 1 et 2, les noms de branches, les groupes administratifs et les profils de droits sont listés.
7Connecteur Lära activéL’équipe Lära a fourni de façon sécurisée la Tenant URL et le Secret Token de préproduction.

Préparer Lära LMS

L’équipe d’implantation prépare d’abord le portail de préproduction : champs utilisateur, branches, groupes administratifs et profils de droits. Cette configuration sert de référence au développeur de la passerelle et aux TI du client.
  1. Créer ou confirmer les champs utilisateur à synchroniser (texte).
  2. Créer un champ personnalisé utilisateur de type texte destiné à recevoir l’identifiant utilisé pour relier le profil de droits Lära. Ce champ est mappé par SCIM; il remplace l’utilisation de l’API branch pour cette logique.
  3. Créer ou confirmer les profils de droits et conserver leur identifiant Lära.
  4. Préparer la liste des branches attendues et leur hiérarchie cible.
  5. Préparer la liste des groupes administratifs attendus.
  6. Transmettre au développeur interne les noms API des champs personnalisés, les identifiants des profils et les règles approuvées.

Créer l’application d’entreprise

Les TI du client créent une application d’entreprise qui représente Lära LMS dans Microsoft Entra ID.
  1. Ouvrir le portail Microsoft Entra, puis sélectionner Microsoft Entra ID.
  2. Dans le menu de gauche, sélectionner Applications d’entreprise.
  3. Sélectionner Nouvelle application, puis Créez votre propre application.
  4. Donner un nom explicite à l’application, par exemple « Lära LMS – SCIM – Préproduction ».
  5. Sélectionner l’option correspondant à une application non répertoriée à intégrer, puis sélectionner Créer.

Configurer le provisionnement

Dans l’application d’entreprise, ouvrez Provisionnement et sélectionnez le mode Automatique. Saisissez uniquement les paramètres du portail visé.
Paramètre EntraValeurPrécaution
Mode de provisionnementAutomatiqueNe pas démarrer le provisionnement avant d’avoir terminé les mappages et les affectations pilotes.
URL du locataire
(Tenant URL)
URL du point de terminaison fournie par l’équipe LäraUtiliser l’URL de préproduction pendant les essais; ne pas la modifier ni l’inventer.
Jeton secret
(Secret Token)
Jeton d’autorisation fourni par l’équipe LäraConserver le jeton dans un emplacement sécurisé et limiter son accès.
  1. Sélectionner Tester la connexion.
  2. Si le test réussit, sélectionner Enregistrer.
  3. Dans Mappages, configurer séparément Provisionner les utilisateurs Azure Active Directory et Provisionner les groupes Azure Active Directory.
  4. Dans Utilisateurs et groupes, affecter uniquement le groupe pilote et les groupes nécessaires au test.
  5. Une fois les mappages vérifiés, sélectionner Démarrer le provisionnement.

Mapper et synchroniser les utilisateurs

Chaque attribut source Entra doit être lié à un champ cible Lära de type compatible. Le tableau suivant résume les champs utilisateur disponibles dans Lära. Leur inclusion réelle dans SCIM dépend du périmètre approuvé et de la configuration de la passerelle.
Champ LäraUtilisationRègle ou format important
loginIdentifiant de connexionChaîne unique sur le serveur, de 4 à 250 caractères. Choisir une source stable.
firstNamePrénomChaîne de 50 caractères ou moins.
lastNameNom de familleChaîne de 50 caractères ou moins.
emailAdresse courrielCourriel valide, de 100 caractères ou moins.
languageLangue d’affichage1 = Français (Canada), 2 = Anglais, 3 = Français (France), 4 = Espagnol. Si vide, la langue par défaut de l’organisation est utilisée.
companyNameOrganisationChaîne de 100 caractères ou moins.
functionTitleFonction ou titreChaîne de 100 caractères ou moins.
phoneHome
phoneMobile
phoneWork
Numéros de téléphoneChaque valeur contient au plus 40 caractères.
phonePublicNuméro rendu public dans Via0 = aucun, 1 = mobile, 2 = domicile, 3 = travail. La valeur par défaut est 0.
timeZoneFuseau horaireValeur numérique de la liste Lära/Via; si vide, le fuseau de l’organisation est utilisé.
billToNameNom de facturationChaîne de 250 caractères ou moins.
address
Adresse100 caractères ou moins
address2Adresse 2100 caractères ou moins
postalCode
Code postal
50 caractères ou moins
cityVille100 caractères ou moins
countryId
PaysIdentifiants numériques correspondant aux constantes Lära; ne pas envoyer un libellé si un ID est attendu.
stateIdProvince/ÉtatIdentifiants numériques correspondant aux constantes Lära; ne pas envoyer un libellé si un ID est attendu.
portalIdPortail par défautIdentifiant Lära du portail; valider la valeur dans chaque environnement.
expirationDateDate d’expirationValider le format attendu et le comportement en cas de valeur vide.
customFieldsChamps personnalisésLe champ doit exister dans Lära et son nom API doit être utilisé dans l’attribut cible SCIM. Champs TEXTE seulement.

Règles de mapping

  1. Une seule source par cible : documenter l’attribut Entra retenu pour chaque champ Lära.
  2. Clé stable : ne pas modifier la clé d’unicité après le premier provisionnement sans analyse, car cela peut créer un doublon plutôt que mettre à jour le compte existant.
  3. Types compatibles : convertir explicitement les nombres, booléens, dates et identifiants. Définir le traitement des valeurs vides.
  4. Valeurs contrôlées : utiliser les constantes Lära pour la langue, le fuseau horaire, le pays, la province ou l’État et les autres listes codées.
  5. Longueurs maximales : tronquer seulement si cette décision est approuvée; autrement, corriger la donnée source et consigner l’erreur.
  6. Champs personnalisés : créer d’abord le champ dans Lära, puis l’ajouter à la liste des attributs de l’application personnalisée dans Entra.

Ajouter un champ utilisateur personnalisé

Dans Provisionnement > Mappages > Provisionner les utilisateurs Azure Active Directory, affichez les options avancées, puis sélectionnez Modifier la liste d’attributs pour les applications personnalisées. Ajoutez l’attribut cible selon la syntaxe suivante :

urn:ietf:params:scim:schemas:extension:lara:2.0:Custom:custom_field_ApiName

Remplacez custom_field_ApiName par le nom API exact du champ Lära. Par exemple, pour un champ dont le nom API est AzureIdentifier, utilisez :

urn:ietf:params:scim:schemas:extension:lara:2.0:Custom:AzureIdentifier

Associez ensuite l’attribut source Entra à cette cible, confirmez un type compatible et enregistrez le mappage. Après la création initiale, les mises à jour de ce champ sont transmises automatiquement lorsque le provisionnement détecte une modification.

Synchroniser les branches et les groupes

La configuration BranchGroup utilise un attribut de type pour déterminer si un groupe Entra devient une branche de l’organigramme ou un groupe administratif dans Lära.
GroupTypeCréé dans LäraUtilisation
1Branche LäraDivision de l’organigramme à laquelle des utilisateurs sont rattachés avec un profil de droits.
2Groupe administratif LäraRegroupement utilisé pour des actions administratives, par exemple inscrire plusieurs personnes à une formation ou à un programme.

Créer les attributs d’extension de groupe

Les TI créent deux propriétés d’extension de type chaîne dans l’application Entra : GroupType et GroupParentId, toutes deux ciblées sur l’objet Group. Lors de la création par Microsoft Graph, utilisez l’ID de l’objet application, et non son appId. Cette opération peut être réalisée avec Microsoft Graph Explorer.

Section réservée aux TI : les exemples ci-dessous contiennent des espaces réservés. Remplacez-les uniquement par les identifiants de votre locataire et de vos groupes.

  1. Répertorier les applications du locataire avec GET https://graph.microsoft.com/v1.0/applications, puis relever la propriété id de l’application visée.
  2. Créer l’extension GroupType avec une requête POST https://graph.microsoft.com/v1.0/applications/{id}/extensionProperties et le corps suivant :
{
  "name": "GroupType",
  "dataType": "string",
  "targetObjects": [
    "Group"
  ]
}
  1. Créer l’extension GroupParentId au même point de terminaison avec le corps suivant :
{
  "name": "GroupParentId",
  "dataType": "string",
  "targetObjects": [
    "Group"
  ]
}
  1. Mettre à jour chaque groupe avec PATCH https://graph.microsoft.com/v1.0/groups/{GROUP_ID}. Le nom réel de l’extension prend la forme extension_xxxxxxxAppIdxxxxxxxx_GroupType.
{
  "extension_xxxxxxxAppIdxxxxxxxx_GroupType": "1 ou 2"
}
  1. Vérifier les valeurs avec une requête GET qui sélectionne explicitement les extensions, car Microsoft Graph v1.0 ne retourne pas les attributs d’extension de groupe par défaut :

GET https://graph.microsoft.com/v1.0/groups/{GROUP_ID}?$select=id,displayName,extension_xxxxxxxAppIdxxxxxxxx_GroupType,extension_xxxxxxxAppIdxxxxxxxx_GroupParentId

Attribut source EntraAttribut cible SCIM
GroupTypeurn:ietf:params:scim:schemas:extension:lara:2.0:groups:type
GroupParentIdurn:ietf:params:scim:schemas:extension:lara:2.0:groups:parentid

Dans Provisionnement > Mappages > Provisionner les groupes Azure Active Directory, ajoutez ces deux cibles à la liste des attributs personnalisés, puis créez les mappages source-cible ci-dessus. Affectez ensuite à chaque groupe la valeur 1 ou 2 dans GroupType.

Important : dans le processus décrit ici, la création SCIM ne reproduit pas automatiquement les niveaux ni l’imbrication des groupes Entra. Les branches sont créées au même niveau dans Lära. Après la création initiale, un administrateur Lära doit déplacer manuellement chaque branche sous son parent dans l’organigramme. L’attribut GroupParentId peut être transmis selon la configuration technique, mais il ne remplace pas cette validation et ce repositionnement manuels.

Gérer les profils de droits

Un profil de droits détermine ce qu’un utilisateur peut faire dans une branche. La règle doit être simple, stable et validée avant le premier provisionnement.
RègleComportement
Aucun profil préciséLe profil utilisateur est appliqué par défaut.
Profil préciséLe mapping doit utiliser l’ID du profil de droits Lära, et non seulement son libellé.
Un profil par utilisateurSCIM synchronise un seul profil de droits par utilisateur. Ce profil est appliqué à toutes les branches de cet utilisateur.
Liaison durableLa passerelle doit stocker côté SCIM l’identifiant permettant de relier la valeur source au profil de droits Lära.
Champ recommandéUtiliser un champ utilisateur personnalisé Lära de type texte, mappé par SCIM, plutôt que l’API branch.

Exemple : si un utilisateur est synchronisé avec le profil « gestionnaire », ce même profil « gestionnaire » s’applique à chacune de ses branches. Il n’est pas possible, dans cette logique, de lui attribuer par SCIM un profil différent selon la branche. Toute exception doit être analysée avant la production afin d’éviter une élévation de droits involontaire.

Mises à jour après la création

Une fois l’utilisateur ou le groupe créé et correctement lié, les cycles de provisionnement suivants appliquent les changements détectés dans les attributs mappés.
  • Les modifications d’un champ utilisateur mappé sont reportées dans Lära.
  • Les appartenances aux branches et aux groupes administratifs sont mises à jour selon les groupes Entra affectés et leur GroupType.
  • Le profil de droits synchronisé est mis à jour selon l’identifiant de liaison et s’applique à toutes les branches de l’utilisateur.
  • Les groupes et branches déjà liés sont mis à jour par la passerelle; leur création initiale ne doit pas être répétée avec un nouvel identifiant.
  • Le repositionnement manuel des branches dans la hiérarchie Lära doit être conservé et vérifié après les synchronisations.

Précaution : validez en préproduction le comportement de suppression, de désactivation, de retrait d’affectation et de changement de clé avant de l’autoriser en production. Ces actions peuvent avoir des effets différents d’une simple mise à jour de champ.

Valider en préproduction

Utilisez un groupe pilote comprenant au minimum un utilisateur standard, un utilisateur ayant un profil de droits particulier, un utilisateur membre de plusieurs branches et un groupe administratif. Exécutez les scénarios ci-dessous et conservez les preuves de résultat.
#TestRésultat attendu
1Tester la connexionLa Tenant URL et le Secret Token sont acceptés.
2Créer un utilisateur standardUn seul compte est créé avec les champs attendus et le profil « utilisateur » si aucun autre profil n’est fourni.
3Modifier un champ standard et un champ personnaliséLes nouvelles valeurs apparaissent sur le même compte, sans doublon.
4Créer un groupe de GroupType 1Une branche Lära est créée au niveau initial prévu.
5Repositionner la brancheL’administrateur la place manuellement sous le bon parent et confirme la hiérarchie.
6Créer un groupe de GroupType 2Un groupe administratif Lära est créé et peut être utilisé pour une action de groupe.
7Ajouter et retirer un utilisateur d’un groupe piloteLes appartenances Lära sont mises à jour selon la règle approuvée.
8Appliquer un profil de droits non standardL’ID du profil est résolu et le même profil est appliqué à toutes les branches de l’utilisateur.
9Envoyer une valeur vide ou invalide contrôléeLe comportement correspond à la règle approuvée; aucune donnée critique n’est écrasée silencieusement.
10Tester désactivation, retrait d’affectation et reprovisionnementLe résultat est documenté et approuvé avant la production.

Critères d’acceptation

  • Aucune erreur bloquante ne demeure dans les journaux de provisionnement.
  • Aucun doublon n’est créé pendant un reprovisionnement.
  • Les champs obligatoires et les champs personnalisés approuvés sont exacts.
  • Les branches et groupes sont créés dans le bon type.
  • La hiérarchie des branches a été repositionnée et validée dans Lära.
  • Le profil de droits est correct, unique par utilisateur et appliqué à toutes ses branches.
  • Les cas de retrait, de désactivation et d’erreur ont un comportement connu et accepté.
  • Le propriétaire fonctionnel et les TI du client ont confirmé le passage en production.

Passer en production

La production reprend la configuration approuvée en préproduction, avec les paramètres propres au portail de production. Ne copiez jamais l’URL ou le jeton de préproduction dans l’application de production.
  1. Faire approuver les résultats et le plan de retour arrière.
  2. Obtenir de façon sécurisée la Tenant URL et le Secret Token de production.
  3. Reproduire les attributs et mappages approuvés; vérifier les identifiants qui diffèrent entre les environnements.
  4. Affecter d’abord un groupe pilote de production.
  5. Démarrer le provisionnement et surveiller le premier cycle.
  6. Comparer les résultats avec la préproduction, puis élargir progressivement le périmètre.
  7. Repositionner les nouvelles branches dans la hiérarchie Lära et documenter le résultat.

Limites et précautions

  • La hiérarchie Entra n’est pas reproduite automatiquement : les branches sont créées au même niveau, puis déplacées manuellement dans Lära.
  • Un seul profil de droits est synchronisé par utilisateur et s’applique à toutes ses branches.
  • Les noms de groupes et de profils ne remplacent pas les identifiants stables nécessaires à la liaison.
  • Les champs personnalisés doivent exister dans Lära avant leur ajout au schéma et au mapping Entra.
  • Une donnée source invalide, trop longue ou du mauvais type peut bloquer le provisionnement de l’objet.
  • Les changements de clé, les suppressions et les désactivations exigent des tests spécifiques.
  • Le connecteur est semi-manuel et propre au projet : toute évolution de structure ou de règle doit être coordonnée avec l’équipe Lära.

Dépannage

Commencez par consulter le statut et les journaux de provisionnement de l’application Entra. Relevez l’heure, l’objet visé, l’opération, le message complet et l’identifiant de corrélation avant de transmettre une demande.
SymptômeVérificationsCorrectif
Échec du test de connexionEnvironnement, Tenant URL, jeton, espaces ajoutés, expiration ou révocation.Ressaisir les valeurs fournies de façon sécurisée. Si nécessaire, demander le renouvellement du jeton.
Utilisateur non crééAffectation à l’application, portée du provisionnement, champs obligatoires, unicité du login, format du courriel.Corriger la source ou le mapping, puis relancer le provisionnement de l’objet.
Doublon d’utilisateurAttribut de correspondance ou clé d’unicité modifiée; compte existant non lié.Arrêter l’élargissement du périmètre, analyser les identifiants et établir la liaison correcte avant de reprendre.
Champ personnalisé absentExistence du champ dans Lära, nom API exact, URN cible et type de donnée.Créer le champ dans Lära, ajouter l’attribut personnalisé dans Entra, puis recréer le mapping avec l’URN exacte.
Groupe créé dans le mauvais typeValeur GroupType et mapping vers groups:type.Utiliser 1 pour une branche et 2 pour un groupe administratif, puis reprovisionner selon la procédure approuvée.
Branche au mauvais niveauCréation initiale et position actuelle dans l’organigramme.Déplacer manuellement la branche dans Lära; l’imbrication n’est pas créée automatiquement.
Profil de droits incorrectID du profil, champ texte personnalisé, liaison côté SCIM et présence de plusieurs valeurs concurrentes.Corriger le mapping par ID et conserver une seule valeur de profil par utilisateur.
Mise à jour non appliquéeAttribut inclus dans le mapping, portée, cycle de provisionnement, erreur récente et liaison existante.Corriger le mapping ou la donnée, puis relancer l’objet sans changer sa clé.
Retrait ou désactivation inattenduRègle de portée, affectation Entra, action exécutée et résultat observé en préproduction.Suspendre l’action en production, reproduire le cas en préproduction et faire confirmer la règle par les équipes Lära et TI.

Informations à fournir au soutien : environnement concerné, nom de l’application d’entreprise, date et heure du problème, type d’objet, action attendue, résultat obtenu, message d’erreur complet et identifiant de corrélation. Ne transmettez jamais le Secret Token.

Cette réponse a-t-elle été utile ? Oui Non

Envoyer vos commentaires
Désolés de n'avoir pu vous être utile. Aidez-nous à améliorer cet article en nous faisant part de vos commentaires.