Configurer l'authentification SSO avec Okta

Utiliser Okta avec Devolutions Hub Business pour l'authentification unique (SSO) en suivant les étapes de cette page. Voir d'abord les exigences et les fonctionnalités prises en charge ci-dessous.

Pour utiliser le SSO ou le provisionnement automatique (SCIM) avec Okta, un compte Okta avec les droits appropriés est requis. La procédure de validation de domaine doit également être complétée pour vérifier la propriété des domaines configurés. Seuls les utilisateurs avec des courriels dont les domaines ont été vérifiés peuvent se connecter via le SSO ou être provisionnés via SCIM.

• Se connecter au Hub via Okta SSO

• Provisionnement juste-à-temps (JIT) des utilisateurs connectés via Okta SSO

• Synchroniser votre Okta avec Devolutions Hub

  • Créer/mettre à jour les utilisateurs de Okta vers Devolutions Hub (créer des utilisateurs, mettre à jour les attributs des utilisateurs, et désactiver les utilisateurs)

  • Créer/mettre à jour des groupes d'Okta vers Devolutions Hub (poussée de groupe)

Voici les étapes pour valider le domaine, configurer l'authentification unique, et effectuer le provisionnement des utilisateurs.

Dans Devolutions Hub Business

1. Aller à Administration – Authentification – Domaine, puis cliquer sur Ajouter un domaine.

2. Remplir le domaine, puis cliquer sur le coche pour démarrer le processus de vérification.

   Pour des raisons de sécurité, seuls les courriels qui se terminent par le nom de votre domaine sont autorisés à se connecter à Devolutions Hub en utilisant l'authentification Okta. Par exemple, si les courriels des employés sont au format "bob@windjammer.co", le domaine est "windjammer.co".

3. Pour avoir plusieurs domaines, cliquer sur Ajouter un domaine à nouveau, remplir votre autre domaine, puis cliquer sur la coche. Répéter ce processus pour chaque domaine que vous souhaitez ajouter.

4. Créer un enregistrement DNS TXT en utilisant le Nom d'hôte et la Valeur TXT fournis. Cela nous permet de vérifier la propriété des domaine(s) fournis.
   

   Il est recommandé de vérifier que la configuration est adéquate en utilisant des outils de requête DNS tels que MXToolBox ou whatsmydns.net. L'exemple ci-dessous utilise l'outil de recherche TXT de MXToolBox. La première partie du nom de domaine doit correspondre au nom d'hôte dans Devolutions Hub et l'enregistrement doit correspondre à la valeur TXT dans Devolutions Hub également.

   Les enregistrements DNS TXT peuvent prendre un certain temps à se propager.

   

5. Attendre la vérification du domaine. Une fois la vérification réussie, une coche dans un cercle vert s'affichera à côté du domaine. Procéder à la configuration de l'authentification unique (SSO) pendant le processus de vérification ; toutefois, le provisioning des utilisateurs devient accessible uniquement après que le domaine a été vérifié.

   Cette validation dure 48 heures et ne redémarre pas automatiquement après cette période. Si l'enregistrement TXT n'est pas configuré dans les 48 heures, le statut de validation sera Expiré. Si cela se produit, cliquez sur Réessayer.

   Si des problèmes surviennent lors de la tentative de vérification du domaine, consultez notre guide de dépannage pour la validation de domaine.

1. Aller à Administration – Authentification – Authentification unique (SSO), puis cliquer sur Authentification unique (SSO) Okta pour être redirigé vers la page de configuration.
   

2. Nommer la configuration SSO. Ce nom apparaîtra uniquement dans le menu des paramètres SSO de Devolutions Hub. Le nom par défaut est "Okta".
   

   Ne fermez pas cette page de configuration, car les étapes suivantes vous indiqueront où trouver les informations à saisir dans ses champs.

Dans Okta

3. Se connecter au compte Okta.

4. Dans Applications, cliquer sur Parcourir le catalogue d'applications.
   

5. Rechercher Devolutions Hub, puis cliquer sur l'application dans les résultats de recherche.
   

6. Cliquer sur Ajouter une Intégration en haut.

7. Dans l'onglet Sign On, copier l'ID Client.
   

Dans Devolutions Hub Business

8. Retourner à la page Configurer l'authentification unique (SSO), coller l'ID Client de l'étape précédente dans le champ du même nom.
   

Dans Okta

9. Retourner à l'onglet Sign On, copier le Client secret.
   

Dans Devolutions Hub Business

10. Retourner à la page Configurer l'authentification unique (SSO), coller le Client secret de l'étape précédente dans le champ Clef du secret client.
    

11. Dans URL de découverte, entrer l'URL utilisée pour accéder à Okta, sans la partie "-admin".

    Ne testez pas encore la connexion, car les utilisateurs doivent d'abord être affectés à l'application.

    

Dans Okta

12. Dans l'onglet Affectations, s'assurer que chaque utilisateur utilisé pour tester la configuration est assigné à l'application. Pour plus de détails, consulter la documentation propre à Okta sur la gestion des utilisateurs et l'affectation d'applications.

Dans Devolutions Hub Business

13. Tester la configuration dans Devolutions Hub. Une nouvelle fenêtre s'ouvre pour vous connecter à Devolutions Hub via Okta. Une fois connecté, un message de succès apparaît.

14. Cliquer sur Enregistrer dans le Résumé de la configuration Okta SSO.

La configuration de l'authentification unique est maintenant complète. Une icône de coche verte devrait maintenant être visible à côté de la configuration, signifiant que la configuration SSO via Okta est maintenant activée sur le Hub.

Lors de la connexion au Hub, cliquer sur Se connecter avec Okta.

Une page de connexion Okta s'ouvrira. Entrer les identifiants Okta et cliquer sur Se connecter. Le Hub sera alors accessible.

Synchroniser les utilisateurs et les groupes d'utilisateurs des fournisseurs vers le Hub en suivant les étapes de cette section. Voir d'abord la liste des fonctionnalités prises en charge ci-dessous.

• Créer des utilisateurs

• Mettre à jour les attributs utilisateur

• Désactiver les utilisateurs

• Envoi de groupe

Dans Okta

1. Aller à l'application Devolutions Hub Business.

2. Dans l'onglet Provisioning, cliquer sur Configurer l'intégration API.

3. Cocher la case Activer l'intégration API.

Dans Devolutions Hub Business

4. Aller à Administration – Authentification – Provisioning et activer le provisionnement SCIM.

5. Copier le jeton secret en cliquant sur l'icône Copier dans le presse-papiers à côté.

Dans Okta

6. Retourner à l'onglet Provisioning dans Okta, coller le jeton secret de l'étape précédente dans le champ API Token.

7. Cliquer sur Tester les identifiants API. Un message de réussite devrait apparaître.

Dans Devolutions Hub Business

8. Retourner à la configuration de Provisioning dans le Devolutions Hub, cliquer sur Activer la synchronisation.

Dans Okta

9. Enregistrer la configuration de provisioning Okta.

10. Toujours dans l'onglet Provisioning, aller aux paramètres To App, puis cliquer sur Modifier.

11. Activer/désactiver les paramètres suivants:

    • Activer:

      • Créer des utilisateurs

      • Mettre à jour les attributs

      • Désactiver les utilisateurs

    • Désactiver:

      • Définir un mot de passe lors de la création de nouveaux utilisateurs (sous le paramètre Créer des utilisateurs)

    

12. Sauvegarder les changements.

La synchronisation de Okta vers Devolutions Hub Business est maintenant configurée.