OEE IntelliSuite · guide de l’administrateur

Connecter Microsoft Entra ID

Enregistrez une application Microsoft pour le courtier de connexion de la suite, associez les groupes Entra aux rôles de la suite et vérifiez l’accès à Pulse et Explorer.

Avant de commencer

Ce guide s’adresse à un administrateur Azure / Entra et à la personne responsable du déploiement de la suite. L’authentification et le courtier de connexion partagé de la suite doivent être activés. Obtenez l’origine HTTPS publique du courtier du déploiement, par exemple https://auth.plant.example.com, et coordonnez les modifications de configuration avec l’opérateur de la suite.

Le courtier reçoit une seule fois la connexion Microsoft et partage la session avec les applications configurées de la suite. Explorer est un client OIDC distinct du courtier ; il ne nécessite pas de second enregistrement Microsoft. Le courtier, les origines des applications et celle d’Explorer doivent relever du domaine de cookies configuré, et le routage en périphérie doit diriger le nom d’hôte du courtier vers Pulse. La configuration de déploiement de la suite doit utiliser un secret d’authentification partagé entre les applications activées.

Exemples uniquement. Remplacez tous les noms d’hôte et UUID ci-dessous par les valeurs de votre locataire et de votre déploiement. Ne placez jamais un véritable secret client dans un ticket, une capture d’écran ou le contrôle de code source.

1 · Enregistrer l’application

  1. Dans le Centre d’administration Microsoft Entra → Inscriptions d’applications → Nouvelle inscription, enregistrez une application web dans le locataire auquel appartiennent vos utilisateurs. Sélectionnez Comptes dans cet annuaire organisationnel uniquement (locataire unique). Notez l’ID d’application (client) et ID d’annuaire (locataire). Instructions d’inscription Microsoft
  2. Sous Authentification, ajoutez un URI de redirection à la plateforme Web, en utilisant exactement l’origine publique du courtier :
    https://auth.plant.example.com/api/auth/callback/microsoft
    
    L’origine doit correspondre au déploiement, y compris tout port. Ajoutez un URI exact distinct pour chaque environnement utilisant cet enregistrement ; privilégiez des enregistrements et des identifiants distincts selon les environnements. Règles Microsoft relatives aux URI de redirection
  3. Sous Certificats et secrets → Secrets client, créez un secret et copiez immédiatement sa valeur dans votre coffre de secrets approuvé. Transmettez-le de manière sécurisée à l’opérateur de la suite et consignez une date d’expiration ainsi qu’un responsable de la rotation. Le fournisseur Microsoft actuel de la suite accepte un ID client et un secret client; une information d’identification par certificat Entra ne remplace pas directement cette configuration. Instructions Microsoft relatives aux identifiants
  4. Appliquez les stratégies de consentement, d’invités, de MFA et d’accès conditionnel de votre locataire. Un enregistrement à locataire unique peut inclure les invités admis dans ce locataire. Effectuez des tests avec les comptes et stratégies prévus ; l’enregistrement de l’application ne donne pas à lui seul accès à la suite à tous les utilisateurs.

2 · Configurer les groupes et les rôles

Créez ou choisissez des groupes de sécurité Entra pour les rôles de la suite et notez l’ID d’objet, et non son nom d’affichage. Dans l’enregistrement de l’application, configurez les revendications de groupe afin que le Jeton ID contienne un tableau groups d’ID d’objet de groupes Entra. Par exemple, choisissez Groupes de sécurité dans la configuration des revendications de groupe ; ne transmettez pas les groupes comme rôles et ne remplacez pas les identifiants par des noms, des SID ou des attributs locaux. Vérifiez le jeton obtenu pour un utilisateur de test. Configuration Microsoft des revendications de groupe

Rôle de la suite Accès type
viewer Accès en lecture seule aux équipements, tâches et rapports.
employee Accès de base, y compris les pointages de travail.
supervisor Gestion des équipes et des opérations, rapports et exportations.
admin Administration complète de la suite, y compris les utilisateurs et les paramètres système.

Il s’agit de rôles de la suite. L’intégration actuelle associe les ID de groupe dans la configuration de la suite ; elle ne lit pas la revendication Entra roles. Définir des rôles d’application Entra ou affecter un groupe à un rôle d’application Entra ne suffit pas à accorder le rôle correspondant dans la suite. Le chemin pris en charge est : appartenance au groupe → jeton ID groups → association dans la suite. Référence Microsoft sur les rôles d’application

Conservez la revendication complète. Microsoft omet le tableau groups lorsque la limite de groupes du JWT est dépassée (200 groupes) ; la suite ne résout pas ce dépassement via Graph et refusera cette connexion. Si vous limitez les revendications aux Groupes affectés à l’application, affectez les groupes associés à l’application d’entreprise et faites des utilisateurs des membres directs : les appartenances imbriquées ne sont pas incluses dans ce mode. L’affectation de groupes nécessite la licence Entra appropriée (P1/P2). Détails Microsoft sur l’affectation et les licences

3 · Configurer la suite

Transmettez à l’opérateur de la suite l’ID du locataire, l’ID client, le secret par un canal approuvé et l’association ID d’objet de groupe → rôle. Dans la configuration client du déploiement, ces valeurs doivent figurer dans les env-vars de Pulse du courtier. La configuration du courtier relève du déploiement ; ne rédigez pas manuellement sa valeur dérivée AUTH_BROKER_JSON.

