Configurer le SSO avec Okta

Créez une application SAML pour Lingo.dev dans Okta, affectez-y des personnes, connectez-la à votre organisation et provisionnez les membres via SCIM.

Ce guide vous explique comment connecter Okta à Lingo.dev via SAML 2.0. Vous devez disposer d’un compte administrateur Okta permettant de créer des intégrations d’applications 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 allez y copier deux valeurs à renseigner dans Okta.

Créer l’intégration d’application #

  1. Connectez-vous à la console d’administration Okta.
  2. Accédez à Applications → Applications (Applications et ressources → Applications dans les consoles d’administration plus récentes), puis sélectionnez Créer une intégration d’application.
  3. Choisissez SAML 2.0, puis sélectionnez Suivant.
  4. Dans Nom de l’application, saisissez Lingo.dev. Sélectionnez Suivant.

Configurer SAML #

Renseignez les champs suivants et laissez les autres à leur valeur par défaut :

Champ OktaValeur
URL d’authentification uniquehttps://auth.lingo.dev/auth/v1/sso/saml/acs (l’URL ACS dans Lingo.dev)
Utiliser cette URL comme URL du destinataire et URL de destinationCoché
URI d’audience (ID d’entité du SP)https://auth.lingo.dev/auth/v1/sso/saml/metadata (l’ID d’entité dans Lingo.dev)
RelayState par défautVide
Format de l’identifiant de nomAdresse e-mail
Nom d’utilisateur de l’applicationE-mail

Dans Déclarations d’attributs, ajoutez un attribut :

NomFormat du nomValeur
emailNon spécifiéuser.email

En définissant Format de l’identifiant de nom sur Adresse e-mail et en ajoutant cet attribut email, vous permettez à Okta d’envoyer l’adresse e-mail dont Lingo.dev a besoin.

Les organisations Okta plus récentes n’affichent plus Déclarations d’attributs lors de la création de l’application. Dans ce cas, ajoutez l’attribut après avoir sélectionné Terminer : dans l’onglet Connexion de l’application, accédez à la section Déclarations d’attributs et sélectionnez Ajouter une expression. Saisissez email dans Nom et user.profile.email dans Expression, puis sélectionnez Enregistrer.

Sélectionnez Suivant. À l’étape Commentaires, sélectionnez Je suis un client Okta qui ajoute une application interne, puis Terminer.

Copier l’URL des métadonnées #

Dans l’onglet Connexion de l’application, copiez l’URL des métadonnées depuis la section Détails des métadonnées. Elle se présente sous la forme https://your-company.okta.com/app/exk.../sso/saml/metadata.

Affecter des personnes #

  1. Ouvrez l’onglet Affectations de l’application.
  2. Sélectionnez Affecter, puis Affecter à des personnes ou Affecter à des groupes.
  3. Sélectionnez Affecter à côté de chaque personne ou groupe, puis Terminé.

Seules les personnes affectées à l’application peuvent se connecter à Lingo.dev via Okta.

Établir la connexion dans Lingo.dev #

  1. Ouvrez Paramètres → SSO.
  2. Collez l’URL des métadonnées Okta dans URL des métadonnées du fournisseur d’identité.
  3. Dans Domaines de messagerie, saisissez les domaines de messagerie de votre entreprise, séparés par des virgules.
  4. Sélectionnez Connecter.

Si un domaine est refusé, consultez Règles relatives aux domaines.

Tester la connexion #

  1. Ouvrez une fenêtre de navigation privée et accédez à la page de connexion de Lingo.dev.
  2. Sélectionnez Continuer avec le SSO, saisissez l’adresse e-mail d’une personne affectée à l’application, puis sélectionnez Se connecter.
  3. Connectez-vous à Okta.

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é par Okta pour la connexion, pas nécessairement à l’adresse que vous avez saisie. Si une session Okta est déjà ouverte dans le navigateur, par exemple celle de l’administrateur qui a configuré l’application, Okta poursuit la connexion avec ce compte. Si cet administrateur n’est pas affecté à l’application, le message « L’utilisateur n’est pas affecté à cette application » s’affiche. C’est pourquoi le test doit se faire dans une fenêtre de navigation privée.

