Gestion des méthodes d’authentification sur iOS

Affichez une interface utilisateur plein écran permettant aux utilisateurs d’inscrire, de consulter et de supprimer des facteurs MFA, des clés d’accès et des codes de récupération au moyen de l’API My Account d’Auth0 sur iOS.

Le SDK Universal Components pour iOS comprend le composant MyAccountAuthMethodsView, une vue SwiftUI qui gère tous les flux d’inscription, de vérification, d’affichage et de suppression à l’aide de l’API My Account.

Il utilise les fonctionnalités de gestion des méthodes d’authentification de l’API My Account pour afficher une interface utilisateur complète permettant de gérer les méthodes d’authentification d’un utilisateur.

Avec le composant MyAccountAuthMethodsView, vous n’avez pas à gérer la navigation, à effectuer des requêtes vers des endpoints ni à gérer le state.

​

Prérequis de configuration

Avant d’afficher le composant MyAccountAuthMethodsView, suivez Créer une interface de sécurité de compte en libre-service pour installer le SDK, configurer votre tenant Auth0 et initialiser le SDK avec un fournisseur de jetons.

Le composant MyAccountAuthMethodsView récupère sa configuration, son fournisseur de jetons et ses paramètres de clés d’accès à partir du SDK initialisé.

​

Facteurs pris en charge

Le composant prend en charge toutes les méthodes d’authentification configurées avec l’API My Account. L’écran de chaque facteur hérite du thème actif du composant. Pour en savoir plus, consultez Personnaliser le style et les thèmes.

Facteur	Ce que le composant affiche	Notes sur le SDK
Email OTP	Saisie de l’adresse courriel → vérification par OTP à 6 chiffres	Le remplissage automatique des OTP de la plateforme (iOS QuickType) renseigne automatiquement le champ OTP.
SMS OTP	Sélecteur d’indicatif de pays + saisie du numéro de téléphone → vérification par OTP à 6 chiffres	Le remplissage automatique avec le clavier système fonctionne normalement.
TOTP (application d’authentification)	Code QR avec clé de saisie manuelle → vérification par OTP à 6 chiffres	Affiche le payload otpauth:// standard. Aucun logo d’image de marque personnalisé n’est intégré au code QR.
Notifications poussées	Code QR à balayer avec Auth0 Guardian → état « en attente d’approbation »	Les utilisateurs finaux doivent utiliser l’application publique Auth0 Guardian. Les clients d’entreprise disposant d’une version personnalisée du Guardian SDK doivent fournir leur propre lien d’installation à l’extérieur du composant.
Clés d’accès	Écran d’information → invite biométrique du système d’exploitation → entrée enregistrée dans la liste	Nécessite les domaines associés Apple (iOS 16.6+). Consultez la page dédiée pour configurer la plateforme.
Codes de récupération	Liste de codes affichée une seule fois, avec une action de copie et une confirmation « J’ai enregistré mes codes »	Les codes sont affichés à l’utilisateur et ne sont jamais renvoyés à l’appelant. L’action de copie dans le presse-papiers utilise l’API de presse-papiers standard de la plateforme.

​

Pour commencer

Ajoutez le composant MyAccountAuthMethodsView n’importe où dans votre hiérarchie SwiftUI, généralement accessible par un lien de navigation dans les paramètres.

SettingsView.swift

import SwiftUI
import Auth0UniversalComponents

struct SettingsView: View {
    var body: some View {
        NavigationStack {
            List {
                NavigationLink(destination: MyAccountAuthMethodsView()) {
                    Label("Authentication Methods", systemImage: "lock.shield")
                }
            }
            .navigationTitle("Account Settings")
        }
    }
}

La vue Swift ne nécessite aucun paramètre d’initialisation. Pour personnaliser son comportement, utilisez les modificateurs de vue SwiftUI et les valeurs d’environnement.

​

Paramètres

Le composant MyAccountAuthMethodsView accepte les valeurs de modificateur et d’environnement suivantes :

Valeurs de modificateur / d’environnement	Type	Objectif
.auth0Theme(_:)	Auth0Theme	Remplace les jetons de conception — couleurs, typographie, espacement, rayons, tailles. Pour en savoir plus, consultez Personnaliser le style et les thèmes.
.embeddedInNavigationStack()	—	Indique que la vue est intégrée à un NavigationStack hôte afin que le SDK ajoute des éléments à votre pile plutôt que de créer la sienne.
\.hostNavigationPath	Binding<NavigationPath>	Liaison d’environnement utilisée par le SDK pour ajouter des destinations à la pile de navigation hôte. Obligatoire lorsque vous appelez .embeddedInNavigationStack().

​

Personnaliser

La personnalisation du thème s’applique à l’ensemble du composant; les écrans de chaque facteur héritent du thème actif.

Pour en savoir plus sur le catalogue complet de jetons et les modèles pour le mode sombre, consultez Personnaliser le style et les thèmes.

​

Intégrer à une NavigationStack hôte

Par défaut, le composant MyAccountAuthMethodsView gère sa propre NavigationStack.

Si votre application gère déjà une pile de navigation, l’imbrication d’une deuxième pile perturbe le fonctionnement du bouton Retour et des gestes de balayage pour revenir en arrière. Intégrez plutôt le composant MyAccountAuthMethodsView à votre pile.

NavigationStack(path: $path) {
    List {
        NavigationLink("Authentication methods", value: "auth-methods")
    }
    .navigationDestination(for: String.self) { value in
        if value == "auth-methods" {
            MyAccountAuthMethodsView()
                .embeddedInNavigationStack()
        }
    }
}
.environment(\.hostNavigationPath, $path)

L’utilisation du mode intégré exige deux éléments :

• Ajoutez le modificateur .embeddedInNavigationStack() au composant MyAccountAuthMethodsView afin d’éviter la création d’une pile interne.

• Ajoutez le modificateur \.hostNavigationPath au NavigationStack externe pour indiquer au SDK à quelle liaison de chemin ajouter un élément.

Le SDK expose également une classe d’aide Router pour les applications qui souhaitent disposer d’un contrôleur de navigation typé pour leurs propres routes.

Elle n’est pas nécessaire à la gestion de la navigation interne du SDK. Utilisez-la uniquement si vous souhaitez appliquer le même modèle aux écrans de votre application.

​

Localisation

Universal Components pour iOS ne proposent pas de chaînes de caractères localisées. Le texte destiné aux utilisateurs est en anglais.

Si la localisation constitue un obstacle à votre intégration, veuillez soumettre une demande de fonctionnalité dans le dépôt ui-components-ios.

​

Limites

• Aucun composant de facteur autonome sur iOS. Chaque facteur s’affiche dans le composant gestion des méthodes d’authentification. Aucune API publique ne permet d’inscrire, de vérifier ou de supprimer un seul facteur depuis une autre partie de votre application.
• Aucun composant autonome pour lister ou supprimer des facteurs. Le SDK ne fournit pas de composants publics permettant de lister les facteurs inscrits ou de les supprimer en dehors de ce composant. Utilisez le composant gestion des méthodes d’authentification pour une expérience de gestion complète.

​

En savoir plus

Créer une interface de sécurité de compte en libre-service

Initialisez le SDK et reliez le fournisseur de jetons à votre tenant Auth0.

Personnalisez les styles et les thèmes

Remplacez les jetons de couleur, de typographie, d’espacement, de rayon et de taille à l’aide du système de jetons de conception d’Auth0.