libdigidocpp

Libdigidocpp library offers creating, signing and verification of digitally signed documents, according to XAdES and XML-DSIG standards. Documentation http://open-eid.github.io/libdigidocpp

open-eid

C++

libdigidocpp

European Regional Development Fund

License: LGPL 2.1
© Estonian Information System Authority
Architecture of ID-software
API Documentation

Building

Ubuntu, Fedora

Install dependencies
```
 # Ubuntu
 sudo apt install cmake libxml2-dev libxmlsec1-dev zlib1g-dev
 # Fedora
 sudo dnf install cmake gcc-c++ libtool-ltdl-devel libxml2-devel minizip-ng-compat-devel openssl-devel zlib-devel xmlsec1-openssl-devel
```
- doxygen - Optional, for API documentation
- libboost-test-dev - Optional, for unittests
- swig - Optional, for C#, Java and python bindings
- libpython3-dev, python3-setuptools - Optional, for python bindings
- openjdk-17-jdk-headless - Optional, for Java bindings

Fetch the source

 git clone --recursive https://github.com/open-eid/libdigidocpp
 cd libdigidocpp

Configure
```
 cmake -B build -S .
```
Build
```
 cmake --build build
```

Install

 sudo cmake --build build --target install

Execute
```
 /usr/local/bin/digidoc-tool
```

macOS

Install dependencies from
- XCode
- CMake
- Homebrew

Fetch the source

 git clone --recursive https://github.com/open-eid/libdigidocpp
 cd libdigidocpp

Prepare dependencies (available targets: macos, iphoneos, iphonesimulator, androidarm, androidarm64, androidx86_64)
```
 sh prepare_osx_build_environment.sh macos all
```
Install dependencies
```
 brew install pkg-config ninja
```
- doxygen - Optional, for API documentation
- boost - Optional, for unittests
- swig - Optional, for C# and Java bindings
- openjdk - Optional, for Java bindings
Configure, build and install (available presets: macos, iphoneos, iphonessimulator, androidarm, androidarm64, androidx86_64)
```
 cmake --preset macos
 cmake --build --preset macos
 sudo cmake --build --preset macos --target install
```

Execute

 /Library/Frameworks/digidocpp.framework/Resources/digidoc-tool

Windows

Install dependencies and necessary tools from
- Visual Studio Community 2019/2022
- CMake
- vcpkg
- Swig - Optional, for C# and Java bindings
- Doxygen - Optional, for generationg documentation
- Wix toolset - Optional, for creating Windows installation packages
- Python - Optional, for Python bindings
- Java - Optional, for Java bindings
Toolset:
- 142 - Visual Studio 2019 (Default)
- 143 - Visual Studio 2022

Fetch the source

 git clone --recursive https://github.com/open-eid/libdigidocpp
 cd libdigidocpp

Configure

 cmake -DCMAKE_TOOLCHAIN_FILE=vcpkg/scripts/buildsystems/vcpkg.cmake `
       -DVCPKG_TARGET_TRIPLET=x64-windows `
       -DVCPKG_MANIFEST_FEATURES=tests `
       -B build -S .

Optional CMake parameters:

-DSWIG_EXECUTABLE=C:/swigwin-4.2.1/swig.exe

After running the cmake build, digidoc_csharp.dll along with the C# source files will be created, more info at
examples/DigiDocCSharp/README.md.

Build
```
 cmake --build build
```
Alternative to steps 4. and 5. -
```
 powershell -ExecutionPolicy ByPass -File build.ps1 -platform x64
```
The build script builds executables and installation media for given
platform (Debug and Release with debug symbols)
Execute
```
 build/src/digidoc-tool.exe
```

Examples

examples/README.md

Support

Official builds are provided through official distribution point id.ee. If you want support, you need to be using official builds. Contact our support via www.id.ee for assistance.

Source code is provided on “as is” terms with no warranty (see license for more information). Do not file Github issues with generic support requests.