Duo Security

Note : Duo Security est un Advanced Authenticator disponible dans le cadre de la Professional edition of ADSelfService Plus.

L’intégration de Duo Security dans ADSelfService Plus permet aux organisations de tirer parti de leur investissement existant dans Duo MFA au sein des workflows MFA d’ADSelfService Plus. Cela offre une expérience d’authentification cohérente sur tous les systèmes d’entreprise et maintient une gestion centralisée de tous les authenticators utilisés dans votre organisation via le portail d’administration d’ADSelfService Plus.

Comment ça fonctionne

ADSelfService Plus s’intègre à Duo Security via deux options SDK :

Web v4 SDK : utilise le Universal Prompt basé sur OIDC de Duo avec une interface moderne qui redirige les utilisateurs vers Duo pour l’authentification
Web v2 SDK : utilise l’invite traditionnelle de Duo affichée dans un iframe d’ADSelfService Plus.

Note : Duo a supprimé progressivement le Web v2 SDK, il est donc recommandé d’utiliser le Web v4 SDK, qui intègre le nouveau Universal Prompt.

Lors de l’authentification, les utilisateurs sont invités à vérifier leur identité en utilisant les méthodes de Duo — notifications push vers l’application mobile Duo, codes de vérification à six chiffres depuis l’application Duo, ou authentification par clé de sécurité. ADSelfService Plus communique avec les serveurs de Duo en utilisant les identifiants API configurés pour valider la réponse d’authentification de l’utilisateur.

Optionnellement, les administrateurs peuvent configurer l’Auth API pour synchroniser le statut d’enrôlement des utilisateurs entre les systèmes et activer le Device Management Portal pour permettre aux utilisateurs de gérer eux-mêmes leurs appareils Duo enregistrés.

Limitation L’authentification Duo ne peut pas être utilisée pour des scénarios MFA hors ligne.

Prérequis

