DeveloperTips - open-eid/DigiDoc4-Client GitHub Wiki

Building

Building in sandboxed environment.

Download latest TSL files to qdigidoc4/client source folder

Download latest Config files to qdigidoc4/common source folder

Logging

Create qdigidoc4.log file in temp folder (WIN %TEMP%, macOS $TMPDIR (or $TMPDIR/ee.ria.qdigidoc4), Linux $TEMP) and start application.

Configuration parameters

A detailed description of fallback paths and rules

Parameter Description
language Application language. Possible values are: et, en and ru.
showIntro Show introduction. Possible values are: true and false.
DefaultDir Directory where the target file will be saved. By default target file will be written to the same directory where the input file is located.
lastPath Last path used in file selection dialog.
LastCheck Date when the last checking for a newer version of the central configuration file was successfully made.
LDAP-PERSON-URL** LDAP directory address for person certificate search.
LDAP-CORP-URL** LDAP directory address for corporation certificate search.
MobileSettings Remember mobile-ID settings. Possible values are: true and false.
MobileCode Personal code used for signing with mobile-ID.
MobileNumber Phone number used for signing with mobile-ID.
MID-PROXY-URL** Mobile-ID address used when Relying Party UUID (RPUUID) is "null".
MID-SK-URL** Mobile-ID address used when Relying Party UUID (RPUUID) is not "null".
MIDNAME Relying Party Name (RPNAME) sent to mobile-ID service.
MIDUUID Relying Party UUID (RPUUID) sent to mobile-ID service.
SmartIDSettings Remember Smart-ID settings. Possible values are: true and false.
SmartID Personal code used for signing with Smart-ID.
SmartIDCountry Country used for signing with Smart-ID. Possible values are: ee, lv and lt.
SIDV2-PROXY-URL** Smart-ID address used when Relying Party UUID (RPUUID) is "null".
SIDV2-SK-URL** Smart-ID address used when Relying Party UUID (RPUUID) is not "null".
SIDNAME Relying Party Name (RPNAME) sent to Smart-ID service.
SIDUUID Relying Party UUID (RPUUID) sent to Smart-ID service.
ShowPrintSummary Show print summary option in the DigiDoc4 signature view. Possible values are: true and false.
RoleAddressInfo Ask role and address info on signing. Possible values are: true and false.
City City where the signature is created.
Country Country where the signature is created.
State State or province where the signature is created.
Zip Zip of the signature creation location.
Role Signerโ€™s role(s).
SIVA-URL** Digital Signature Validation Service SiVa address.
SIVA-CERT** Digital Signature Validation Service SiVa SSL certificate.
TSA-URL** Timestamping service address.
TSA-CERT** Timestamping service SSL certificate.
pkcs12.disable* Specifies if the OCSP requests are signed or not. Possible values are: true โ€“ OCSP requests are not signed; false โ€“ OCSP requests are signed.
tsl.onlineDigest* Enable online TSL digest verification
proxyConfig Possible values are: 0 - No proxy; 1 - Use system proxy settings; 2 - Manual proxy configuration.
proxy.host* Specifies the proxy hostname, e.g. proxy.example.net.
proxy.port* Specifies the proxy port, e.g. 8080.
proxy.user* Specifies the proxy username.
proxy.pass* Specifies the proxy password.
proxy.tunnelSSL* May be used to enable downloading TSL-s in case of HTTPS connections and proxy. If enabled, the library tries to download use the proxy tunnel also for the HTTPS session.

* The parameter can be edited in libdigidocpp configuration file. Default locations for Windows, macOS and Ubuntu can be found here: http://open-eid.github.io/libdigidocpp/manual.html#loading

See also libdigidocpp configuration http://open-eid.github.io/libdigidocpp/manual.html#parameters

** The parameters in central configuration service id.eesti.ee/config.json shall be modified in the machine based area.

Windows

  • [HKEY_CURRENT_USER\Software\RIA\qdigidoc4]
  • [HKEY_LOCAL_MACHINE\Software\RIA\qdigidoc4] - use for modifying the ** parameters

macOS

  • Command to read/modify settings: defaults read ee.ria.qdigidoc4
  • ~/Library/Containers/ee.ria.qdigidoc4/Data/Library/Preferences/ee.ria.qdigidoc4.plist โ€“ use for signed package (App Store)
  • ~/Library/Preferences/ee.ria.qdigidoc4.plist โ€“ use for self build package and modifying the ** parameters

Linux

  • ~/.config/RIA/qdigidoc4.conf
  • /etc/xdg/RIA/qdigidoc4.conf โ€“ use for modifying the ** parameters

Other paths

macOS

TSL cache, crypto certificate history

  • ~/Library/Containers/ee.ria.qdigidoc4/Data/Library/Application Support/RIA/qdigidoc4/