DeveloperTips - open-eid/DigiDoc4-Client GitHub Wiki
Building
Building in sandboxed environment.
Download latest TSL files to qdigidoc4/client source folder
- https://ec.europa.eu/tools/lotl/eu-lotl.xml -> eu-lotl.xml
- https://sr.riik.ee/tsl/estonian-tsl.xml -> EE.xml
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
- http://doc.qt.io/qt-6/qsettings.html#platform-specific-notes
- http://doc.qt.io/qt-6/qsettings.html#fallback-mechanism
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/