Skip to content

APIs and code of the eudiw provider backend PID, mDL and EAA issuer following OID4VCI

License

Notifications You must be signed in to change notification settings

eu-digital-identity-wallet/eudi-srv-web-issuing-eudiw-py

EUDIW Issuer

License

Important! Before you proceed, please read the EUDI Wallet Reference Implementation project description

Overview

The EUDIW Issuer is an implementation of the PID and (Q)EAA Provider service, supporting the OpenId4VCI (draft 13) protocol.

The service provides, by default, support for mso_mdoc and SD-JWT-VCformats, for the following credentials:

Credential/Attestation Format
PID mso_mdoc
PID SD-JWT-VC
mDL mso_mdoc
mDL SD-JWT-VC
(Q)EAA age-over-18 pseudonym mso_mdoc
(Q)EAA loyalty card mso_mdoc

For authenticating the user, it requires the use of eIDAS node, OAUTH2 server or a simple form (for testing purposes).

OpenId4VCI coverage

This version of the EUDIW Issuer supports the OpenId for Verifiable Credential Issuance (draft 13) protocol with the following coverage:

Feature Coverage
Authorization Code flow ✅ Support for PAR, PKCE, credential configuration id, scope
Pre-authorized code flow
Dynamic Credential Request
mso_mdoc format
SD-JWT-VC format
W3C VC DM
Token Endpoint
Credential Offer authorization_code , ✅ pre-authorized_code
Credential Endpoint ✅ Including proofs and repeatable invocations
Credential Issuer MetaData
Batch Endpoint
Deferred Endpoint
Proof ✅ JWT, ✅ CWT
Notification Endpoint

You can use the EUDIW Issuer at https://issuer.eudiw.dev/, or install it locally.

❗ Disclaimer

The released software is a initial development release version:

  • The initial development release is an early endeavor reflecting the efforts of a short timeboxed period, and by no means can be considered as the final product.
  • The initial development release may be changed substantially over time, might introduce new features but also may change or remove existing ones, potentially breaking compatibility with your existing code.
  • The initial development release is limited in functional scope.
  • The initial development release may contain errors or design flaws and other problems that could cause system or other failures and data loss.
  • The initial development release has reduced security, privacy, availability, and reliability standards relative to future releases. This could make the software slower, less reliable, or more vulnerable to attacks than mature software.
  • The initial development release is not yet comprehensively documented.
  • Users of the software must perform sufficient engineering and additional testing in order to properly evaluate their application and determine whether any of the open-sourced components is suitable for use in that application.
  • We strongly recommend not putting this version of the software into production use.
  • Only the latest version of the software will be supported

1. Installation

Pre-requisites:

  • Python v. 3.9 or 3.10
  • Flask v. 2.3 or higher

Click here for detailed installation instructions.

2. Run

Click here for detailed instructions.

3. Frequently Asked Questions

A. How to make your local EUDIW Issuer available on the Internet?

Please see detailed instructions in install.md.

B. How to add a new credential to the issuer ?

Please see detailed instructions in api_docs/add_credential.md.

C. Can I use my IACA certificate with the EUDIW Issuer?

Yes. You must copy your IACA trusted certificate(s) (in PEM format) to the trusted_CAs_path folder. If you don't have an IACA certificate, we provide an example test IACA certificate for the country Utopia (UT).

See more information in api_docs/configuration.md.

D. Can I use my Document Signer private key and certificate with the EUDIW Issuer?

Yes. Please follow the instructions in api_docs/configuration.md. If you don't have Document Signer private key and certificate, we provide test private DS keys and certificates, for country Utopia (UT).

E. How can I create a credential offer to issue a credential?

Please see detailed instructions in api_docs/credential_offer.md.

F. Can I test the pre-authorized flow?

Yes. Please see how in api_docs/pre-authorized.md.

H. Can I run the issuer in a Docker container?

Yes. Please see how in Install Docker.

How to contribute

We welcome contributions to this project. To ensure that the process is smooth for everyone involved, follow the guidelines found in CONTRIBUTING.md.

License

License details

Copyright (c) 2023 European Commission

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.