Lancez le test depuis Lingo.dev. La vignette de l’application SAML sur le tableau de bord Okta ne vous connecte pas : vous arrivez sur la page d’accueil de Lingo.dev sans être connecté. Pour vous connecter depuis le tableau de bord, ajoutez le signet décrit dans Se connecter depuis le tableau de bord Okta.

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 L’activer.

Se connecter depuis le tableau de bord Okta #

Pour proposer aux membres une vignette Lingo.dev qui les connecte, ajoutez une Bookmark App ouvrant le lien de connexion depuis le tableau de bord. Masquez ensuite l’icône de l’application SAML pour que les membres ne voient que le signet.

  1. Dans Lingo.dev, ouvrez Paramètres → SSO et copiez le Lien de connexion depuis le tableau de bord. Il se présente sous la forme https://lingo.dev/auth/sso?domain=example.com.
  2. Dans la console d’administration Okta, accédez à Applications → Applications (Applications et ressources → Applications dans les consoles d’administration plus récentes), puis sélectionnez Parcourir le catalogue d’applications.
  3. Recherchez et sélectionnez Bookmark App, puis sélectionnez Ajouter une intégration.
  4. Dans Paramètres généraux, saisissez Lingo.dev comme nom et collez le lien dans le champ URL. Laissez l’option Ne pas afficher l’icône de l’application aux utilisateurs décochée. Sélectionnez Terminé.
  5. Dans l’onglet Affectations du signet, affectez les mêmes personnes ou groupes que pour l’application SAML.
  6. Ouvrez l’application SAML Lingo.dev. Dans l’onglet Général, sélectionnez Modifier dans Paramètres de l’application.
  7. Dans Visibilité de l’application, cochez Ne pas afficher l’icône de l’application aux utilisateurs et Ne pas afficher l’icône de l’application dans l’application Okta Mobile. Sélectionnez Enregistrer.

Laissez les personnes affectées à l’application SAML. Elle continue de les connecter ; elle est simplement masquée.

Les membres voient désormais une seule vignette Lingo.dev. Elle ouvre Lingo.dev, qui les redirige vers Okta, puis les ramène dans Lingo.dev une fois connectés, sans leur demander d’adresse e-mail.

Provisionner les membres avec SCIM #

Okta peut gérer les membres de Lingo.dev via SCIM et définir leurs 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 les membres avec SCIM.

  1. Dans Lingo.dev, générez une clé SCIM.
  2. Dans la console d’administration Okta, ouvrez l’application SAML Lingo.dev. Dans l’onglet Général, sélectionnez Modifier dans Paramètres de l’application.
  3. Définissez Provisionnement sur SCIM, puis sélectionnez Enregistrer. Un onglet Provisionnement apparaît dans l’application.
  4. Dans l’onglet Provisionnement, ouvrez Intégration, puis sélectionnez Modifier.

Renseignez les champs suivants :

Champ OktaValeur
URL de base du connecteur SCIMhttps://api.lingo.dev/v2/scim (l’URL de base SCIM dans Lingo.dev)
Champ d’identifiant unique des utilisateursuserName
Actions de provisionnement prises en chargeEnvoyer les nouveaux utilisateurs, Envoyer les mises à jour des profils et Envoyer les groupes. Laissez les actions d’importation décochées. Okta n’importe ni utilisateurs ni groupes depuis Lingo.dev.
Mode d’authentificationEn-tête HTTP. Collez la clé SCIM en tant que jeton Bearer.

Sélectionnez Tester la configuration du connecteur. Une fois le test réussi, fermez-le, puis sélectionnez Enregistrer.

Dans l’onglet Provisionnement, ouvrez Vers l’application, puis sélectionnez Modifier. Activez Créer des utilisateurs, Mettre à jour les attributs des utilisateurs et Désactiver les utilisateurs, puis sélectionnez Enregistrer.

