|
libdigidocpp 4.6.0
|
Libdigidocpp is a C++ library for creating, signing, and verifying digitally signed documents. Digitally signed files are created as Associated Signature Containers (ASiC), using the .asice file extension, with XML Advanced Electronic Signatures (XAdES), both standardized by the European Telecommunications Standards Institute (ETSI).
Additionally, the libdigidocpp library can create, save, read, validate, and extend digitally timestamped containers (using the .asics file extension) with a single data file and RFC 3161 time-stamp tokens. ASiC containers with CAdES signatures, PDF, and DDOC files can be validated with the SiVa service.
The library is developed on GitHub:
The library is documented on the following separate pages:
Libdigidocpp library forms a part of the wider DigiDoc system framework which offers a full-scale architecture for digital signature and documents, consisting of software libraries (C++ and Java), SiVa service and end-user applications such as DigiDoc4 according to the following figure:
It is easy to integrate DigiDoc components into existing applications in order to allow for creation, handling, forwarding and verification of digital signatures. All applications share common digitally signed file formats.
Libdigidocpp is a library of C++ classes offering the functionality of handling digitally signed files in supported DigiDoc formats. The following functions are implemented:
The following table gives overview of functional features that are supported with Libdigidocpp.
| Feature | Supported values |
|---|---|
| DigiDoc document format |
|
| Signature profile | Signature profiles are based on the profiles defined by XAdES (XAdES).
|
| Trust anchors | Information of trusted CA certificates (trust anchors) is used to validate the trustworthiness of certificates used in the signature. The signer certificate's CA, OCSP responder certificate and time-stamping service's certificate (in case of TS signature profile) must be trusted. Trusted certificates' information is obtained from TSL list (Trust Service status list), the trusted certificates' list is retrieved from a signed TSL list that provides information about the status and the status history of the trust services (including certification, OCSP confirmation and time-stamping services). The European Commission's TSL list is used, more information of which can be found from https://ec.europa.eu/information_society/policy/esignature/trusted-list/. For the TSL specification document, see also Trusted Lists. For more information about the TSL implementation and configuration possibilities in Libdigidocpp library, see TSL list usage in Libdigidocpp and Trust anchor/TSL settings. |
| Signature creation module |
|
| Cryptographic token type |
|
| Public-key algorithm |
|
The figure below describes the architecture of software and hardware components that are used when creating signatures with Libdigidocpp library.
| Component | Description |
|---|---|
| PKCS#11 | Widely adopted platform-independent API to cryptographic tokens (HSMs, smart cards and USB tokens), a standard management module of the cryptographic token and its certificates |
| CryptoAPI | Microsoft Cryptography API. Programming API for implementing cryptographic functions in Windows environment. |
| PC/SC | Standard communication interface between the computer and the smart card, a cross-platform API for accessing smart card readers |
| IFDHandler | Interface Device Handler for CCID readers |
| CCID | USB driver for Chip/Smart Card Interface Devices |
| Reader | Device used for communication with a smart card |
Libdigidocpp library supports the following identity tokens:
The library is also tested with the following tokens (indirectly via the DigiDoc desktop application that uses Libdigidocpp as a base component):