Ajoutez le nom d’hôte de l’API et la console d’administration (par exemple, https://********.duosecurity.com) en tant que site de confiance ou site intranet sur la machine des utilisateurs s’ils utilisent une version d’Internet Explorer antérieure à la v9.0.
Veuillez suivre ces étapes dans le Duo Admin Panel pour migrer du Web v2 SDK, qui utilise l’invite traditionnelle, vers le Web v4 SDK, qui emploie le nouveau Universal Prompt.

Étapes de configuration et d’intégration

La configuration de Duo Security implique un processus en deux parties : d’abord, dans la console d’administration d’ADSelfService Plus où vous sélectionnez le type d’intégration (Web v4 SDK recommandé) et saisissez les détails de connexion ; ensuite, dans le Duo Admin Panel où vous créez des applications et obtenez les identifiants nécessaires. Optionnellement, vous pouvez configurer le Device Management Portal pour permettre aux utilisateurs de gérer directement leurs appareils enregistrés via l’auto-assistance, et configurer l’Auth API pour assurer la synchronisation du statut d’enrôlement des utilisateurs entre les deux systèmes.

Étapes de configuration de Web v4 SDK

Note : Une connexion sécurisée est requise pour configurer l’authentification Web v4 SDK. Veuillez vous assurer que vous avez activé HTTPS dans ADSelfService Plus et le Access URL.

Connectez-vous à votre compte Duo Security (par exemple, https://********.duosecurity.com) ou inscrivez-vous pour un nouveau compte et connectez-vous.
Go to Applications and click Protéger une Application.
Search for Web SDK and click Protéger.
Copy the Client ID, Client secret et nom d’hôte API values.
Depuis le portail d’administration d’ADSelfService Plus, naviguez vers Configuration > Multi-factor Authentication > Duo Security.
Select Web v4 SDK for Type d’intégration.
Collez le Client ID, Client secret et le API hostname obtenus depuis le panneau d'administration Duo dans les champs respectifs.
Saisissez le même modèle de nom d’utilisateur utilisé dans Duo Security dans le champ Username Pattern .
Cliquez sur Enregistrer.

Configuration de l’Auth API pour les configurations Web v4 de Duo Security

Si vous configurez l’Auth API, suivez ces étapes et obtenez la Integration Key et la Secret Key depuis le portail Duo Security.
Sous les paramètres de configuration Web v4 SDK pour Duo Security, cliquez sur Advanced Settings pour ouvrir les paramètres de configuration de l’Auth API.
Paste the Integration Key and Clé secrète into the relevant fields, and click Enregistrer.

Configuration des paramètres du Device Management Portal pour les configurations Web v4 de Duo Security

Le Duo Device Management Portal permet aux utilisateurs d’ajouter ou de supprimer des appareils enregistrés Duo depuis le portail en libre-service. Le Device Management Portal pour Web v4 utilise le Universal Prompt basé sur OIDC de Duo avec une interface repensée qui redirige les utilisateurs vers Duo dans un nouvel onglet. Voici les étapes pour configurer le Duo Device Management Portal :

Connectez-vous à Duo Security et allez dans Applications > Protect an Application.
Recherchez Device Management Portal. Cliquez sur Protect.
Copiez le Client ID et le Client Secret depuis la section Details.
Sous les paramètres de configuration Web v4 SDK pour Duo Security, cliquez sur Advanced Settings pour ouvrir les paramètres du Device Management Portal.
Paste the ID client and Secret client into the relevant fields and click Enregistrer.

Étapes de configuration de Web v2 SDK

Connectez-vous à votre compte Duo Security (par exemple, https://********.duosecurity.com) ou inscrivez-vous pour un nouveau compte et connectez-vous.
Go to Applications and click Protéger une Application.
Search for Web SDK and click Protéger.
Copy the Integration key, Secret key et nom d’hôte API values.
Dans ADSelfService Plus, naviguez vers Configuration > Multi-factor Authentication > Duo Security.
Select Web v2 SDK for Type d’intégration.
Collez la Integration key, Secret key et le API hostname obtenus depuis le panneau d'administration Duo dans les champs respectifs.
Saisissez le même modèle de nom d’utilisateur utilisé dans Duo Security dans le champ Username Pattern .
Cliquez sur Enregistrer.

Configuration de l’Auth API pour les configurations Web v2 de Duo Security

Si vous configurez l’Auth API, suivez ces étapes et obtenez la Integration Key et la Secret Key depuis le portail Duo Security.
Sous les paramètres de configuration Web v2 SDK pour Duo Security, cliquez sur Advanced Settings pour ouvrir les paramètres de configuration de l’Auth API.
Paste the Integration Key and Clé secrète into the relevant fields and click Enregistrer.

Configuration des paramètres du Device Management Portal pour les configurations Web v2 de Duo Security

Le Device Management Portal pour Web v2 utilise une invite Duo traditionnelle qui sera affichée dans un iframe dans ADSelfService Plus.

Connectez-vous à Duo Security et allez dans Applications > Protect an Application.
Recherchez Device Management Portal. Cliquez sur Protect.
Copiez la Integration key et la Secret key depuis la section Details.
Sous les paramètres de configuration Web v2 SDK pour Duo Security, cliquez sur Advanced Settings pour ouvrir les paramètres du Device Management Portal.
Paste the Integration Key and Clé secrète into the relevant fields and click Enregistrer.

Configuration de l'Auth API dans Duo Security

La configuration de l’Auth API dans Duo Security est optionnelle. La configuration de l’Auth API est utilisée pour vérifier l’enrôlement de l’utilisateur avec Duo Security. Si l’Auth API n’est pas configurée, alors lors de la suppression de l’enrôlement d’un utilisateur dans Duo Security, il est obligatoire de supprimer manuellement l’enrôlement de l’utilisateur dans ADSelfService Plus également. Sinon, l’utilisateur sera rajouté dans Duo Security s’il est utilisé pour l’authentification dans ADSelfService Plus.

Étapes à suivre si vous configurez l’Auth API

Connectez-vous au portail Duo Security.
Naviguez vers Applications et cliquez sur Protect An Application.
Recherchez Auth API. Cliquez sur Protect this Application.
Copiez la Integration key et la Secret key.

Étapes pour migrer vers la nouvelle Universal Prompt

Dans le Duo Admin Panel, sélectionnez l’application Web SDK, qui a été précédemment configurée pour ADSelfService Plus, et copiez les valeurs Integration key, Secret key et API hostname.
Scroll down to the Universal Prompt section. The App Update Ready message will be displayed, indicating that Universal Prompt can now be activated for ADSelfService Plus.
Dans ADSelfService Plus, naviguez vers Configuration > Multi-factor Authentication > Duo Security.
Cliquez sur Web v4 SDK et collez les valeurs Integration key, Secret key et API hostname dans les champs Client ID, Client Secret, et API Host name respectivement.
Once the Web v4 SDK is configured in ADSelfService Plus and a user authenticates through the frameless Duo v4 SDK, the Mise à jour de l'application prête message in Duo Admin Panel will be updated and the Nouvelle invite prête message will be displayed.
Select Afficher la nouvelle Universal Promptto activate the universal prompt for ADSelfService Plus.

Configuration de l’enregistrement des utilisateurs

La dernière étape consiste à configurer le processus permettant aux utilisateurs de s’enregistrer pour Duo Authentication et de l’utiliser pour la vérification d’identité.

Vous pouvez découvrir les différentes options d’enregistrement disponibles dans ADSelfService Plus, ici.

Astuce

Vous pouvez voir comment les paramètres d’enregistrement que vous configurez seront présentés à vos utilisateurs, ici.