Décrit le fonctionnement de Guardian et la façon dont la trousse SDK Guardian vous aide à créer votre propre authentificateur et des applications similaires à Guardian.
Gardien Auth0 est une application mobile pour les appareils iOS et Android qui permet aux utilisateurs d’effectuer l’authentification multifacteur (MFA) avec des notifications poussées ou des mots de passe temporaires à usage unique.Auth Guardian peut envoyer des notifications poussées aux appareils des utilisateurs (généralement des téléphones mobiles ou des tablettes) ou générer des mots de passe à usage unique directement dans l’application. Les utilisateurs peuvent alors répondre rapidement à ces notifications poussées ou récupérer un mot de passe à usage unique pour compléter leur connexion.Les utilisateurs peuvent télécharger l’application Gardien Auth0 à partir du Apple App Store ou du Google Play Store. Vous pouvez également intégrer les fonctionnalités Gardien Auth0 dans votre propre application personnalisée à l’aide de la trousse SDK Guardian.
Pour pouvoir utiliser les notifications poussées, les utilisateurs doivent avoir installé sur leur appareil soit l’application Gardien Auth0, soit une application personnalisée créée à l’aide de la trousse SDK Guardian. Lorsqu’un utilisateur tente de s’authentifier, des notifications poussées sont envoyées à l’application installée. L’utilisateur doit répondre à la notification pour terminer sa connexion, ce qui prouve qu’il connaît ses informations de connexion et qu’il possède l’appareil configuré pour la .Les notifications poussées d’Auth0 peuvent être mises en œuvre à l’aide du service de notification simple (SNS) d’AWS ou d’un ou de plusieurs des services directs aux fournisseurs suivants pour configurer des intégrations spécifiques aux fournisseurs :
Lorsque vous utilisez Gardien Auth0 pour configurer les notifications poussées, les utilisateurs sont invités à télécharger l’application mobile lorsqu’ils s’inscrivent ou se connectent pour la première fois à votre application. Si vous utilisez la trousse SDK Guardian pour mettre en œuvre les notifications poussées dans une application personnalisée, les utilisateurs ne sont pas invités à télécharger des applications lors de l’inscription.Vous pouvez activer les notifications poussées à partir d’ sous Security (Sécurité )> Multi-factor Auth > Push Notification using Auth0 Guardian (Notification poussée via Gardien Auth0).
Lorsqu’un utilisateur s’inscrit ou se connecte pour la première fois à votre application, la connexion universelle fournit un code QR qui peut être utilisé pour enregistrer l’application Gardien Auth0 ou l’application personnalisée avec la trousse SDK Guardian en tant que facteur d’authentification secondaire. L’utilisateur dispose d’un court laps de temps pour balayer ce code avec l’application désignée afin de terminer son inscription.Une fois que l’utilisateur s’est inscrit, il peut utiliser les notifications poussées comme facteur d’authentification. Chaque fois que l’utilisateur tente de se connecter à votre application, il reçoit une notification poussée sur son appareil via l’application Gardien Auth0 ou une application personnalisée utilisant la trousse SDK Guardian. L’utilisateur doit approuver cette demande pour se connecter avec succès à votre application.Pour savoir comment réinitialiser la MFA pour les utilisateurs qui ont perdu leur appareil ou leur code de récupération, consultez Réinitialiser l’authentification multifacteur (MFA) et les codes de récupération. Pour obtenir une assistance supplémentaire, consultez Dépannage des problèmes d’authentification multifacteur (MFA).
L’application Gardien Auth0 et les applications utilisant la trousse SDK Guardian prennent également en charge l’utilisation de mots de passe temporaires à usage unique (OTP) comme facteurs d’authentification secondaires. L’application et la trousse SDK peuvent générer des OTP temporaires que les utilisateurs peuvent utiliser pour répondre aux défis-réponses de MFA de la connexion universelle.Par défaut, l’application Gardien Auth0 répertorie les applications inscrites de l’utilisateur. Après avoir sélectionné une application, l’OTP correspondant à cette application s’affiche. Chaque OTP à 6 chiffres reste valide pendant 30 secondes. Les OTP dont l’expiration est proche sont affichés en rouge. À l’expiration, l’application génère immédiatement un nouvel OTP. Pour éviter les échecs d’authentification, les utilisateurs ne doivent pas utiliser d’OTP affichés en rouge.Dans les applications personnalisées utilisant la trousse SDK Guardian, l’apparence des OTP peut varier.
Utiliser des mots de passe temporaires à usage unique
Vous pouvez utiliser les OTP de deux manières principales :
En tant qu’option de repli pour les notifications poussées dans le cas où l’application Gardien Auth0 ou une autre application personnalisée ne reçoit pas de demande poussée.
Utilisez les mots de passe à usage unique (OTP) en tant qu’option de secours aux notifications poussées
Si un utilisateur ne reçoit pas de notification poussée via Gardien Auth0 ou d’une autre application personnalisée, il peut plutôt utiliser un OTP temporaire pour compléter le défi-réponse de la MFA.Exemple de flux utilisateur :
Un utilisateur tente de se connecter à votre application. Il arrive à l’invite de connexion universelle MFA, mais il n’obtient aucune notification poussée.
Dans l’invite MFA, l’utilisateur sélectionne le bouton Saisir le code manuellement. L’utilisateur doit sélectionner cette option pour authentifier l’utilisation des OTP.
L’utilisateur ouvre l’application Gardien Auth0 ou l’application trousse SDK Guardian personnalisée, puis sélectionne l’application à laquelle il tente d’accéder.
L’utilisateur copie l’OTP affiché en bas de la page Informations du compte.
L’utilisateur saisit l’OTP dans l’invite MFA pour effectuer le défi-réponse.
Défi MFA
Utiliser les OTP comme défi MFA
Pour permettre aux utilisateurs de s’authentifier à l’aide de mots de passe à usage unique, vous devez activer Mot de passe à usage unique en tant que facteur MFA pour votre locataire. Une fois cette option activée, les utilisateurs peuvent répondre aux invites MFA à l’aide de mots de passe à usage unique lorsqu’ils se connectent via la connexion universelle. Pour activer les facteurs MFA, accédez à Auth0 Dashboard > Sécurité > Authentification multifacteur.Les utilisateurs peuvent choisir d’utiliser un OTP en tant que facteur MFA lors de leur première inscription ou connexion à votre application. Selon le type d’appareil utilisé, la connexion universelle affiche l’un des éléments suivants :
Pour les appareils autres que les appareils mobiles : La connexion universelle présente un code QR que l’utilisateur peut scanner pour poursuivre l’inscription.
Pour les appareils mobiles : La connexion universelle ignore le code QR et affiche directement le code d’inscription.
Quelle que soit la méthode choisie, les utilisateurs peuvent suivre les étapes à l’écran pour enregistrer l’application Gardien Auth0 ou une application personnalisée utilisant la trousse SDK Guardian comme facteur d’authentification secondaire. En général, ce processus consiste à demander à l’utilisateur d’ajouter votre application à l’application appropriée et de récupérer le mot de passe à usage unique (OTP) généré pour cette application. L’utilisateur saisit ensuite l’OTP dans l’invite de connexion universelle pour terminer le processus d’inscription.La prochaine fois que l’utilisateur tente de se connecter à votre application après avoir terminé l’inscription, il peut s’authentifier en saisissant un mot de passe à usage unique à partir de son application Gardien Auth0 ou de sa trousse SDK Guardian personnalisée dans le défi-réponse.
Dans l’application Gardien Auth0, les utilisateurs peuvent activer les codes d’accès et les données biométriques comme couches de sécurité supplémentaires sur iOS et Android. Si un utilisateur active une ou plusieurs de ces options, il doit relever ces défis avant de pouvoir répondre aux notifications poussées ou de récupérer des mots de passe à usage unique.Pour activer ces options sur les appareils iOS ou Android, les utilisateurs peuvent suivre les étapes ci-dessous.
iOS
Android
Pour activer les paramètres de sécurité pour l’application Gardien Auth0 sur iOS :
Dans l’application, sélectionnez gear icon (icône d’engrenage) pour ouvrir le menu Paramètres.
Sélectionnez Passcode (Code secret) pour activer la protection par code secret.
Définissez et confirmez un code secret à six chiffres.
L’application est maintenant protégée par le code secret. L’utilisateur doit entrer ce code secret avant de pouvoir répondre aux notifications poussées ou récupérer les OTP.Après avoir activé la protection par code secret, l’utilisateur peut configurer les caractéristiques biométriques de l’appareil comme autre mesure de sécurité.
Dans l’application, sélectionnez gear icon (icône d’engrenage) pour ouvrir le menu Paramètres.
Activez les caractéristiques biométriques de l’appareil en sélectionnant l’une des options disponibles, soit Face ID (Détection du visage) ou Touch ID (Empreinte).
Pour activer les paramètres de sécurité pour l’application Gardien Auth0 sur Android :
Dans l’application, sélectionnez le three-dot menu (menu à trois points) pour ouvrir le menu Settings (Paramètres).
Activez le bouton à bascule pour l’option Always Ask for Passphrase (Toujours demander la phrase secrète).
Saisissez la phrase secrète qui a été établie au moment de la configuration de l’application Gardien Auth0.
L’application est maintenant protégée par la phrase secrète Gardien Auth0. L’utilisateur doit entrer cette phrase secrète avant de pouvoir répondre aux notifications poussées ou de récupérer les OTP.Après avoir activé la protection par phrase secrète, l’utilisateur peut configurer les caractéristiques biométriques de l’appareil comme autre mesure de sécurité. Pour activer les caractéristiques biométriques de l’appareil :
Dans l’application, sélectionnez le three-dot menu (menu à trois points) pour ouvrir le menu Settings (Paramètres).
Activez la base pour l’option Use Biometrics to unlock (Utiliser la biométrie pour déverrouiller).
L’application Gardien Auth0 prend en charge la localisation pour plusieurs langues et dialectes sur iOS et Android.Dans la section Language (Langue) du menu Settings (Réglages), les utilisateurs peuvent sélectionner leur langue préférée. Par défaut, l’application utilise la même langue que le système de l’appareil.
La majorité des contenus de notifications poussées affichent aux utilisateurs leur langue de préférence. Cependant, les titres de notifications poussées ne sont pas traduits puisque les paramètres régionaux ne sont pas récupérés tant qu’un titre n’est pas renseigné.
L’application Gardien Auth0 prend en charge les langues et dialectes suivants :
L’application Gardien Auth0 pour iOS et Android prend en charge les thèmes en mode clair et en mode foncé.Dans la section Theme (Thème) du menu Settings (Réglages), les utilisateurs peuvent sélectionner les options suivantes :
Options de personnalisation pour les applications protégées
Pour permettre aux utilisateurs de distinguer plus facilement leurs applications protégées dans l’application Gardien Auth0, chaque application peut être personnalisée avec un nom, une couleur d’accentuation et une icône distincts.
Vous pouvez installer la trousse SDK Guardian (proposée pour iOS et Android) pour créer votre propre application d’authentification multifacteur (MFA) avec un contrôle total sur l’image de marque et l’apparence. Avec la trousse SDK Guardian, vous pouvez créer vos propres applications mobiles personnalisées qui fonctionnent comme Guardian ou intégrer certaines fonctionnalités de Guardian, telles que la réception de notifications poussées dans vos applications mobiles existantes. Un scénario typique pourrait être celui d’une application bancaire. Vous pouvez utiliser la trousse SDK Guardian dans votre application mobile existante pour recevoir et confirmer des notifications poussées lorsque quelqu’un effectue une transaction au guichet automatique.
Authentification multifacteur avec Gardien Auth0 et Authorization Extension
Ce modèle fournit un exemple et un point de départ pour déclencher l’authentification multifacteur (MFA) avec Gardien Auth0 pour les notifications poussées lorsqu’une condition est remplie.Lors de la première connexion, l’utilisateur peut inscrire l’appareil. Consultez Activer l’authentification multifacteur (MFA) pour plus d’informations sur l’authentification multifacteur (MFA).
Copier
exports.onExecutePostLogin = async (event, api) => {const groups = event.user.app_metadata.authorization.groups;const GROUPS_WITH_MFA = {// Add groups that need MFA here// Exampleadmins: true};const needsMFA = !!groups.find(function (group) {return GROUPS_WITH_MFA[group];});if (needsMFA) {// optional, defaults to true. Set to false to force Guardian authentication every time.// See https://auth0.com/docs/secure/multi-factor-authentication/customize-mfa#change-frequency-of-mfa-prompts for detailsapi.multifactor.enable('guardian', { allowRememberBrowser: false });}};
