Rectifié le 20 octobre 2026 : une version précédente de cet article affirmait que demander
age_over_18ne révèle pas la date de naissance, comme si le PID EUDI contenait cet attribut. Ce n'est pas le cas : à partir d'un PID, le vérificateur reçoit la date de naissance et en déduit lui-même le oui/non ; unage_over_18sans date de naissance n'existe que dans l'attestation de preuve d'âge distincte. Les exemples de code ont aussi été alignés sur l'API réelle d'@openeudi. Nous avons également corrigé la façon dont une demande désigne ce qu'elle veut : OpenID4VP 1.0 utilise DCQL (dcql_query) ; Presentation Exchange 2.0 n'appartenait qu'aux versions préliminaires. Enfin, nous avons retiré l'affirmation selon laquelle OpenEUDI fournit une cartographie de conformité par pays — ce n'est pas le cas. Nous avons aussi précisé que c'est le portefeuille, et non le SDK du vérificateur, qui contrôle le WRPAC.
Qu'est-ce qu'OpenID4VP ?
OpenID for Verifiable Presentations (OpenID4VP) est le protocole qui permet aux portefeuilles d'identité numérique européens de partager des attributs d'identité vérifiés avec les entreprises, appelées parties utilisatrices. C'est l'épine dorsale technique du flux de vérification d'identité eIDAS 2.0.
Quand un utilisateur scanne un QR code au moment du paiement et que son portefeuille renvoie l'attribut signé qui permet à la boutique de répondre à la question "cette personne a-t-elle plus de 18 ans ?", cet échange passe par OpenID4VP.
Le flux de vérification
Le flux OpenID4VP implique quatre acteurs :
- Émetteur : l'autorité publique ou de confiance qui a émis le justificatif (par exemple l'État autrichien pour une carte d'identité nationale)
- Titulaire : le citoyen qui possède le portefeuille EUDI sur son téléphone
- Vérificateur (partie utilisatrice) : l'entreprise qui demande la vérification (votre boutique en ligne, votre système KYC, etc.)
- Cadre de confiance : les listes de confiance de l'UE qui établissent quels émetteurs et quels vérificateurs sont légitimes
Le flux étape par étape
1. Le vérificateur crée une Authorization Request
↓
2. La requête est encodée dans un QR code (ou un deep link)
↓
3. Le titulaire scanne le QR code avec son portefeuille EUDI
↓
4. Le portefeuille analyse la requête et affiche ce qui est demandé
↓
5. Le titulaire examine et approuve avec biométrie/PIN
↓
6. Le portefeuille crée une Verifiable Presentation (VP)
↓
7. La VP est envoyée au point de réponse du vérificateur
↓
8. Le vérificateur valide cryptographiquement la VP
↓
9. Les attributs vérifiés sont extraits et utilisés
Deux formats de justificatifs
Les portefeuilles EUDI prennent en charge deux formats de justificatifs, chacun avec son propre chemin de vérification cryptographique :
SD-JWT VC (Selective Disclosure JWT)
Utilisé pour les flux de vérification à distance (en ligne, multi-appareils). Le justificatif est un JSON Web Token avec capacités de divulgation sélective.
- Format : basé sur JSON
- Divulgation sélective : salage fondé sur des hachages ; l'émetteur signe toutes les déclarations, mais le titulaire ne révèle que celles qu'il choisit
- Signature : JWS (JSON Web Signature) avec ES256
- Vérification : analyse du JWT -> reconstruction des éléments divulgués -> vérification des hachages -> validation de la signature -> contrôle de la chaîne de confiance de l'émetteur
Header.Payload.Signature~Disclosure1~Disclosure2~KeyBindingJWT
mdoc / mDL (Mobile Document)
Utilisé pour les flux de vérification de proximité (présentiel, NFC, BLE). Il repose sur la norme ISO 18013-5.
- Format : basé sur CBOR (binaire)
- Divulgation sélective : intégrée à la structure des données, avec espaces de noms et éléments de données
- Signature : COSE (CBOR Object Signing and Encryption)
- Vérification : décodage CBOR -> vérification de la signature COSE -> validation de l'authentification du dispositif -> contrôle de la chaîne de certificats de l'émetteur
Les deux formats atteignent le même objectif : prouver cryptographiquement qu'un émetteur de confiance a attesté certaines informations sur le titulaire, mais via des chemins techniques fondamentalement différents.
Demander des attributs : DCQL
La demande d'autorisation indique précisément au portefeuille quel justificatif et quelles informations le vérificateur souhaite obtenir. OpenID4VP 1.0 l'exprime avec le Digital Credentials Query Language (DCQL), transmis dans le paramètre dcql_query. (Les versions préliminaires d'OpenID4VP utilisaient à la place DIF Presentation Exchange 2.0 et un objet presentation_definition ; la version 1.0 l'a remplacé par DCQL.)
Une vérification d'âge sur le PID au format SD-JWT VC ne demande qu'une information — la date de naissance :
{ "credentials": [{ "id": "pid", "format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:eudi:pid:1"] },
"claims": [{ "path": ["birthdate"] }] }] }
La même demande sur le PID au format mdoc utilise l'espace de noms eu.europa.ec.eudi.pid.1 et l'élément birth_date. DCQL permet aussi de proposer des alternatives : avec credential_sets, un vérificateur peut demander « une attestation de preuve d'âge ou un PID », et le portefeuille renvoie l'un des deux.
WRPAC : le certificat du vérificateur
Pour émettre une demande de vérification, la partie utilisatrice a besoin d'un WRPAC (Wallet Relying Party Access Certificate). Ce certificat, défini dans ETSI TS 119 475 :
- identifie la partie utilisatrice auprès du portefeuille
- précise quels attributs la RP est autorisée à demander
- est délivré par un prestataire de services de confiance qualifié
- doit être validé par rapport aux listes de confiance de l'UE
Le portefeuille vérifie le WRPAC avant d'afficher l'écran de consentement. Si le certificat est invalide, expiré ou absent de la liste de confiance, le portefeuille refuse la requête.
Les listes de confiance de l'UE
L'UE maintient une infrastructure de confiance hiérarchique :
EU List of Trusted Lists (LOTL)
└── Country Trusted List (ex. Luxembourg)
└── Trust Service Provider (ex. LuxTrust)
└── Trust Service (ex. émission de WRPAC)
└── Certificate (votre WRPAC)
C'est le portefeuille qui parcourt cette hiérarchie pour vérifier qu'un WRPAC a bien été délivré par un prestataire légitime dans un État membre reconnu. Côté vérificateur, le SDK fait le travail symétrique : il vérifie que l'attestation reçue a été signée par un émetteur dont le certificat remonte à une ancre de confiance issue d'une liste publiée (pour les PID, la liste des fournisseurs de PID). C'est l'une des parties les plus complexes de l'implémentation : le format des listes de confiance (XML/JSON) a ses propres contraintes d'analyse, et les listes sont mises à jour indépendamment par chaque État membre.
Protection de la vie privée dès la conception
OpenID4VP impose la confidentialité au niveau du protocole :
- Divulgation sélective : le titulaire choisit exactement les attributs à partager. Une vérification d'âge à partir du PID ne divulgue que la date de naissance — ni le nom, ni l'adresse, ni le numéro de document — et le vérificateur la réduit à un oui/non. Un
age_over_18sans date de naissance n'existe que dans l'attestation de preuve d'âge distincte (eu.europa.ec.av.1), pas dans le PID. - Absence de corrélation : chaque session de vérification utilise du matériel cryptographique frais, ce qui empêche les vérificateurs de relier les sessions entre elles.
- Consentement du titulaire : chaque demande d'attribut nécessite une approbation explicite de l'utilisateur sur son appareil.
- Minimisation des données : le protocole encourage à ne demander que le strict nécessaire. L'interface du portefeuille rend visible toute demande excessive.
Cela diffère fondamentalement du KYC traditionnel, où les entreprises reçoivent souvent, puis stockent, davantage de données que nécessaire.
Comment OpenEUDI implémente cela
Le SDK OpenEUDI est organisé en couches. Le package @openeudi/openid4vp implémente l'analyse des justificatifs avec une API simple : parsePresentation(vpToken, options) détecte automatiquement le format du justificatif (SD-JWT VC ou mDOC), valide les signatures cryptographiques et renvoie les attributs vérifiés.
import { parsePresentation } from '@openeudi/openid4vp';
// Gère automatiquement les formats SD-JWT VC et mDOC
const result = await parsePresentation(vpToken, {
nonce, // le nonce de votre Authorization Request
trustedCertificates, // ancres de confiance des émetteurs (DER), p. ex. issues des listes de confiance de l'UE
});
// result.valid — contrôles de signature, de key binding et de confiance réussis
// result.format — 'sd-jwt-vc' | 'mdoc'
// result.claims — attributs vérifiés et divulgués sélectivement (p. ex. la date de naissance du PID)
Le VerificationService, de plus haut niveau, s'appuie sur cette couche pour gérer tout le cycle de vie de la session :
import { VerificationService, VerificationType } from '@openeudi/core';
import type { IVerificationMode } from '@openeudi/core';
// @openeudi/core fournit DemoMode et MockMode. Pour de vrais portefeuilles, il faut
// votre propre IVerificationMode : il construit la requête OpenID4VP (signée avec
// votre WRPAC) et vérifie la réponse avec @openeudi/openid4vp.
declare const productionMode: IVerificationMode;
const service = new VerificationService({ mode: productionMode });
const session = await service.createSession({ type: VerificationType.AGE });
// session.walletUrl — à afficher en QR code ou en deep link
service.on('session:verified', (session, result) => {
// result.ageVerified — un booléen dérivé ; la date de naissance ne fait pas partie du résultat
});
En interne, le service et son mode de vérification :
- construisent une Authorization Request conforme à la spécification
- l'encodent en QR code (
generateQRCodede@openeudi/core/qr) - reçoivent la VP du portefeuille via
service.handleCallback(), appelé depuis votre point de réponse - valident la VP via
@openeudi/openid4vp(SD-JWT VC ou mdoc) - vérifient le certificat de l'émetteur par rapport aux listes de confiance de l'UE
- réduisent les attributs divulgués au résultat de la règle (
ageVerified,countryVerified) — une date de naissance sert au contrôle, elle n'est pas renvoyée - font expirer les sessions à la fin de leur TTL (cinq minutes par défaut)
Tout cela se passe derrière service.createSession(), service.handleCallback() et l'événement session:verified.
Conformité transfrontalière
Chaque État membre de l'UE conserve une certaine marge de manœuvre sur les attributs pouvant être demandés et sur les conditions applicables. Par exemple :
- les seuils de vérification d'âge varient selon les catégories de produits et les pays
- certains pays restreignent la divulgation de certains attributs
- les implémentations nationales de portefeuilles peuvent utiliser des schémas de justificatifs différents
Avant de construire une demande, vérifiez ce que le justificatif contient réellement : dans tout PID, birth_date et nationality sont obligatoires, tandis que resident_country est facultatif et peut manquer.
Les prochaines évolutions du protocole
OpenID4VP 1.0 est une spécification finale de l'OpenID Foundation, et DCQL en est le langage de requête — Presentation Exchange n'en fait pas partie. Le travail se poursuit désormais autour du protocole de base :
- Statut des justificatifs : vérifier si un justificatif a été révoqué
- Améliorations des flux multi-appareils : meilleure UX pour la vérification mobile-vers-desktop
- Alternatives dans une même demande : les
credential_setsde DCQL, par exemple « attestation de preuve d'âge ou PID »
OpenEUDI publie les évolutions du protocole sous forme de nouvelles versions de ses paquets npm.
OpenEUDI implémente OpenID4VP pour l'écosystème des portefeuilles EUDI. Le SDK est sous licence Apache 2.0 et gratuit. Pour les déploiements en production avec des certificats WRPAC managés, consultez les offres managées d'eIDAS Pro.
Articles similaires
Démarrage rapide du SDK OpenEUDI : votre première vérification en 5 minutes
Un tutoriel pas à pas pour installer le SDK OpenEUDI, créer une session de vérification et traiter le résultat, le tout en moins de 5 minutes avec le mode DEMO.
6 min de lecture
Comment fonctionne la vérification eIDAS : analyse technique approfondie
Une analyse technique complète du flux de vérification eIDAS, de la génération du QR code à la validation des attributs, avec les protocoles, les mesures de sécurité et les modèles d'intégration.
12 min de lecture
Partager cet article
Aidez les autres à en savoir plus sur la vérification eIDAS