Okta n’envoie personne vers Lingo.dev tant que l’option Créer des utilisateurs n’a pas été enregistrée. Ensuite, chaque personne que vous affectez dispose d’une invitation en attente dans Lingo.dev et devient membre lors de sa première connexion SSO.

Lorsque vous retirez l’affectation d’une personne ou désactivez son compte dans Okta, Okta désactive aussi son compte dans Lingo.dev, ce qui la retire de l’organisation. Consultez Retirer des personnes.

Définir les rôles avec les groupes Okta #

  1. Vérifiez que le groupe Okta porte le même nom qu’un rôle Lingo.dev, par exemple Translator.
  2. Dans l’onglet Envoyer les groupes de l’application, sélectionnez Envoyer les groupes, puis Rechercher des groupes par nom.
  3. Recherchez le groupe, puis sélectionnez Enregistrer.

Envoyez un groupe différent de celui utilisé pour affecter des personnes à l’application. Okta ne permet pas d’utiliser le même groupe pour ces deux fonctions. Okta n’envoie que les membres affectés à l’application : affectez-y donc toutes les personnes du groupe envoyé, directement ou via un autre groupe.

Okta associe le groupe au rôle du même nom. Les membres du groupe reçoivent ce rôle, et les personnes que vous retirez du groupe le perdent. Si aucun rôle ne porte le nom du groupe, une erreur contenant « Aucun rôle nommé » s’affiche lors de l’envoi. Créez le rôle dans Lingo.dev, puis envoyez à nouveau le groupe.

Si vous cessez d’envoyer un groupe et qu’Okta vous demande s’il faut le supprimer dans l’application, sélectionner Supprimer retire le rôle à ses membres. Le rôle reste dans Lingo.dev.

Dépannage #

ProblèmeSolution
Lingo.dev affiche « L’authentification unique n’a pas abouti » après votre connexion à Okta.Vérifiez URI d’audience (ID d’entité du SP) et URL d’authentification unique. Ces valeurs doivent correspondre exactement à l’ID d’entité et à l’URL ACS dans Lingo.dev, sans barre oblique finale.
Lingo.dev affiche « Votre fournisseur d’identité n’a pas envoyé d’adresse e-mail ».Définissez Format de l’identifiant de nom sur Adresse e-mail et Nom d’utilisateur de l’application sur E-mail, puis ajoutez la déclaration d’attribut email : user.email dans l’assistant de configuration, ou user.profile.email dans l’onglet Connexion.
Okta indique que vous n’êtes pas affecté à l’application.Dans l’onglet Affectations, affectez la personne ou un groupe auquel elle appartient. Si vous avez saisi l’adresse e-mail d’une personne affectée à l’application, mais qu’Okta affiche votre compte administrateur, le navigateur a conservé votre session Okta. Déconnectez-vous d’Okta ou utilisez une fenêtre de navigation privée.
Lingo.dev affiche « L’authentification unique a pris trop de temps. Réessayez. »La connexion à Okta a dépassé le délai d’environ 5 minutes, par exemple lors de la configuration initiale de l’authentification multifacteur. Réessayez depuis Lingo.dev. La tentative suivante aboutira.
Lingo.dev affiche « Vous êtes connecté, mais nous n’avons pas pu vous ajouter à votre organisation. »Connectez-vous à nouveau 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’est pas configurée pour » votre domaine.Ajoutez le domaine dans Paramètres → SSO, ou vérifiez l’adresse e-mail saisie.
Le test Tester la configuration du connecteur ou le provisionnement échoue avec 401 Unauthorized.La clé SCIM a été renouvelée ou révoquée. Collez la clé actuelle dans Intégration, ou générez-en une nouvelle dans Lingo.dev.
Une personne affectée dans Okta n’apparaît pas dans Paramètres → Équipe, dans l’onglet Invitations.Vérifiez que Créer des utilisateurs est activé dans Vers l’application. Pour les personnes affectées avant l’enregistrement de cette option, ouvrez la liste des tâches de provisionnement d’Okta et relancez les tâches correspondantes.

Pour les autres messages, consultez Dépannage.