Supported Protocols
EUDIPLO is deliberately limited to protocols that are part of the European Digital Identity Wallet (EUDI Wallet) ecosystem. This focused scope reduces implementation complexity, improves long-term maintainability, and ensures a consistent trust model across services.
Rather than being a general-purpose verifiable credentials broker, EUDIPLO aligns strictly with the specifications endorsed by the EU regulatory and technical framework.
Protocol Overviewโ
| Protocol | Description |
|---|---|
| OpenID for Verifiable Credential Issuance (OID4VCI) | Enables issuers to deliver verifiable credentials to EUDI Wallets using OAuth-based flows |
| OpenID for Verifiable Presentations (OID4VP) | Allows services to request and verify credentials presented by EUDI Wallet holders |
| Selective Disclosure JWT VC (SD-JWT VC) | Data model for credentials allowing selective disclosure of individual claims by the user |
| Mobile Driving License (mDOC/mDL) | ISO 18013-5 standard for mobile driving licenses and other mobile documents |
| OAuth Token Status List | Mechanism for determining revocation or suspension status of issued credentials |
OID4VCI Featuresโ
EUDIPLO implements the following OID4VCI (OpenID for Verifiable Credential Issuance) features:
| Feature | Status | Description |
|---|---|---|
| Pre-Authorized Code Flow | โ | Issue credentials without user authentication at the issuer |
| Authorization Code Flow | โ | Issue credentials with user authentication |
| Batch Credential Issuance | โ | Issue multiple credentials in a single request |
| Deferred Credential Endpoint | โ | Support for credentials that cannot be issued immediately |
| Notification Endpoint | โ | Receive wallet acknowledgment of credential acceptance/rejection |
| DPoP (Demonstrating Proof-of-Possession) | โ | Enhanced security with proof-of-possession tokens |
| Wallet Attestation | โ | Verify wallet provider trustworthiness |
The Deferred Credential Endpoint allows issuers to handle scenarios where credentials cannot be issued immediately (e.g., pending manual approval, external data sources). Wallets can poll the endpoint to retrieve credentials once they become available.
OID4VP Featuresโ
EUDIPLO implements the following OID4VP (OpenID for Verifiable Presentations) features:
| Feature | Status | Description |
|---|---|---|
direct_post.jwt Response Mode | โ | Wallet posts the VP Token directly to the verifier, encrypted as a JWE |
| DCQL (Digital Credentials Query Language) | โ | Structured credential queries with selective disclosure |
| Session Identifier Separation (ยง13.3) | โ | Wallet-facing identifier (walletNonce) is distinct from the internal session ID |
| Response Code for Same-Device Redirect (ยง13.3) | โ | One-time response_code appended to redirect_uri prevents session fixation on redirect |
| JWE-Encrypted Authorization Responses | โ | VP Tokens are encrypted to the verifier's key |
x509_san_dns / x509_san_uri Client ID Scheme | โ | Verifier identification via X.509 certificates |
| Wallet Attestation Verification | โ | Validate wallet provider trustworthiness before accepting presentations |
| Digital Credentials API (DC API) | โ | Browser-native credential exchange without QR codes or redirects |
EUDIPLO implements advanced security features from the OID4VP specification including session identifier separation (ยง13.3), response code verification for same-device flows, and JWE-encrypted responses to prevent token leakage.
Why This Limited Scope?โ
By limiting scope to official EUDI Wallet protocols, EUDIPLO avoids:
- โ Incompatibilities with reference implementations
- โ Bloated code from supporting rarely used formats
- โ Uncertain trust assumptions from broader ecosystems
This makes EUDIPLO especially suitable for:
- โ Public sector services integrating with national wallet pilots
- โ Companies targeting pan-European credential workflows
- โ Developers seeking a reliable, minimal abstraction layer over complex specs
These standards are evolving in coordination with EU-level pilot projects and working groups. EUDIPLO tracks these developments closely to provide early, stable support as specifications mature.
OIDF Conformanceโ
EUDIPLO has been tested against the OpenID Foundation (OIDF) Conformance Suite to ensure strict compliance with protocol specifications:
- โ OID4VCI (OpenID for Verifiable Credential Issuance) โ Conformance tested
- โ OID4VP (OpenID for Verifiable Presentations) โ Conformance tested
These conformance tests validate that EUDIPLO correctly implements the protocol flows, security requirements, and interoperability features specified by the OpenID Foundation.
Running Conformance Testsโ
To run the OIDF conformance tests yourself:
- Deploy EUDIPLO to a publicly accessible instance (required for the hosted OIDF test suite)
- Run the conformance test suite:
cd apps/backend
pnpm run test:oidf
These tests execute against your running instance and communicate with the hosted OIDF conformance suite to validate protocol compliance.
For more details on testing, see the Conformance Testing guide.
Related Topicsโ
- Credential Configuration โ Configure credentials for issuance
- Presentation Configuration โ Configure credential requests
- Status Management โ Revocation and suspension
- Trust Lists โ Trust architecture and key management