In order to add support for signing Estonian digital documents (ID-card, digital ID, e-resident digital ID, residence permit card, etc.) to your e-service, we recommend using the Web eID solution.
The Web eID solution allows Estonian and also common European eID smart cards to be used for secure authentication and signing online.
-
Show Hide Taking Web eID into use implies changes to the online service. The library and samples for the Java, .NET and PHP platforms are currently available. Support for additional platforms is planned based on feedback.
pport for additional platforms is planned based on feedback.
To get started, we recommend reading the Web eID materials:
- Portal and the sample environment: https://web-eid.eu/
- Authentication: https://github.com/web-eid/web-eid-system-architecture-doc#authentication-1
- Signing: https://github.com/web-eid/web-eid-system-architecture-doc#digital-signing
- Sample application that uses Web eID for authentication and signing: https://github.com/web-eid/web-eid-spring-boot-example
How to start using Web eID on the Java platform:
- Integrate the JavaScript library web-eid.js into your service’s front-end. The JavaScript library is necessary for the website of the online service to communicate with the browser extension. Instructions for taking into use: https://github.com/web-eid/web-eid.js#quickstart;
- The Java authentication token validation library web-eid-authtoken-validation-java must be used in the back-end for authentication. Instructions for taking into use: https://github.com/web-eid/web-eid-authtoken-validation-java#quickstart;
- A XAdES library must be used in the back-end for signing. On the Java platform, we recommend using the digidoc4j library. Instructions for taking into use: https://github.com/open-eid/digidoc4j/wiki/Examples-of-using-it
How to start using Web eID on the .NET platform:
- Integrate the JavaScript library web-eid.js into your service’s front-end. The JavaScript library is necessary for the website of the online service to communicate with the browser extension. Instructions for taking into use: https://github.com/web-eid/web-eid.js#quickstart;
- The .NET authentication token validation library web-eid-authtoken-validation-dotnet must be used in the back-end for authentication. Instructions for taking into use: https://github.com/web-eid/web-eid-authtoken-validation-dotnet#quickstart;
- A XAdES library must be used in the back-end for signing. On the .NET platform, we recommend using the libdigidocpp library. Instructions for taking into use: https://github.com/open-eid/libdigidocpp/wiki#how-to-use-it
How to start using Web eID on the PHP platform:
- Integrate the JavaScript library web-eid.js into your service’s front-end. The JavaScript library is necessary for the website of the online service to communicate with the browser extension. Instructions for taking into use: https://github.com/web-eid/web-eid.js#quickstart;
- The PHP authentication token validation library web-eid-authtoken-validation-php must be used in the back-end for authentication. Instructions for taking into use: https://github.com/web-eid/web-eid-authtoken-validation-php#quickstart
How to start using Web eID on other platforms:
- Integrate web-eid.js JavaScript library into your service’s front-end. The JavaScript library is necessary for the website of the online service to communicate with the browser extension. Instructions for taking into use: https://github.com/web-eid/web-eid.js#quickstart;
- The authentication token validating library must be used in the back-end for authentication. Currently, there is a library for the Java, .NET and PHP platforms. Support for other platforms is planned, more information can be found in the schedule. Additionally, we would appreciate your feedback regarding platform preferences;
- A XAdES library must be used in the back-end for signing. If possible, we recommend using the existing libraries:
- Libdigidocpp: https://github.com/open-eid/libdigidocpp
- DigiDoc4j: https://github.com/open-eid/digidoc4j