L'API WebOTP peut désormais recevoir des OTP depuis des iFrames.
Les OTP (mots de passe à usage unique) par SMS sont couramment utilisés pour valider les numéros de téléphone, par exemple comme deuxième étape d'authentification ou pour valider les paiements sur le Web. Cependant, passer du navigateur à l'application de SMS pour copier-coller ou saisir manuellement le mot de passe à usage unique peut facilement entraîner des erreurs et complique l'expérience utilisateur.
L'API WebOTP permet aux sites Web d'obtenir de manière programmatique le mot de passe à usage unique à partir d'un SMS et de le saisir automatiquement dans le formulaire pour les utilisateurs d'un simple geste, sans changer d'application. Le SMS est spécialement formaté et lié à l'origine. Il réduit ainsi les risques que des sites Web d'hameçonnage volent également le mot de passe à usage unique.
Un cas d'utilisation qui n'est pas encore compatible avec WebOTP consistait à cibler une origine dans un iframe. Cette méthode est généralement utilisée pour la confirmation du paiement, en particulier avec 3D Secure. Grâce au format commun permettant de prendre en charge les iFrames interorigines, l'API WebOTP fournit désormais des OTP liés à des origines imbriquées à partir de Chrome 91.
Fonctionnement de l'API WebOTP
L'API WebOTP elle-même est assez simple :
…
const otp = await navigator.credentials.get({
otp: { transport:['sms'] }
});
…
Le SMS doit être mis en forme avec les codes à usage unique liés à l'origine.
Your OTP is: 123456.
@web-otp.example.com #12345
Notez que la dernière ligne contient l'origine à lier précédée d'un @, suivie du mot de passe à usage unique précédé d'un #.
Lorsque le message arrive, une barre d'informations s'affiche et invite l'utilisateur à valider son numéro de téléphone. Une fois que l'utilisateur a cliqué sur le bouton Verify, le navigateur transfère automatiquement le mot de passe à usage unique au site et résout le navigator.credentials.get(). Le site Web peut alors extraire le mot de passe à usage unique et terminer la procédure de validation.
Découvrez les principes de base de l'utilisation de WebOTP dans Valider des numéros de téléphone sur le Web avec l'API WebOTP.
Cas d'utilisation des iFrames interorigines
La saisie d'un OTP dans un formulaire au sein d'un iFrame interorigine est courante dans les scénarios de paiement. Certains émetteurs de cartes de crédit exigent une étape de validation supplémentaire pour vérifier l'authenticité du payeur. Il s'agit du protocole 3D Secure. Le formulaire est généralement exposé dans un iFrame sur la même page, comme s'il faisait partie du flux de paiement.
Exemple :
- Un utilisateur consulte
shop.examplepour acheter une paire de chaussures avec une carte de crédit. - Après avoir saisi le numéro de carte de crédit, le fournisseur de services de paiement intégré affiche un formulaire de
bank.exampledans un iframe, demandant à l'utilisateur de valider son numéro de téléphone pour un règlement rapide. bank.exampleenvoie un SMS contenant un OTP à l'utilisateur afin qu'il puisse le saisir pour valider son identité.
Utiliser l'API WebOTP à partir d'un iFrame interorigine
Pour utiliser l'API WebOTP à partir d'un iFrame interorigine, vous devez effectuer deux opérations :
- Annotez l'origine du frame supérieur et l'origine de l'iframe dans le SMS.
- Configurez la règle d'autorisation pour permettre à l'iframe interorigine de recevoir l'OTP directement de l'utilisateur.
Vous pouvez essayer la démonstration vous-même sur https://web-otp-iframe-demo.stackblitz.io.
Annoter les origines liées au SMS
Lorsque l'API WebOTP est appelée depuis un iFrame, le SMS doit inclure l'origine du frame supérieur précédée de @, suivie du mot de passe à usage unique précédé de #, suivi de l'origine de l'iFrame précédée de @.
@shop.example #123456 @bank.exmple
Configurer les règles d'autorisation
Pour utiliser WebOTP dans un iFrame interorigine, l'intégrateur doit accorder l'accès à cette API via la règle d'autorisation otp-credentials afin d'éviter tout comportement involontaire. En général, il existe deux façons d'atteindre cet objectif :
- via l'en-tête HTTP :
Permissions-Policy: otp-credentials=(self "https://bank.example")
- via l'attribut iframe
allow:
<iframe src="https://bank.example/…" allow="otp-credentials"></iframe>
Découvrez d'autres exemples de spécification d'une règle d'autorisation.
Mises en garde
Niveaux d'imbrication
Pour le moment, Chrome n'accepte que les appels d'API WebOTP provenant d'iFrames interorigines qui n'ont pas plus d'une origine unique dans leur chaîne d'ancêtres. Dans les scénarios suivants :
- a.com -> b.com
- a.com -> b.com -> b.com
- a.com -> a.com -> b.com
- a.com -> b.com -> c.com
L'utilisation de WebOTP dans b.com est acceptée, mais pas dans c.com.
Notez que le scénario suivant n'est pas non plus pris en charge en raison d'un manque de demande et de la complexité de l'expérience utilisateur.
- a.com -> b.com -> a.com (appelle l'API WebOTP)
Interopérabilité
Bien que les moteurs de navigateur autres que Chromium n'implémentent pas l'API WebOTP, Safari partage le même format de SMS avec sa compatibilité input[autocomplete="one-time-code"]. Dans Safari, dès qu'un SMS contenant un code à usage unique lié à l'origine arrive avec l'origine correspondante, le clavier suggère de saisir le code à usage unique dans le champ de saisie.
Depuis avril 2021, Safari accepte les iFrames avec un format de SMS unique utilisant %.
Toutefois, comme la discussion sur les spécifications a conclu à l'utilisation de @, nous espérons que l'implémentation du format SMS accepté convergera.
Commentaires
Vos commentaires sont précieux pour améliorer l'API WebOTP. N'hésitez pas à l'essayer et à nous dire ce que vous en pensez.