Vérification d’identité Persona

Certaines capsules ne doivent être démarrées que par un apprenant dont l’identité a été vérifiée. Beedeez s’appuie pour cela sur Persona, un prestataire externe de vérification d’identité. La condition se règle capsule par capsule : tant que l’apprenant ne dispose pas d’une vérification valide, il ne peut pas démarrer le contenu.

⚠️ Prérequis : cette intégration repose sur une option de compte ouverte par Beedeez. Sans elle, ni la ligne Persona ni la condition d’activation correspondante n’apparaissent. Vous devez également disposer d’un contrat Persona, d’une clé API et d’au moins un template d’enquête créé chez le prestataire.

⚠️ Droits nécessaires : l’accès à la configuration du compte et à l’éditeur de capsule.

Configurer Persona pour le compte

Ouvrez Configuration > Intégration > Services externes, activez la ligne Persona, puis cliquez sur Configuration Persona. La modale contient six champs :

• Clé API : la clé fournie par Persona. Elle est masquée une fois enregistrée.
• Secret webhook : le secret qui authentifie les appels envoyés par Persona. Il est également masqué une fois enregistré.
• ID du template d’enquête (itmpl…) : le formulaire Persona joué lors de la première vérification d’un apprenant. L’identifiant doit commencer par itmpl.
• ID du template de renouvellement (itmpl…) : le formulaire joué à partir de la deuxième vérification du même apprenant. Il n’est utilisé que s’il est renseigné et commence par itmpl ; sinon, le template d’enquête initial est rejoué.
• Nom de l’en-tête webhook : l’en-tête dans lequel Persona transmet sa signature. La valeur par défaut est persona-signature.
• TTL de vérification (minutes) : la durée pendant laquelle une vérification approuvée reste valide. La valeur par défaut correspond à 24 heures.

Tant que l’intégration n’est pas activée, ou que la clé API ou l’ID du template d’enquête est absent ou invalide, aucune vérification ne peut démarrer et l’apprenant voit un message d’erreur au moment de lancer la vérification.

Activer la condition sur une capsule

Dans l’éditeur de capsule, ouvrez l’onglet Diffusion, sous-onglet Global, bloc Visibilité de la capsule. Sous Je souhaite que ma capsule :, sélectionnez Conditions de visibilité et d’activation personnalisées, puis choisissez Après vérification d’identité (Persona) dans le sélecteur Condition d’activation.

⚠️ Sélectionner l’option personnalisée place d’abord la condition d’activation sur Par code / QR code. Reprenez le sélecteur pour poser la condition Persona, sinon la capsule reste inaccessible sans code.

Deux réglages complémentaires s’ajoutent alors :

• Activer une durée de validité spécifique à cette capsule : la vérification demandée pour cette capsule est isolée de celles des autres capsules.
• Durée de validité de la vérification (minutes) : la durée retenue pour cette capsule, avec un plancher de 5 minutes.

Portée d’une vérification approuvée

Sans Activer une durée de validité spécifique à cette capsule, une vérification approuvée vaut pour toutes les capsules du compte soumises à la même condition, pendant toute la durée définie par le TTL de vérification (minutes), soit 24 heures avec la valeur par défaut. Un apprenant vérifié sur une première capsule démarre donc les suivantes sans nouvelle vérification.

Activez le réglage spécifique à la capsule lorsque vous voulez qu’une vérification distincte soit exigée pour ce contenu précis.

ℹ️ À savoir. La validité est recontrôlée à l’ouverture de la capsule. Si elle a expiré, ou si ce contrôle échoue faute de réseau, la capsule se referme et l’apprenant revient à la page de démarrage.

Le parcours de l’apprenant

Sur la vignette de la capsule, l’apprenant voit une pastille Vérification d’identité requise. Sur la page de démarrage, un encadré verrouillé porte le même titre et affiche le message « Vous devez réaliser une vérification d’identité avant de démarrer cette capsule. » Le bouton d’action devient Vérifier l’identité.

Un appui sur ce bouton crée une enquête chez Persona et ouvre le flux hébergé par le prestataire : en plein écran dans l’application sur mobile, dans une pop-up sur navigateur, avec un repli sur une redirection si la pop-up est bloquée. Les informations demandées y sont définies par le template d’enquête, pas par Beedeez.

L’application interroge Beedeez toutes les 3 secondes tant que le flux est ouvert, et démarre la capsule dès l’approbation. La page affiche ensuite Identité vérifiée jusqu’au suivi de la date d’expiration. Si l’enquête ne peut pas être créée, l’apprenant lit : « Impossible de démarrer la vérification d’identité pour le moment. Veuillez réessayer plus tard. »

La réception du résultat par Beedeez

Persona rappelle Beedeez sur POST /api/v1/webhooks/persona. L’appel est authentifié par une signature HMAC-SHA256 calculée sur l’horodatage et le corps brut de la requête, transmise dans l’en-tête configuré au format t=…,v1=…, avec une tolérance de 5 minutes sur l’horodatage. Sans Secret webhook enregistré, l’appel est rejeté avec un code 401. Seuls les événements inquiry.* sont traités ; les autres sont ignorés.

L’apprenant concerné est retrouvé par les métadonnées de l’enquête, ou à défaut par la référence de la forme ownerId:userId. Le statut renvoyé par Persona est ramené à trois valeurs : approuvée, refusée ou en attente. Une vérification déjà approuvée n’est jamais rétrogradée par un appel ultérieur.

Les données conservées par Beedeez

ℹ️ À savoir. Aucune pièce d’identité, aucune photo, aucun nom et aucune date de naissance ne transitent par Beedeez. Le document reste chez Persona et sa conservation relève de votre contrat avec le prestataire.

Beedeez enregistre, pour chaque vérification : l’identifiant de l’enquête et celui du template utilisé, le statut ramené aux trois valeurs ci-dessus, les dates de vérification, d’expiration et du dernier appel reçu, un indicateur de première vérification réalisée, et un résumé d’audit de l’événement contenant son nom, l’identifiant d’enquête, le statut brut, la date de réception et les identifiants du compte et de l’apprenant.

Ce que la fonctionnalité ne permet pas

• Aucun écran du back-office n’affiche le statut de vérification d’un apprenant, ni dans une liste, ni dans une fiche, ni dans un export.
• Aucune validation manuelle n’est possible. Un administrateur ne peut ni approuver ni débloquer un apprenant : celui qui échoue de façon répétée n’a pas de recours dans le produit.
• Le nombre de tentatives n’est pas limité. Chaque relance crée une nouvelle enquête chez Persona.
• Ces enregistrements échappent à l’export de données personnelles et à l’anonymisation d’un compte apprenant. Signalez-le à votre délégué à la protection des données.
• La vérification ne s’applique ni en prévisualisation, ni en relecture, ni dans une session.

Pour aller plus loin

• Conditions de visibilité et d’activation d’une capsule : où se choisit la condition d’activation et quelles autres conditions sont disponibles.
• Configurer un endpoint webhook : la mécanique des webhooks Beedeez, pour situer celui de Persona.
• Configurer la sécurité, le RGPD et les informations légales : le cadre à régler avec votre délégué à la protection des données avant la première utilisation.