Cas d’usage

ExcelID sur le même appareil

Cette page décrit un cas d’usage courant : l’utilisateur veut s’identifier ou signer quelque chose dans votre service, avec ExcelID mobile, sur l’appareil même où il visite le service.

Votre frontendVotre backendService ExcelIDApp ExcelID A · Identifier/authorderRef, autoStartTokenautoStartTokenB · ouvre l’app (autostart)C · retour : returnUrlD · /collect toutes les 2 s

A. L’utilisateur choisit « Se connecter avec ExcelID » dans votre service.

  1. Votre frontend appelle votre backend pour indiquer que l’utilisateur veut s’identifier.
  2. Votre backend appelle le service ExcelID pour créer une demande.
  3. Le service ExcelID renvoie un orderRef et un autoStartToken.
  4. Votre backend transmet l’autoStartToken à votre client.
  5. Votre frontend lance l’application ExcelID avec l’autoStartToken (voir Démarrage automatique).

B. L’application ExcelID s’ouvre sur l’appareil de l’utilisateur. Il s’identifie dans l’application.

L’application affiche l’écran « Identification » : le nom du titulaire, votre nom, et l’intention (votre userVisibleData). L’utilisateur confirme avec son empreinte ou son code de sécurité.

C. L’application se ferme et l’utilisateur revient sur votre frontend.

L’application ramène l’utilisateur à la returnUrl que vous avez donnée à la création de la demande (voir URL de retour).

D. En arrière-plan, votre backend vérifie l’état de la demande.

  1. Votre backend appelle /collect toutes les 2 secondes pour connaître l’état.
  2. Quand la demande est terminée, votre backend reçoit le personalNumber utilisé ainsi que d’autres informations sur l’utilisateur.
  3. Vérifiez que l’ipAddress reçue de /collect correspond à l’adresse IP que vous observez. C’est important pour éviter la fixation de session.
  4. L’utilisateur est identifié dans votre service.