How govuk-one-login/mobile-wallet-example-credential-issuer works
This repository is a set of GOV.UK Wallet example-issuer tools. The principal document-builder workflow is to select an app and document type, enter credential data, optionally upload a portrait, persist a test document, then redirect to its credential offer for use by an issuer. The tree also includes authentication and credential-lifecycle endpoints, a document-signing certificate issuer, and a test harness serving JWKS. Controller excerpts support the shown storage and upload calls; several other subsystem relationships are documented by the README or remain unverified in the sampled sources.
Main entry points: databaseService.ts Document records · s3Service.ts Portrait storage · app.ts Test harness · issueDocumentSigningCertificate.ts Certificate issuer
Components 29
Document builder
- App selection
document-builder/src/appSelector/controller.ts - Document selection
document-builder/src/documentSelector/controller.ts - Credential forms
document-builder/src - Driving licences
document-builder/src/drivingLicenceBuilder/controller.ts - Veteran card
document-builder/src/veteranCardDocumentBuilder/controller.ts - Simple document
document-builder/src/simpleDocumentBuilder/controller.ts - DBS document
document-builder/src/dbsDocumentBuilder/controller.ts - NINO document
document-builder/src/ninoDocumentBuilder/controller.ts - DVS licence
document-builder/src/dvsDrivingLicenceBuilder/controller.ts - Document retrieval
document-builder/src/document/controller.ts - Document records
document-builder/src/services/databaseService.ts - Portrait storage
document-builder/src/services/s3Service.ts - DVS journey
document-builder/src/dvsJourneySelector/controller.ts - DVS start
document-builder/src/dvsStart/controller.ts
Issuer security
- Auth callbacks
document-builder/src/returnFromAuth/controller.ts - Proof JWT
document-builder/src/proofJwt/proofJwt.ts - Token refresh
document-builder/src/refresh/controller.ts - Credential revocation
document-builder/src/revoke/controller.ts - Logout
document-builder/src/logout/controller.ts - Certificate issuer
document-signing-certificate-issuer/src/issueDocumentSigningCertificate.ts - AWS PCA adapter
document-signing-certificate-issuer/src/adapters/aws/acmPcaAdapter.ts - Certificate S3 adapter
document-signing-certificate-issuer/src/adapters/aws/s3Adapter.ts - Private platform CA
platform-ca
Issuer validation
- Test harness
test-harness/src/app.ts - Harness key pair
test-harness/src/initialiseKeyPair.ts - JWKS response
test-harness/src/buildJwksResponse.ts
Other components
- Builder user
- Credential issuer
- Harness client
Connections 27
- Builder user → App selection: selects app
- Builder user → Document selection: chooses document
- Credential forms → Document records: stores records
document-builder/src/drivingLicenceBuilder/controller.ts - Driving licences → Document records: saves record
document-builder/src/drivingLicenceBuilder/controller.ts - Driving licences → Portrait storage: uploads portrait
document-builder/src/drivingLicenceBuilder/controller.ts - Veteran card → Document records: saves record
document-builder/src/veteranCardDocumentBuilder/controller.ts - Veteran card → Portrait storage: uploads portrait
document-builder/src/veteranCardDocumentBuilder/controller.ts - Simple document → Document records: saves record
document-builder/src/simpleDocumentBuilder/controller.ts - Simple document → Portrait storage: uploads portrait
document-builder/src/simpleDocumentBuilder/controller.ts - DBS document → Document records: saves record
document-builder/src/dbsDocumentBuilder/controller.ts - NINO document → Document records: saves record
document-builder/src/ninoDocumentBuilder/controller.ts - DVS licence → Document records: saves record
document-builder/src/dvsDrivingLicenceBuilder/controller.ts - DVS licence → Portrait storage: uploads portrait
document-builder/src/dvsDrivingLicenceBuilder/controller.ts - Document retrieval → Document records: reads record
document-builder/src/document/controller.ts - Document retrieval → Portrait storage: loads portrait
document-builder/src/document/controller.ts - Builder user → Auth callbacks: returns from auth
- Builder user → Proof JWT: requests proof
- Builder user → Token refresh: refreshes token
- Builder user → Credential revocation: requests revocation
- Builder user → Logout: logs out
- Certificate issuer → AWS PCA adapter: issues certificate
document-signing-certificate-issuer/src/issueDocumentSigningCertificate.ts - Certificate issuer → Certificate S3 adapter: stores certificate
document-signing-certificate-issuer/src/issueDocumentSigningCertificate.ts - Harness client → Test harness: requests JWKS
- Test harness → Harness key pair: initializes key
test-harness/src/app.ts - Test harness → JWKS response: serves key set
test-harness/src/app.ts - Credential issuer → Document records: uses test documents
- Private platform CA → Certificate issuer: supports signing