ID Verifier - Frontend Example

This project is open source and available on GitHub

ID Verifier - A Digital Credentials API Wrapper

Try it out

This example demonstrates how to request and verify digital credentials using the id-verifier library.

Checking browser compatibility...

Configure Request

Select the document types and information you'd like to request from the user:

Allowed Document Types

Mobile Driver's License

ISO 18013-5 mDL standard

Photo ID

ISO 23220 Photo ID standard

EU Personal ID

European Digital Identity

Japan My Number Card

Japanese national ID

Issuer Registry Settings

Use Test Data

Enable using test issuer data from the trusted-issuer-registry

Sample Code

Here's the code that would be used to request the selected claims:

// Import the library

import { createCredentialsRequest, requestCredentials, processCredentials, generateNonce, generateJWK, DocumentType, Claim } from 'id-verifier';

// Generate required parameters

const nonce = generateNonce();

const jwk = await generateJWK();

// Create request parameters

const requestParams = createCredentialsRequest({

documentTypes: ['org.iso.18013.5.1.mDL'],

claims: ['givenName', 'familyName', 'ageOver21'],

nonce,

jwk

});

// Request credentials

const credential = await requestCredentials(requestParams);

// Process and verify the credential

const result = await processCredentials(credential, { nonce, jwk, origin: window.location.origin });

How it works

Configure your request - Select which information you need from what types of documents
Request credentials - The browser prompts the user to select and share their credentials
User consents - The user reviews and approves the credential request
Credential is returned - The browser returns the requested credential data
Backend verifies - The server validates the credential and extracts information

Supported Document Types

Photo ID (ISO 23220)
EU Personal ID
Japan My Number Card
Mobile Driver's License (ISO 18013-5)

Supported Protocols

OpenID4VP
ISO mDoc

Browser Support

This demo requires a browser that supports the Digital Credentials API. Currently, this is an experimental API and may not be available in all browsers.

Note: In a real application, you would:

Generate the credential request parameters on your backend to secure the nonce and JWK
Send the credential response to your backend for verification
Implement proper error handling and verification fallbacks
Inform users of your data handling practices
Follow data residency and privacy laws

🤝 Help Us Improve

This is an open source project and we welcome contributions from the community to make digital identity verification more secure and accessible.

🔧 Contribute Code

Help us add new features, fix bugs, or improve documentation. Every contribution matters!

Issues, pull requests, and feedback are always welcome.

🔒 Security Audits

Security researchers and auditors: please help us identify vulnerabilities and improve our security posture.

Responsible disclosure is appreciated and recognized.