Configurer le SSO avec Microsoft Entra ID
Créez une application d’entreprise pour Lingo.dev dans Microsoft Entra ID, affectez des utilisateurs, connectez-la à votre organisation et provisionnez des membres via SCIM.
Ce guide vous explique comment connecter Microsoft Entra ID à Lingo.dev via SAML 2.0. Vous devez disposer au minimum du rôle Administrateur d’application cloud dans Entra et être Propriétaire d’une organisation Lingo.dev avec un forfait Enterprise. Pour en savoir plus sur le fonctionnement du SSO dans Lingo.dev, consultez Authentification unique.
Gardez Paramètres → SSO ouvert dans Lingo.dev. Vous y copierez deux valeurs à coller dans Entra.
Créer l’application d’entreprise #
- Connectez-vous au centre d’administration Microsoft Entra.
- Accédez à Entra ID → Applications d’entreprise → Toutes les applications, puis sélectionnez Nouvelle application.
- Sélectionnez Créer votre propre application.
- Saisissez
Lingo.devcomme nom, choisissez Intégrer une autre application que vous ne trouvez pas dans la galerie (hors galerie), puis sélectionnez Créer.
Configurer SAML #
- Dans la nouvelle application, ouvrez Authentification unique et choisissez SAML.
- Dans Configuration SAML de base, sélectionnez Modifier.
- Sous Identificateur (ID d’entité), sélectionnez Ajouter un identificateur et collez
https://auth.lingo.dev/auth/v1/sso/saml/metadata(l’ID d’entité dans Lingo.dev). - Sous URL de réponse (URL du service consommateur d’assertion), sélectionnez Ajouter une URL de réponse et collez
https://auth.lingo.dev/auth/v1/sso/saml/acs(l’URL ACS dans Lingo.dev). - Laissez URL de connexion, État de relais et URL de déconnexion vides pour le moment. Sélectionnez Enregistrer. Vous renseignerez l’URL de connexion une fois la connexion établie, à l’étape Se connecter depuis Microsoft My Apps.
Conservez les Attributs & revendications par défaut. Les applications créées dans le centre d’administration Entra envoient l’adresse e-mail de l’utilisateur dans la revendication emailaddress, à partir de user.mail, ainsi qu’un identificateur de nom au format e-mail. Assurez-vous que chaque utilisateur qui se connecte possède une adresse e-mail dans Entra.
Une application créée sans les revendications par défaut, par exemple via l’API Microsoft Graph, n’envoie aucune adresse e-mail. La connexion échoue alors avec le message « Votre fournisseur d’identité n’a pas envoyé d’adresse e-mail. » Dans Attributs & revendications, ajoutez la revendication d’adresse e-mail avec l’attribut source user.mail.
Copier l’URL des métadonnées #
Dans Certificats SAML, copiez l’URL des métadonnées de fédération de l’application.
Affecter des utilisateurs et des groupes #
- Dans l’application, ouvrez Utilisateurs et groupes, puis sélectionnez Ajouter un utilisateur/groupe.
- Sous Utilisateurs et groupes, sélectionnez Aucune sélection, choisissez les utilisateurs ou les groupes, puis sélectionnez Sélectionner.
- Sélectionnez Affecter.
- Ouvrez Propriétés, réglez Affectation requise ? sur Oui, puis sélectionnez Enregistrer.
Lorsque Affectation requise ? est réglé sur Oui, seuls les utilisateurs affectés peuvent se connecter à Lingo.dev via Entra. Avec Non, tous les utilisateurs de votre locataire peuvent accéder à l’application, y compris les comptes invités. Lingo.dev n’autorise toutefois que les comptes appartenant à vos domaines connectés à rejoindre l’organisation ; tous les autres sont déconnectés. Pour les applications créées via l’API Microsoft Graph, ce paramètre est réglé sur Non par défaut. L’affectation de groupes nécessite Microsoft Entra ID P1 ou P2. Avec l’offre gratuite, affectez les utilisateurs un par un.
Établir la connexion dans Lingo.dev #
- Ouvrez Paramètres → SSO.
- Collez l’URL des métadonnées de fédération de l’application dans URL des métadonnées du fournisseur d’identité.
- Dans Domaines de messagerie, saisissez les domaines de messagerie de votre entreprise, séparés par des virgules.
- Sélectionnez Connecter.
Si un domaine est refusé, consultez Règles relatives aux domaines.
Tester la connexion #
- Ouvrez une fenêtre de navigation privée et accédez à la page de connexion de Lingo.dev.
- Sélectionnez Continuer avec le SSO, saisissez l’adresse e-mail d’un utilisateur affecté, puis sélectionnez Se connecter.
- Connectez-vous avec Microsoft.
Vous revenez dans Lingo.dev en tant que membre de l’organisation. Vérifiez l’adresse e-mail affichée sur la page des organisations : elle correspond au compte utilisé pour la connexion Microsoft, et pas nécessairement à l’adresse que vous avez saisie. Si une session Microsoft est déjà ouverte dans le navigateur, par exemple avec le compte administrateur qui a configuré l’application, Microsoft utilise ce compte sans demander de mot de passe. C’est pourquoi vous devez effectuer le test dans une fenêtre de navigation privée.
Lancez le test depuis Lingo.dev plutôt qu’avec le bouton Tester dans Entra. Tant que vous n’avez pas renseigné l’URL de connexion, la vignette Lingo.dev dans Microsoft My Apps ne vous connecte pas : vous arrivez sur la page d’accueil de Lingo.dev sans être connecté.
Si votre locataire utilise les paramètres de sécurité par défaut, Microsoft demande à chaque utilisateur d’enregistrer une application d’authentification lors de sa première connexion. Cette opération peut dépasser le délai d’attente de Lingo.dev (environ 5 minutes). La première tentative échoue alors avec le message « L’authentification unique a pris trop de temps. Réessayez. » Il suffit de réessayer pour se connecter.
Une fois le test réussi, vous pouvez rendre le SSO obligatoire. Attribuez d’abord le rôle Propriétaire à votre propre compte SSO, comme indiqué dans Activer le SSO.
Se connecter depuis Microsoft My Apps #
Renseignez l’URL de connexion pour permettre aux utilisateurs de se connecter depuis la vignette Lingo.dev dans My Apps.
- Dans Lingo.dev, ouvrez Paramètres → SSO et copiez le Lien de connexion au tableau de bord. Il ressemble à
https://lingo.dev/auth/sso?domain=example.com. - Dans Entra, ouvrez l’application Lingo.dev et sélectionnez Authentification unique.
- Dans Configuration SAML de base, sélectionnez Modifier.
- Collez le lien dans URL de connexion. Sélectionnez Enregistrer.
La vignette Lingo.dev dans My Apps ouvre désormais ce lien. Lingo.dev redirige l’utilisateur vers Microsoft, puis le ramène dans Lingo.dev, connecté, sans lui demander son adresse e-mail.
Provisionner des membres avec SCIM #
Entra peut gérer les membres de Lingo.dev via SCIM et leur attribuer des rôles à l’aide de groupes. Configurez d’abord le SSO en suivant ce guide. Pour en savoir plus sur le fonctionnement de SCIM dans Lingo.dev, consultez Provisionner des membres avec SCIM.
- Dans Lingo.dev, générez une clé SCIM.
- Dans Entra, ouvrez l’application d’entreprise Lingo.dev et sélectionnez Provisionnement.
- Réglez Mode de provisionnement sur Automatique.
- Sous Informations d’identification de l’administrateur, collez l’URL de base SCIM de Lingo.dev,
https://api.lingo.dev/v2/scim, dans URL du locataire. Collez la clé SCIM dans Jeton secret. - Sélectionnez Tester la connexion, puis Enregistrer.
- Conservez les mappages d’attributs par défaut. Lingo.dev récupère
userNameà partir deuserPrincipalNameet l’adresse e-mail professionnelle à partir demail. - Sous Paramètres, réglez Étendue sur Synchroniser uniquement les utilisateurs et les groupes affectés.
- Sélectionnez Démarrer le provisionnement.
L’invitation est envoyée à l’adresse mail de l’utilisateur. Chaque utilisateur que vous affectez doit donc en posséder une sur un domaine connecté. Un userPrincipalName différent de mail ne pose pas de problème.
Chaque utilisateur que vous affectez reçoit une invitation en attente dans Lingo.dev et devient membre lors de sa première connexion SSO.
Entra effectue le provisionnement par cycles, environ toutes les 40 minutes. Les modifications et les suppressions sont donc transmises à Lingo.dev au cycle suivant. Pour provisionner un utilisateur immédiatement, utilisez Provisionner à la demande.
Lorsque vous retirez l’affectation d’un utilisateur, Entra envoie une désactivation, et non une suppression, et Lingo.dev le retire de l’organisation. Consultez Retirer des personnes.
Définir les rôles avec les groupes Entra #
- Assurez-vous que le groupe Entra porte le même nom qu’un rôle Lingo.dev, par exemple
Translator. - Affectez le groupe à l’application dans Utilisateurs et groupes.
Entra associe le groupe au rôle du même nom et provisionne ses membres en leur attribuant ce rôle. Les personnes que vous retirez du groupe perdent ce rôle. Si le groupe était la seule affectation d’un utilisateur, son retrait du groupe entraîne aussi son retrait de Lingo.dev.
Dépannage #
| Problème | Solution |
|---|---|
Microsoft affiche AADSTS700016 : « L’application avec l’identificateur '…' est introuvable dans l’annuaire ». | L’Identificateur (ID d’entité) ne correspond pas exactement à https://auth.lingo.dev/auth/v1/sso/saml/metadata. Corrigez-le dans Configuration SAML de base. |
Microsoft affiche AADSTS50011 : « L’URL de réponse ne correspond pas aux URL de réponse configurées pour l’application ». | Renseignez exactement https://auth.lingo.dev/auth/v1/sso/saml/acs dans URL de réponse (URL du service consommateur d’assertion). |
Microsoft affiche AADSTS50105 : l’utilisateur n’est pas affecté à l’application. | Dans Utilisateurs et groupes, affectez l’utilisateur ou un groupe auquel il appartient. |
| Une personne non affectée s’est connectée, ou Lingo.dev affiche une adresse e-mail que vous n’avez pas saisie. | Affectation requise ? est réglé sur Non, ou une session Microsoft était déjà ouverte dans le navigateur avec un autre compte. Réglez Affectation requise ? sur Oui dans Propriétés, puis effectuez le test dans une fenêtre de navigation privée. |
| Lingo.dev indique que votre adresse e-mail n’appartient pas à un domaine utilisé par votre organisation pour l’authentification unique. | Microsoft a utilisé un compte dont le domaine ne fait pas partie de vos domaines connectés, souvent un compte invité ou celui de l’administrateur qui a créé le locataire. Connectez-vous avec un compte professionnel ou ajoutez son domaine dans Paramètres → SSO. |
| Lingo.dev affiche « Votre fournisseur d’identité n’a pas envoyé d’adresse e-mail ». | L’application n’envoie aucune revendication d’adresse e-mail, ou l’utilisateur ne possède pas d’adresse e-mail dans Entra. Ajoutez la revendication d’adresse e-mail (user.mail) dans Attributs & revendications, puis renseignez l’adresse e-mail de l’utilisateur. |
| Lingo.dev affiche « L’authentification unique a pris trop de temps. Réessayez. » | La connexion Microsoft a dépassé le délai d’environ 5 minutes, souvent lors de l’enregistrement d’une application d’authentification. Réessayez depuis Lingo.dev. La tentative suivante fonctionne. |
| Lingo.dev affiche « Vous êtes connecté, mais nous n’avons pas pu vous ajouter à votre organisation. » | Reconnectez-vous avec le SSO. Si le problème persiste, demandez à un Propriétaire de vérifier que Paramètres → SSO affiche Connecté depuis. |
| Lingo.dev affiche « L’authentification unique n’a pas abouti ». | Comparez l’Identificateur (ID d’entité) et l’URL de réponse aux valeurs indiquées dans Lingo.dev, puis réessayez. |
Tester la connexion ou le provisionnement échoue avec 401 Unauthorized. | La clé SCIM a été renouvelée ou révoquée. Collez la clé actuelle dans Jeton secret ou générez-en une nouvelle dans Lingo.dev. |
| Un utilisateur affecté n’apparaît pas dans Paramètres → Équipe, dans l’onglet Invitations. | Attendez le prochain cycle de provisionnement ou utilisez Provisionner à la demande. Vérifiez que le mail de l’utilisateur appartient à un domaine connecté. |
Pour les autres messages, consultez Dépannage.