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/