Version: v0.13
eIDAS REST Server
The eIDAS REST Server is part of VDX (Verifiable Data Exchange), providing enterprise deployment with multi-database persistence.
For server documentation, see:
- VDX eIDAS Overview - Architecture and concepts
- VDX eIDAS Server API - REST API reference
Architecture
The eIDAS functionality is split between EDK and VDX:
| Component | Location | Description |
|---|---|---|
| Signature Client | EDK | Core signing commands with DI integration |
| DSS Provider | EDK | Local in-process signing using EU DSS library |
| REST Client | EDK | HTTP client implementing SignatureProvider |
| REST Server | VDX | Full REST server with persistence |
This separation enables:
- Mobile apps: Use REST client to delegate signing to a server
- Desktop apps: Use DSS provider for local in-process signing
- Hybrid: Create digest locally, sign remotely, complete locally
Using the REST Client
To call a VDX eIDAS server from your application, use the EDK REST client:
dependencies {
implementation("com.sphereon.edk:lib-eidas-signature-client-impl:0.13.0")
implementation("com.sphereon.edk:lib-eidas-signature-rest-client:0.13.0")
}
Configure the client to point to your VDX server:
@Inject
@SingleIn(AppScope::class)
@ContributesBinding(AppScope::class)
class MyRestSignatureConfig : RestSignatureClientConfig {
override val baseUrl: String = "https://my-vdx-server.example.com/api/v1"
override val defaultConfigId: String = "pdf-lt-config"
}
See Client API for complete usage documentation.