Auth0.swift: Authentification Passwordless

Utiliser Auth0.Swift en mode Passwordless

Passwordless permet aux utilisateurs de se connecter uniquement avec une adresse courriel ou un numéro de téléphone, ce qui réduit les obstacles liés à la mémorisation d’un mot de passe. L’authentification Passwordless peut se faire par courriel ou par SMS, soit en envoyant un code à l’utilisateur, soit en lui envoyant un lien qui contient un code.

Pour utiliser l’authentification Passwordless, vous devez disposer d’Auth0.Swift version 1.20.0 ou ultérieure.

Fonctionnement de Passwordless

Passwordless nécessite deux étapes :

1. Demander le code
2. Saisir le code

Lorsqu’on utilise des liens, le principe est le même, mais d’une façon légèrement différente, puisque l’utilisateur n’a pas à saisir lui-même un code. Le code est inclus dans l’URL.

Étape 1 : Demander le code

Dans cet exemple, pour demander le code, on appelle startPasswordless avec l’adresse courriel de l’utilisateur et le type de connexion. Le paramètre type prendra par défaut la valeur Code. En cas de réussite, vous afficherez probablement un avis à l’utilisateur pour l’informer qu’il recevra son code sous peu, puis vous le redirigerez peut-être vers une vue où il pourra le saisir.

Auth0
   .authentication()
   .startPasswordless(email: "[e-mail]")
   .start { result in
       switch result {
       case .success:
           print("Sent OTP to [e-mail]!")
       case .failure(let error):
           print(error)
       }
   }

Étape 2 : Saisir le code

Une fois que l’utilisateur a reçu un code, il peut le saisir. Appelez la méthode login, puis transmettez l’adresse courriel de l’utilisateur, le code qu’il a reçu et le nom de la connexion concernée. En cas de réussite, vous recevrez un objet Credentials dans la réponse.

Auth0
   .authentication()
   .login(
       email: "[e-mail]", 
       code: "123456", 
       audience: "https://myapi.com/api",
       scope: "openid email")
   .start { result in
       switch result {
       case .success(let credentials):
           print("Access Token: \(credentials.accessToken)")
       case .failure(let error):
           print(error)
       }
   }

Si vous utilisiez le SMS, la requête ressemblerait plutôt à cet exemple-ci :

Auth0
   .authentication()
   .login(
       phoneNumber: "[phone]", 
       code: "123456", 
       audience: "https://myapi.com/api",
       scope: "openid email")
   .start { result in
       switch result {
       case .success(let credentials):
           print("Access Token: \(credentials.accessToken)")
       case .failure(let error):
           print(error)
       }
   }

Paramètres de Passwordless

L’authentification Passwordless peut être lancée avec différents paramètres.

Par exemple :

.startPasswordless(email: String, type: String, connection: String)

ou

.startPasswordless(phoneNumber: String, type: String, connection: String)

Paramètre	Obligatoire	Description
email	obligatoire	(String) email ou phoneNumber est obligatoire (pas les deux), selon celui qui est utilisé.
phoneNumber	obligatoire	(String) email ou phoneNumber est obligatoire (pas les deux), selon celui qui est utilisé.
type	facultatif	(String) Le type de transaction Passwordless à utiliser, soit .Code, soit .iOSLink. La valeur par défaut est .Code.
connection	facultatif	(String) Le nom de la connexion à utiliser pour l’authentification Passwordless. La valeur par défaut est sms pour la surcharge SMS, ou email pour la surcharge par courriel.