Non standard
Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.
Résumé
Le protocole BrowserID définit une nouvelle propriété id
dans l'objet window.navigator
, dans laquelle l'API BrowserID est rendue disponible. Cette API a subi plusieurs importantes modifications. Chaque modification est listée séparément ci-dessous.
L'API "Observer" (actuelle)
L'API Observer introduit des fonctionnalités très demandées telles qu'une post-vérification améliorée pour les nouveaux-venus, des connexions automatiques et une meilleure intégration avec les applications natives.
-
navigator.id.watch()
- Ajoute une fonction de rappel invoquée lorsqu'un utilisateur se connecte ou se déconnecte d'un site.
-
navigator.id.request()
- Demande à l'utilisateur de fournir une assertion d'identité.
-
navigator.id.logout()
-
Déconnecte l'utilisateur du site et empêche l'action
onlogin
de se produire automatiquement lors de sa prochaine visite.
Les utilisateurs ayant désactivés les cookies tiers peuvent recontrer des problèmes en se connectant via l'API Observer comme expliqué dans le problème 2999.
L'API "Callback" (actuelle)
L'API Callback a été introduite en Novembre 2011. Elle améliore alors l'API initiale en permettant de passer des options à navigator.id.get()
et offre un support expérimental pour les connexions automatiques gérées par BrowserID.
-
navigator.id.get()
- Récupère le BrowserID de l'utilisateur dans une assertion.
L'API "VerifiedEmail" (obsolète)
L'API VerifiedEmail fût la première API BrowserID. Elle a été dépréciée fin 2011.
-
navigator.id.getVerifiedEmail()
-
Récupère le BrowserID de l'utilisateur dans une assertion. Cette méthode est obsolète ;
navigator.id.get()
est rétrocompatible et peut être utilisé à la place.