MICROSOFT_TENANT_ID=<tenant-uuid>
MICROSOFT_CLIENT_ID=<application-client-id>
MICROSOFT_CLIENT_SECRET=<secret-value>
AUTH_MICROSOFT_GROUP_ROLES_JSON={"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa":"viewer","bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb":"admin"}

La correspondance doit être un objet JSON non vide contenant des UUID de groupe distincts et des noms de rôle exacts en minuscules. Le paramètre du locataire doit être l’UUID de ce même locataire unique. L’association est facultative : si AUTH_MICROSOFT_GROUP_ROLES_JSON est absent, le comportement de connexion Microsoft existant est conservé et le refus des groupes non associés décrit ici ne s’applique pas. L’opérateur applique la configuration selon le processus de déploiement habituel, puis vérifie le courtier.

Appartenances multiples : le rôle associé le plus élevé prévaut, dans cet ordre : viewer → employee → supervisor → admin. Vérifiez les appartenances qui se chevauchent avant d’accorder l’accès.

4 · Accorder et vérifier l’accès

  1. Ajoutez chaque utilisateur prévu à un groupe de sécurité associé. Si l’application d’entreprise exige une affectation, affectez-y également l’utilisateur ou le groupe admissible. L’affectation à l’application d’entreprise et l’association groupe-rôle de la suite sont deux vérifications distinctes.
  2. Ouvrez la page de connexion de la suite et sélectionnez Continue with Microsoft. Authentifiez-vous avec le compte du locataire et répondez aux éventuelles demandes de MFA ou de consentement du locataire. Une nouvelle identité Microsoft associée peut être créée dès la première connexion, même si AUTH_DISABLE_SIGN_UP=true.
  3. Vérifiez le rôle et les droits attendus de l’utilisateur dans Pulse, puis ouvrez Explorer depuis Pulse et contrôlez le tableau de bord et les accès prévus. Un utilisateur sans groupe associé, avec une revendication de groupe absente ou mal formée, provenant d’un autre locataire ou faisant l’objet d’une réponse de dépassement sera refusé plutôt que de recevoir un rôle par défaut.
  4. Testez un utilisateur sans association, un utilisateur appartenant à des groupes qui se chevauchent, ainsi que des utilisateurs existants et nouveaux. Pour associer un compte local existant qui ne l’est pas encore, son rôle actuel dans la suite doit déjà correspondre au rôle associé. L’association par e-mail en locataire unique fait confiance à l’identité et aux contrôles d’admission des invités du locataire ; vérifiez qu’ils sont adaptés avant de vous y fier.
Tableau de bord Pulse du laboratoire SSO après une connexion avec un compte Microsoft
Laboratoire SSO : Pulse après une connexion Microsoft. Lors d’un test distinct de correspondance groupes-rôles, les associations admin, supervisor et viewer ont été testées et les utilisateurs non associés ont été refusés ; cette image montre la destination après connexion, et non la revendication de rôle.

Pour découvrir l’expérience de connexion des utilisateurs, consultez le Guide Microsoft de connexion unique.

Exploitation et dépannage

  • Modification ou suppression d’un rôle : la suite actualise le rôle d’un utilisateur Microsoft associé lors de sa prochaine connexion Microsoft. Si le rôle change ou si l’utilisateur n’est plus associé au moment de la connexion, les sessions de base de données sont supprimées ; les caches de session signés peuvent rester valides jusqu’à expiration. Cela ne garantit pas une révocation immédiate déclenchée par l’annuaire. En cas d’urgence, utilisez vos contrôles d’accès aux incidents et vos procédures de révocation des sessions.
  • Connexion refusée : vérifiez l’affectation au locataire et à l’application d’entreprise, l’appartenance de l’utilisateur, les ID d’objet associés exacts et les revendications tid, oid et groups du jeton ID. Vérifiez si le nombre de groupes dépasse la limite et si le filtrage des groupes affectés exige une appartenance directe. Traitez les jetons comme des informations sensibles et ne les collez pas dans des tickets d’assistance.
  • Erreur de redirection : comparez caractère par caractère l’URI de redirection Web enregistré avec l’origine publique et le chemin de rappel du courtier ; vérifiez le routage HTTPS ainsi que les ID client et locataire configurés.
  • Le compte existant ne se lie pas : comparez le rôle associé au rôle actuel dans la suite et à l’adresse e-mail du compte. Si Microsoft ne renvoie pas d’adresse e-mail, le courtier peut utiliser preferred_username comme nom de connexion non vérifié. Confirmez la propriété du compte auprès de l’administrateur de la suite avant de modifier un rôle ou d’associer des identités.
  • Rotation des identifiants : créez un secret client de remplacement, mettez à jour la configuration de déploiement sécurisée de la suite, appliquez-la et vérifiez la connexion avant de supprimer l’ancien secret. Suivez sa date d’expiration et n’exposez pas sa valeur dans les journaux.

Références

Pages Microsoft Learn consultées le 9 novembre 2026. Les détails du produit reflètent le courtier de la suite et l’implémentation des groupes et rôles ; le laboratoire SSO a vérifié des exemples associés et non associés le 6 novembre 2026.