Okta se connecte au moyen d’OpenID Connect. Voici les étapes dans l’ordre qui a fonctionné, avec les noms d’Okta à côté de ceux de Tamaat. Les réglages d’Okta sont donnés ici sous leur nom anglais. Okta modifie sa console de temps à autre; si un libellé diffère, cherchez le plus proche.
Avant de commencer
- Vous êtes administrateur de l’organisation Tamaat, qui a le forfait Professional ou un forfait supérieur.
- Vous êtes administrateur de l’organisation Okta.
- Au moins un utilisateur Okta est assigné à l’application que vous créez plus bas. Son adresse courriel est la même que celle avec laquelle il est invité dans Tamaat.
- Pour laisser les gens commencer à partir de leur courriel de travail, vous pouvez ajouter un enregistrement DNS à votre domaine de courriel. C’est facultatif; l’"Adresse d’ouverture de session" fonctionne sans cela.
- Pour exiger plus tard l’authentification unique, l’administrateur qui sera la personne de secours a un mot de passe Tamaat et l’authentification à deux facteurs.
1. Créer l’application dans Okta
Dans la console d’administration d’Okta, choisissez Applications → Applications → Create App Integration. Choisissez la Classic experience si Okta l’offre à côté de l’Okta Integration Wizard, puis OIDC - OpenID Connect et Web Application, puis Next.
| Réglage Okta | Valeur |
|---|---|
| App integration name | Un nom que vous reconnaîtrez, par exemple Tamaat |
| Client definition | Utiliser l’ID client généré par Okta |
| Require Demonstrating Proof of Possession (DPoP) | Désactivé |
| Authorization Code | Activé |
| Client Credentials | Désactivé |
| Refresh Token | Désactivé |
| Sign-in redirect URIs | Laissez pour l’instant l’adresse suggérée par Okta. Vous la remplacez à l’étape 4. |
Allow wildcard * in sign-in redirect URI | Désactivé |
| Sign-out redirect URIs | Vide |
| Trusted Origins / Base URIs | Vide |
| Controlled access | Sautez l’assignation de groupes pour l’instant |
Enregistrez l’application. Dans son onglet General, copiez le Client ID et le Client secret. Tamaat s’authentifie avec le secret client.
2. Assigner des gens dans Okta
Okta laisse entrer dans l’application seulement les personnes assignées.
- 1
Ouvrez l’onglet Assignments de l’application et choisissez Assign → Assign to People.
- 2
Trouvez la personne, choisissez Assign, puis Save and Go Back, et terminez la boîte de dialogue.
La zone de recherche de la page Assignments principale cherche parmi les personnes déjà assignées. Un résultat vide ne veut pas dire que la personne manque dans Okta; utilisez Assign to People pour l’ajouter.
3. Ajouter la connexion dans Tamaat
- 1
Ouvrez Paramètres et choisissez Organisation → Authentification unique. Sous Connexion, choisissez "Ajouter une connexion".
- 2
Sous "Fournisseur d’identité", choisissez Okta.
- 3
Sous "Provenant d’Okta", remplissez :
- "Nom de la connexion" : ce que vos gens verront lorsqu’ils se connecteront, par exemple le nom de votre entreprise.
- "Émetteur" : l’adresse de votre organisation Okta, sous la forme
https://<your-okta-organization>.okta.com. Utilisez l’adresse que vos gens emploient pour se connecter à Okta, sans la partie-adminde l’adresse d’administration et sans chemin d’activation ou d’inscription. L’émetteur qui a fonctionné chez nous est cette adresse d’organisation, et non un serveur d’autorisation se terminant par/oauth2/default; n’utilisez celui-ci que si vous avez une raison et que le test réussit. - "ID client" : copié depuis l’application Okta.
- "Secret client" : copié directement depuis Okta. Ne le retapez pas.
- "Date d’expiration du secret (facultatif)" : laissez vide, ou entrez le jour où le secret prend fin.
- 4
Laissez vides les champs des groupes et de la découverte avancée.
- 5
Choisissez "Enregistrer". Le formulaire indique "Enregistré." et affiche une nouvelle étape, "À copier dans Okta".
4. Mettre l’adresse de redirection dans Okta
"À copier dans Okta" affiche deux adresses, chacune avec un bouton "Copier". Utilisez les boutons; ne construisez pas les adresses à la main.
| Adresse | À quoi elle sert |
|---|---|
| "URI de redirection" | L’endroit où Okta renvoie le navigateur vers Tamaat. Elle a la forme https://<tamaat-app-host>/api/auth/federation/<connection-id>/oidc/callback. Elle va dans Okta. |
| "Adresse d’ouverture de session" | Lance une ouverture de session par cette connexion. Elle a la forme https://<tamaat-app-host>/api/auth/federation/<connection-id>/start. C’est un lien ou un signet pour vos gens. Elle ne va pas dans Okta. |
- 1
Dans Okta, ouvrez l’onglet General de l’application et choisissez Edit sous General Settings.
- 2
Remplacez l’entrée de Sign-in redirect URIs par l’"URI de redirection" de Tamaat. Laissez Login initiated by à App Only. Enregistrez.
Faites-le avant de tester ou de vous connecter. L’adresse qu’Okta a suggérée au départ sert seulement à créer l’application; ce n’est pas l’adresse de Tamaat, et il ne doit pas en rester une fois terminé.
5. Tester la connexion
- 1
Dans Tamaat, choisissez "Enregistrer et tester". Vous êtes envoyé à Okta. Connectez-vous comme une personne assignée.
- 2
Vous revenez au résultat, qui indique "Le test n’a ouvert de session pour personne." Un test réussi prouve qu’Okta accepte la connexion et montre ce qu’Okta a envoyé. Il n’ouvre de session pour personne dans Tamaat et ne lie aucun compte.
- 3
Sur "Réussi", vérifiez les lignes : "Identifiant permanent reçu", "Courriel reçu" et "Heure d’ouverture de session reçue" devraient toutes être présentes. Avec Okta, le test a aussi signalé l’authentification à deux facteurs et un avis indiquant que les personnes confirment leur courriel avec un code la première fois.
- 4
Choisissez "Activer la connexion". La connexion indique "Active".
- 5
Sous Politique d’ouverture de session, choisissez "Facultative" : "Mot de passe ou authentification unique".
6. Se connecter une fois, dans une fenêtre privée
Ouvrez l’"Adresse d’ouverture de session" dans une fenêtre de navigation privée, pour qu’aucune session antérieure ne gêne, et connectez-vous par Okta.
Si la personne a déjà un compte Tamaat avec la même adresse courriel, Tamaat demande "Lier vos comptes?". Vérifiez que les deux comptes sont bien ceux de la personne, puis choisissez "Lier les comptes". Les mots de passe fonctionnent encore.
Se déconnecter de Tamaat ne vous déconnecte pas d’Okta. Okta garde sa propre session; la prochaine fois que Tamaat vous y envoie, vous pouvez revenir directement sans voir d’invite de mot de passe. La durée, et le moment où Okta redemande, dépendent de vos politiques Okta. Testez dans une fenêtre privée, ou déconnectez-vous aussi d’Okta, pour voir l’ouverture de session complète.
7. Commencer à partir d’un courriel de travail (facultatif)
Sans domaine vérifié, les gens utilisent l’"Adresse d’ouverture de session". Si quelqu’un tape son courriel de travail sous Se connecter avec votre organisation et voit "Utilisez l’adresse de connexion que votre organisation vous a donnée.", le domaine n’est pas encore vérifié. L’authentification unique facultative n’est pas en panne.
- 1
Sous Domaines, choisissez "Ajouter un domaine" et entrez le domaine seul, par exemple
example.com. - 2
Choisissez "Afficher l’enregistrement". Tamaat affiche un enregistrement TXT :
Champ Valeur Type TXTNom _tamaat-sso.<your-domain>Valeur tamaat-sso-verification=<generated-token>Publiez-le là où le DNS de votre domaine est réellement géré. C’est le fournisseur des serveurs de noms de votre domaine, qui n’est pas forcément celui de votre site ou de votre courriel. Certains outils DNS veulent seulement le nom relatif,
_tamaat-sso; d’autres veulent le nom complet. Utilisez celui que votre outil attend. - 3
Choisissez "Vérifier maintenant" jusqu’à ce que le domaine indique "Vérifié". Le DNS peut prendre un certain temps, et certains résolveurs gardent un moment une réponse « introuvable » antérieure. S’il ne se vérifie pas tout de suite, attendez et vérifiez de nouveau.
Un domaine vérifié envoie les gens à votre ouverture de session. Il n’ajoute pas de membres; on se joint toujours sur invitation.
Les trois politiques
| Politique | Ce qui s’est passé dans nos tests |
|---|---|
| Facultative | Les deux ont fonctionné : un mot de passe Tamaat avec sa deuxième étape, et Okta, y compris à partir du courriel de travail une fois le domaine vérifié. |
| Obligatoire | La liste de vérification a réussi après une véritable ouverture de session par Okta. Voir plus bas. |
| Désactivée | L’ouverture de session par courriel de travail a cessé d’offrir la connexion. |
Modifier un paramètre sensible
Modifier la politique, et les autres paramètres sensibles de cette section, exige une preuve que seul Tamaat peut donner. Depuis une session ouverte par Okta, un mot de passe seul ne suffit pas. Tamaat vous le dit : "Cette session a été ouverte par la connexion de votre organisation; votre mot de passe seul ne peut donc pas confirmer ce changement. Déconnectez-vous, puis connectez-vous avec votre mot de passe et votre deuxième étape." Faites-le, retournez aux paramètres et réessayez. Tant que le changement n’est pas affiché comme enregistré, il ne l’est pas. Activez l’authentification à deux facteurs sous Compte → Sécurité et connexion avant d’en avoir besoin.
Exiger Okta
Suivez Exiger l’authentification unique. L’ordre qui a fonctionné :
- Activez l’authentification à deux facteurs sur le compte Tamaat de l’administrateur et connectez-vous avec le mot de passe et la deuxième étape.
- Ouvrez la liste de vérification et choisissez "Me désigner comme personne de secours".
- Terminez une véritable ouverture de session par Okta à partir de la liste.
- Lorsque chaque ligne indique "Prêt", choisissez "Exiger l’authentification unique", tapez le nom de l’organisation et donnez la confirmation que Tamaat demande.
La liste comprend une vérification que l’exigence de l’authentification unique est disponible pour votre déploiement de Tamaat. Si elle indique "Pas prêt", rien dans Okta ne peut y remédier; communiquez avec l’exploitant de votre déploiement Tamaat. Une fois l’authentification unique exigée, une personne qui se connecte avec un mot de passe ne peut toujours pas ouvrir le travail de l’organisation tant qu’elle n’a pas continué vers Okta.
Si quelque chose ne fonctionne pas
| Ce que vous voyez | À vérifier |
|---|---|
| "Le fournisseur d’identité a rejeté notre demande. Vérifiez l’ID client, le secret client et l’URI de redirection." | L’"URI de redirection" de Tamaat, exactement, est le Sign-in redirect URI dans Okta, et l’ID client et le secret viennent de cette application. |
| "Le document de découverte du fournisseur nomme un autre émetteur. Vérifiez l’adresse de l’émetteur." | L’"Émetteur" est https://<your-okta-organization>.okta.com, tel que les gens le voient, et non l’adresse -admin. |
| Okta indique que la personne n’est pas assignée | Assignez-la à l’étape 2. |
| "Utilisez l’adresse de connexion que votre organisation vous a donnée." | Le domaine n’est pas vérifié. Voir l’étape 7, ou utilisez l’"Adresse d’ouverture de session". |
Dépanner l’authentification unique énumère toutes les phrases.