> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Décrit le fonctionnement de Guardian et la façon dont le Guardian SDK vous aide à créer votre propre authentificateur et des applications semblables à Guardian.
# Auth0 Guardian
Auth0 Guardian est une application mobile pour les appareils iOS et Android qui permet aux utilisateurs d’effectuer une [authentification multifacteur (MFA)](/docs/fr-ca/secure/multi-factor-authentication) au moyen de notifications push ou de mots de passe temporaires à usage unique.
Auth0 Guardian peut envoyer des notifications push aux appareils enregistrés 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 ensuite répondre rapidement à ces notifications push ou récupérer un mot de passe à usage unique pour ouvrir leur session.
Les utilisateurs peuvent télécharger l’application Auth0 Guardian depuis l’[Apple App Store](https://apps.apple.com/us/app/auth0-guardian/id1093447833) ou le [Google Play Store](https://play.google.com/store/apps/details?id=com.auth0.guardian). Vous pouvez aussi intégrer les capacités d’Auth0 Guardian à votre propre application personnalisée à l’aide du Guardian SDK.
## Notifications push
Pour utiliser les notifications push, les utilisateurs doivent avoir installé sur leur appareil soit l’application Auth0 Guardian, soit une application personnalisée créée à l’aide du Guardian SDK. Lorsqu’un utilisateur tente de s’authentifier, des notifications push sont envoyées à l’application installée. L’utilisateur doit répondre à la notification pour terminer sa connexion, prouvant ainsi qu’il connaît ses renseignements de connexion et qu’il possède l’appareil configuré pour la MFA.
Les notifications push d’Auth0 peuvent être mises en œuvre à l’aide d’AWS Simple Notification Service (SNS) ou d’un ou de plusieurs des services directs aux fournisseurs suivants afin de configurer des intégrations propres à chaque fournisseur :
* Firebase Cloud Messaging (FCM)
* Pour en savoir plus sur la modification du contenu des notifications push, consultez la [documentation de FCM](https://firebase.google.com/docs/cloud-messaging/concept-options).
* Apple Push Notification (APN)
* Pour en savoir plus sur la modification du contenu des notifications push, consultez la [documentation d’Apple](https://developer.apple.com/documentation/usernotifications/modifying-content-in-newly-delivered-notifications).
### S’inscrire aux notifications push
Lorsque vous utilisez Auth0 Guardian pour configurer les notifications push, les utilisateurs sont invités à télécharger l’application mobile lorsqu’ils s’inscrivent ou se connectent à votre application pour la première fois. Si vous utilisez le Guardian SDK pour implémenter les notifications push dans une application personnalisée, les utilisateurs ne sont invités à télécharger aucune application pendant l’inscription.
Vous pouvez activer les notifications push à partir du Auth0 Dashboard sous [Sécurité > Authentification multifacteur > Notification push avec Auth0 Guardian](https://manage.auth0.com/#/security/mfa/guardian).
Lorsqu’un utilisateur s’inscrit ou se connecte à votre application pour la première fois, [Universal Login](/docs/fr-ca/authenticate/login/auth0-universal-login) fournit un code QR qu’il peut utiliser pour enregistrer l’application Auth0 Guardian ou une application personnalisée créée avec le Guardian SDK comme facteur d’authentification secondaire. L’utilisateur dispose de peu de temps pour numériser ce code avec l’application désignée afin de terminer son inscription.
Une fois l’utilisateur inscrit, il peut utiliser les notifications push comme facteur d’authentification. Chaque fois que l’utilisateur tente de se connecter à votre application, il reçoit une notification push sur son appareil par l’intermédiaire d’Auth0 Guardian ou d’une application personnalisée créée avec le Guardian SDK. 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 leurs codes de récupération, consultez [Réinitialiser l’authentification multifacteur et les codes de récupération](/docs/fr-ca/secure/multi-factor-authentication/reset-user-mfa).
## Mots de passe à usage unique temporaires
L’application Auth0 Guardian et le Guardian SDK prennent aussi en charge l’utilisation de mots de passe à usage unique temporaires (OTP) comme facteurs d’authentification secondaires. L’application et le SDK peuvent générer des OTP temporaires que les utilisateurs peuvent utiliser pour répondre aux Universal Login challenges MFA.
Par défaut, l’application Auth0 Guardian affiche les applications auxquelles l’utilisateur est inscrit. Après avoir sélectionné une application, l’OTP correspondant s’affiche. Chaque OTP à 6 chiffres demeure valide pendant 30 secondes. Les OTP qui approchent de leur expiration s’affichent en rouge. À l’expiration, l’application génère immédiatement un nouvel OTP. Pour éviter les échecs d’authentification, les utilisateurs ne devraient pas utiliser les OTP affichés en rouge.
Dans les applications Guardian SDK personnalisées, l’apparence des OTP peut varier.
### Utiliser des mots de passe à usage unique temporaires
Vous pouvez utiliser les OTP de deux façons principales :
* Comme solution de secours aux notifications push si l’application Auth0 Guardian ou une autre application personnalisée ne reçoit pas de requête push.
* Comme défi MFA, si vous activez le [facteur One-Time Password](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-factors) dans votre tenant.
Si un utilisateur ne reçoit pas de notification push par l’entremise d’Auth0 Guardian ou d’une autre application personnalisée, il peut plutôt utiliser un OTP temporaire pour terminer son défi MFA.
**Exemple de parcours utilisateur** :
1. Un utilisateur tente de se connecter à votre application. Il arrive à l’invite MFA de Universal Login, mais ne reçoit pas de notification push.
2. Dans l’invite MFA, l’utilisateur sélectionne le bouton **Manually Enter Code**. Il doit sélectionner cette option pour s’authentifier à l’aide d’OTP.
3. L’utilisateur ouvre l’application Auth0 Guardian ou l’application Guardian SDK personnalisée et sélectionne l’application à laquelle il tente d’accéder.
4. L’utilisateur copie l’OTP affiché au bas de la page Détails du compte.
5. L’utilisateur saisit l’OTP dans l’invite MFA pour terminer le défi.
Pour permettre aux utilisateurs de s’authentifier avec des OTP, vous devez activer **One-Time Password** comme [facteur MFA](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-factors) pour votre tenant. Une fois cette option activée, les utilisateurs peuvent répondre aux invites MFA à l’aide d’OTP lorsqu’ils se connectent par l’entremise de Universal Login. Pour activer les facteurs MFA, accédez à [Auth0 Dashboard > Sécurité > Authentification multifacteur](https://manage.auth0.com/#/security/mfa).
Les utilisateurs peuvent s’inscrire à OTP comme facteur MFA lors de leur première inscription ou de leur première connexion à votre application. Selon le type d’appareil utilisé, [Universal Login](/docs/fr-ca/authenticate/login/auth0-universal-login) affiche l’un des éléments suivants :
* **Pour les appareils non mobiles** : Universal Login présente un code QR que l’utilisateur peut balayer pour poursuivre l’inscription.
* **Pour les appareils mobiles** : Universal Login saute l’étape du code QR et affiche plutôt directement le code d’inscription.
Dans les deux cas, les utilisateurs peuvent suivre les étapes à l’écran pour enregistrer soit l’application Auth0 Guardian, soit une application Guardian SDK personnalisée comme facteur d’authentification secondaire. En règle générale, ce processus consiste à demander à l’utilisateur d’ajouter votre application à l’application appropriée et à récupérer l’OTP correspondant pour cette application. L’utilisateur saisit ensuite l’OTP dans l’invite Universal Login pour terminer le processus d’inscription.
La prochaine fois que l’utilisateur tentera de se connecter à votre application après avoir terminé l’inscription, il pourra s’authentifier en saisissant un OTP provenant de son application Auth0 Guardian ou Guardian SDK personnalisée dans le défi.
## Paramètres de l’application Auth0 Guardian
### Paramètres de sécurité de l’utilisateur
Dans l’application Auth0 Guardian, les utilisateurs peuvent activer un code d’accès et la biométrie comme couches de sécurité supplémentaires sur iOS et Android. Si un utilisateur active une ou plusieurs de ces options, il doit effectuer ces vérifications avant de pouvoir répondre aux notifications push ou récupérer des mots de passe à usage unique.
Pour activer ces options sur un appareil iOS ou Android, les utilisateurs peuvent suivre les étapes ci-dessous.
Pour activer les paramètres de sécurité de l’application Auth0 Guardian sur iOS :
1. Dans l’application, sélectionnez l’**icône d’engrenage** pour ouvrir le menu Paramètres.
2. Sélectionnez **Code d’accès** pour activer la protection par code d’accès.
3. Définissez et confirmez un code d’accès à 6 chiffres.
L’application est maintenant protégée par le code d’accès. L’utilisateur doit saisir ce code d’accès avant de pouvoir répondre aux notifications push ou récupérer des OTP.
Après avoir activé la protection par code d’accès, l’utilisateur peut configurer la biométrie de l’appareil comme mesure de sécurité de rechange. Pour activer la biométrie de l’appareil :
1. Dans l’application, sélectionnez l’**icône d’engrenage** pour ouvrir le menu Paramètres.
2. Activez la biométrie de l’appareil en sélectionnant l’une des options offertes, comme **Face ID** ou **Touch ID**.
Pour activer les paramètres de sécurité de l’application Auth0 Guardian sur Android :
1. Dans l’application, sélectionnez le **menu à trois points** pour ouvrir le menu Paramètres.
2. Activez le commutateur de l’option **Toujours demander la phrase secrète**.
3. Saisissez la phrase secrète définie lors de la configuration de l’application Auth0 Guardian.
L’application est maintenant protégée par la phrase secrète Auth0 Guardian. L’utilisateur doit saisir cette phrase secrète avant de pouvoir répondre aux notifications push ou récupérer des OTP.
Après avoir activé la protection par phrase secrète, l’utilisateur peut configurer la biométrie de l’appareil comme mesure de sécurité de rechange. Pour activer la biométrie de l’appareil :
1. Dans l’application, sélectionnez le **menu à trois points** pour ouvrir le menu Paramètres.
2. Activez le commutateur de l’option **Utiliser la biométrie pour déverrouiller**.
### Options de localisation
L’application Auth0 Guardian prend en charge la localisation dans plusieurs langues et dialectes sur iOS et Android.
Dans la section Language du menu Settings, les utilisateurs peuvent sélectionner leur langue de préférence. Par défaut, l’application utilise la même langue que le système de l’appareil.
La majeure partie du contenu des notifications push s’affiche dans la langue de préférence des utilisateurs. Cependant, les titres des notifications push ne sont pas traduits, car les paramètres de langue ne sont récupérés qu’une fois le titre déjà généré.
L’application Auth0 Guardian prend en charge les langues et dialectes suivants :
| Langue | Code |
| -------------------------- | -------- |
| Albanais | `sq` |
| Amharique | `am` |
| Arabe\* | `ar` |
| Arabe (Égypte)\* | `ar-EG` |
| Arabe (Arabie saoudite)\* | `ar-SA` |
| Arménien | `hy` |
| Azerbaïdjanais | `az` |
| Basque | `eu-ES` |
| Bengali | `bn` |
| Bosniaque | `bs` |
| Bulgare | `bg` |
| Catalan | `ca-ES` |
| Chinois - Hong Kong | `zh-HK` |
| Chinois - simplifié | `zh-CN` |
| Chinois - traditionnel | `zh-TW` |
| Croate | `hr` |
| Tchèque | `cs` |
| Danois | `da` |
| Néerlandais | `nl` |
| Anglais | `en` |
| Anglais - Canada | `en-CA` |
| Estonien | `et` |
| Farsi (persan)\* | `fa` |
| Finnois | `fi` |
| Français | `fr-FR` |
| Français - Canada | `fr-CA` |
| Galicien | `gl-ES` |
| Géorgien | `ka` |
| Allemand | `de` |
| Grec | `el` |
| Gujarati | `gu` |
| Hébreu\* | `he` |
| Hindi | `hi` |
| Hongrois | `hu` |
| Islandais | `is` |
| Indonésien | `id` |
| Italien | `it` |
| Japonais | `ja` |
| Kannada | `kn` |
| Coréen | `ko` |
| Letton | `lv` |
| Lituanien | `lt` |
| Macédonien | `mk` |
| Malais | `ms` |
| Malayalam | `ml` |
| Marathi | `mr` |
| Mongol | `mn` |
| Monténégrin | `cnr` |
| Myanmar | `my` |
| Norvégien | `no` |
| Norvégien - bokmål | `nb` |
| Norvégien - nynorsk | `nn` |
| Polonais | `pl` |
| Portugais - Brésil | `pt-BR` |
| Portugais - Portugal | `pt-PT` |
| Pendjabi | `pa` |
| Roumain | `ro` |
| Russe | `ru` |
| Serbe | `sr` |
| Slovaque | `sk` |
| Slovène | `sl` |
| Somali | `so` |
| Espagnol | `es` |
| Espagnol - Argentine | `es-AR` |
| Espagnol - Amérique latine | `es-419` |
| Espagnol - Mexique | `es-MX` |
| Swahili | `sw` |
| Suédois | `sv` |
| Tagalog | `tl` |
| Tamazight | `zgh` |
| Tamoul | `ta` |
| Télougou | `te` |
| Thaï | `th` |
| Turc | `tr` |
| Ukrainien | `uk` |
| Ourdou\* | `ur` |
| Vietnamien | `vi` |
| Gallois | `cy` |
### Thèmes de l’application Auth0 Guardian
L’application Auth0 Guardian pour iOS et Android prend en charge les thèmes clair et sombre.
Dans la section Theme du Settings menu, les utilisateurs peuvent sélectionner les options suivantes :
* **System** : Utilise le thème système par défaut
* **Light** : Active le thème clair
* **Dark** : Active le thème sombre
### Options de personnalisation des applications protégées
Pour aider les utilisateurs à distinguer plus facilement leurs applications protégées dans l’application Auth0 Guardian, chaque application peut être personnalisée avec un nom distinct, une couleur d’accent et une icône.
Le nom par défaut de votre application dans l’application Auth0 Guardian est déterminé par votre [nom du tenant](/docs/fr-ca/get-started/tenant-settings/find-your-tenant-name-or-tenant-id) ou par le nom convivial défini dans vos [paramètres du tenant](/docs/fr-ca/get-started/tenant-settings). De même, le logo par défaut est tiré de l’URL du logo fournie dans vos paramètres du tenant.
Pour modifier les paramètres de votre tenant, accédez à [Auth0 Dashboard > Settings > General](https://manage.auth0.com/dashboard/#/tenant/general).
Pour personnaliser une application protégée :
1. Sélectionnez une application dans la liste.
* **Conseil** : Vous pouvez aussi balayer vers la gauche sur l’application pour afficher les options Modifier et Supprimer.
2. Sur la page Détails du compte, choisissez **Modifier**.
3. Mettez à jour le nom, la couleur et l’icône de l’application au besoin.
4. Sélectionnez **Enregistrer**.
## Guardian SDK
Vous pouvez [installer le Guardian SDK](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-developer-resources/install-guardian-sdk) (offert pour [iOS](/docs/fr-ca/secure/multi-factor-authentication/auth0-guardian/guardian-for-ios-sdk) et [Android](/docs/fr-ca/secure/multi-factor-authentication/auth0-guardian/guardian-for-android-sdk)) pour créer votre propre application d’authentification multifactorielle avec un contrôle total sur l’image de marque et l’apparence. Avec le Guardian SDK, vous pouvez créer vos propres applications mobiles personnalisées qui fonctionnent comme Guardian ou intégrer certaines fonctionnalités de Guardian, comme la réception de notifications push dans vos applications mobiles existantes. Un cas d’utilisation typique serait une application bancaire. Vous pouvez utiliser le Guardian SDK dans votre application mobile existante pour recevoir et confirmer des notifications push lorsqu’une personne effectue une transaction à un guichet automatique bancaire.
## Utiliser Actions pour activer l’authentification multifacteur avec Auth0 Guardian
Pour activer Auth0 Guardian dans une Action, utilisez `guardian` comme valeur du paramètre `provider` lorsque vous activez l’authentification multifacteur :
```js lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
api.multifactor.enable('guardian', { allowRememberBrowser: false });
};
```
Pour obliger vos utilisateurs à se connecter avec Auth0 Guardian à chaque fois, créez l’Action avec `allowRememberBrowser: false`.
## Authentification multifacteur avec Auth0 Guardian et Authorization Extension
Ce modèle fournit un exemple et un point de départ pour déclencher l’authentification multifacteur avec Auth0 Guardian au moyen de notifications push lorsqu’une condition est remplie.
Lors de la première connexion, l’utilisateur peut enregistrer son appareil. Consultez Activer l’authentification multifacteur pour en savoir plus sur M
```js lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
const groups = event.user.app_metadata.authorization.groups;
const GROUPS_WITH_MFA = {
// Ajouter ici les groupes qui nécessitent l'AMF
// Exemple
admins: true
};
const needsMFA = !!groups.find(function (group) {
return GROUPS_WITH_MFA[group];
});
if (needsMFA) {
// facultatif, vrai par défaut. Mettre à faux pour forcer l'authentification Guardian à chaque fois.
// Voir https://auth0.com/docs/secure/multi-factor-authentication/customize-mfa#change-frequency-of-mfa-prompts pour plus de détails
api.multifactor.enable('guardian', { allowRememberBrowser: false });
}
};
```
## En savoir plus
* [Installer le Guardian SDK](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-developer-resources/install-guardian-sdk)
* [SDK Guardian.swift pour iOS](/docs/fr-ca/secure/multi-factor-authentication/auth0-guardian/guardian-for-ios-sdk)
* [Guardian SDK pour Android](/docs/fr-ca/secure/multi-factor-authentication/auth0-guardian/guardian-for-android-sdk)
* [Configurer les notifications push pour la MFA](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-factors/configure-push-notifications-for-mfa)
* [Réinitialiser l’authentification multifacteur et les codes de récupération de l’utilisateur](/docs/fr-ca/secure/multi-factor-authentication/reset-user-mfa)
* [Référence des codes d’erreur de Guardian](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-developer-resources/guardian-error-code-reference)