Skip to content

Commit 2feb783

Browse files
Update site
1 parent d70c9a2 commit 2feb783

File tree

5 files changed

+89
-12
lines changed

5 files changed

+89
-12
lines changed

index.html

Lines changed: 88 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -127,15 +127,15 @@
127127
<div class="col-md-9" role="main">
128128

129129
<h1 id="architecture-of-id-software">ARCHITECTURE OF ID-SOFTWARE</h1>
130-
<p>Document version: 2.8<br />
131-
Software version: 24.09<br />
132-
Last updated: 23.9.2024 </p>
130+
<p>Document version: 2.9<br />
131+
Software version: 25.08<br />
132+
Last updated: 9.10.2025 </p>
133133
<h1 id="introduction">Introduction</h1>
134134
<p>The purpose of this document is to describe the architecture of ID-software.</p>
135135
<p><strong>ID-software</strong> is a collection of software components offering support for PKI-based functionality, i.e. operations with different cryptographic tokens (e.g. eID cards), handling digitally signed documents, file encryption/decryption and signing and authentication in web environment. The ID-software comprises end-user applications, software libraries, web components, drivers for communicating with the cryptographic tokens and other complementary components.</p>
136136
<p>Main sources for information about ID-software are <a href="https://www.id.ee/en/">www.id.ee</a>, <a href="https://github.com/open-eid">Open-EID GitHub repository</a> and <a href="https://github.com/web-eid">Web-eID GitHub repository</a>.</p>
137137
<p>This document covers description of ID-software and its components, their deployment in different environments, provided and required interfaces. The document does not include components that have reached the end of their support nor the components that have not yet been released.</p>
138-
<p>The document is based on the latest released state of the ID-software components. At the time of writing, the latest released version of ID-software is <strong>version 24.09</strong>. Latest version numbers of the various ID-software components are provided at <a href="https://www.id.ee/en/article/information-on-the-latest-software-versions/">https://www.id.ee/en/article/information-on-the-latest-software-versions/</a>.</p>
138+
<p>The document is based on the latest released state of the ID-software components. At the time of writing, the latest released version of ID-software is <strong>version 25.08</strong>. Latest version numbers of the various ID-software components are provided at <a href="https://www.id.ee/en/article/information-on-the-latest-software-versions/">https://www.id.ee/en/article/information-on-the-latest-software-versions/</a>.</p>
139139
<p>The document is targeted for:</p>
140140
<ul>
141141
<li>Owners/managers of the software;</li>
@@ -148,9 +148,9 @@ <h1 id="background">Background</h1>
148148
<p><strong>Estonian Information System Authority</strong> (RIA, <a href="https://www.ria.ee/en.html">https://www.ria.ee/en.html</a>) is the main owner/manager of the ID-software. </p>
149149
<p>The software is being developed and tested by: </p>
150150
<ul>
151-
<li><strong>RaulWalter</strong> (RW, <a href="https://www.raulwalter.com">https://www.raulwalter.com</a>) as the main contractor during 2019-2024; </li>
152-
<li><strong>Nortal</strong> (<a href="https://nortal.com">https://nortal.com</a>) during 2019-2024; </li>
153-
<li><strong>TTT</strong> (<a href="https://www.testijad.ee">https://www.testijad.ee</a>) during 2019-2024; </li>
151+
<li><strong>RaulWalter</strong> (RW, <a href="https://www.raulwalter.com">https://www.raulwalter.com</a>) as the main contractor during 2019-2025; </li>
152+
<li><strong>Nortal</strong> (<a href="https://nortal.com">https://nortal.com</a>) during 2019-2025; </li>
153+
<li><strong>TTT</strong> (<a href="https://www.testijad.ee">https://www.testijad.ee</a>) during 2019-2025; </li>
154154
<li>SK ID Solutions (SK, <a href="https://www.skidsolutions.eu/en">https://www.skidsolutions.eu/en</a>); </li>
155155
<li>Aktors (<a href="http://www.aktors.ee/wp/">http://www.aktors.ee/wp/</a>); </li>
156156
<li>CGI Estonia (<a href="https://www.cgi.ee/et">https://www.cgi.ee/et</a>).</li>
@@ -225,7 +225,7 @@ <h1 id="background">Background</h1>
225225
<td>LGPL</td>
226226
</tr>
227227
<tr>
228-
<th rowspan="3"><a href="#software-libraries">Software libraries</a></td>
228+
<th rowspan="4"><a href="#software-libraries">Software libraries</a></td>
229229
<th>DigiDoc4j (Java)</th>
230230
<td>yes (2)</td>
231231
<td>yes (1)</td>
@@ -259,6 +259,17 @@ <h1 id="background">Background</h1>
259259
<td>LGPL</td>
260260
</tr>
261261
<tr>
262+
<th>Libcdoc (C++, .NET)</th>
263+
<td>-</td>
264+
<td>-</td>
265+
<td>yes</td>
266+
<td>yes (1)</td>
267+
<td>-</td>
268+
<td>-</td>
269+
<td>RIA</td>
270+
<td>LGPL</td>
271+
</tr>
272+
<tr>
262273
<th rowspan="2"><a href="#web-components">Web components</a></td>
263274
<th>Browser signing modules</th>
264275
<td>-</td>
@@ -340,7 +351,7 @@ <h1 id="background">Background</h1>
340351
</tr>
341352
<tr>
342353
<td>Handling CDOC documents</td>
343-
<td>Encrypting and decrypting documents in <a href="https://www.id.ee/wp-content/uploads/2020/02/SK-CDOC-1.0-20120625_EN.pdf">ENCDOC-XML 1.0 (CDOC)</a> also <a href="https://www.ria.ee/sites/default/files/content-editors/EID/cdoc.pdf">CDOC 1.1</a> format.</td>
354+
<td>Encrypting and decrypting documents in <a href="https://www.id.ee/wp-content/uploads/2020/02/SK-CDOC-1.0-20120625_EN.pdf">ENCDOC-XML 1.0 (CDOC)</a>, <a href="https://www.ria.ee/sites/default/files/content-editors/EID/cdoc.pdf">CDOC 1.1</a> and <a href="https://open-eid.github.io/CDOC2/">CDOC 2.0</a> format.</td>
344355
</tr>
345356
<tr>
346357
<td>Calculating RSA/ECDSA signature</td>
@@ -444,6 +455,11 @@ <h3 id="digidoc4">DigiDoc4</h3>
444455
<td>SK</td>
445456
</tr>
446457
<tr>
458+
<td>Decryption service</td>
459+
<td>Used to fetch Capsules for decrypting CDoc 2.0 document</td>
460+
<td>RIA</td>
461+
</tr>
462+
<tr>
447463
<td>Minidriver</td>
448464
<td>Used via CNG interface in Windows environment only. Described in chap. <a href="#_comp_drivers">Drivers</a>.</td>
449465
<td>IDEMIA</td>
@@ -488,6 +504,7 @@ <h4 id="digidoc4-interfaces">DigiDoc4 interfaces</h4>
488504
<li><a href="#_MID_REST_service">Mobile-ID (MID) REST service</a></li>
489505
<li><a href="#_SID_REST_service">Smart-ID (MID) REST service</a></li>
490506
<li><a href="#_LDAP_directory_interface">LDAP directory interface</a></li>
507+
<li><a href="#_CDoc_decryption_service">CDoc 2.0 Decryption Service interface</a></li>
491508
<li>Interfaces with base libraries:<ul>
492509
<li><a href="#_Libdigidocpp_library’s_interfaces">Libdigidocpp library’s API</a> – for handling documents in supported digital signature formats (ASiC, BDOC, DDOC and PDF)</li>
493510
<li>External base libraries: Qt6, libldap, openssl</li>
@@ -550,6 +567,11 @@ <h3 id="ria-digidoc">RIA DigiDoc</h3>
550567
<td>RIA</td>
551568
</tr>
552569
<tr>
570+
<td>Libcdoc</td>
571+
<td>Described in chap. <a href="#_comp_libraries">Software libraries</a>.</td>
572+
<td>RIA</td>
573+
</tr>
574+
<tr>
553575
<td>SiVa</td>
554576
<td>Described in chap. <a href="#_comp_libraries">Software libraries</a>.</td>
555577
<td>RIA</td>
@@ -569,6 +591,11 @@ <h3 id="ria-digidoc">RIA DigiDoc</h3>
569591
<td>Described in chap. <a href="#_comp_libraries">Software libraries</a>.</td>
570592
<td>SK</td>
571593
</tr>
594+
<tr>
595+
<td>Decryption service</td>
596+
<td>Used to fetch Capsules for decrypting CDoc 2.0 document</td>
597+
<td>RIA</td>
598+
</tr>
572599
</tbody>
573600
</table>
574601
<p><strong>Table: RIA DigiDoc</strong></p>
@@ -605,6 +632,7 @@ <h4 id="ria-digidoc-interfaces">RIA DigiDoc interfaces</h4>
605632
<li><a href="#_LDAP_directory_interface">LDAP directory interface</a></li>
606633
<li>Interfaces with base libraries:<ul>
607634
<li><a href="#_Libdigidocpp_library’s_interfaces">Libdigidocpp library’s API</a> – for handling documents in supported digital signature formats (ASiC, BDOC, DDOC and PDF)</li>
635+
<li><a href="#_Libcdoc_library’s_interfaces">Libcdoc library’s API</a> – for handling documents in supported encryption formats (CDoc 1.0/1.1/2.0)</li>
608636
<li>External base libraries: libldap, openssl</li>
609637
</ul>
610638
</li>
@@ -645,8 +673,13 @@ <h2 id="software-libraries">Software libraries</h2>
645673
<td>RIA</td>
646674
</tr>
647675
<tr>
676+
<td>Libcdoc</td>
677+
<td>C/C++ library that enables handling documents in CDOC and CDOC2 formats (encrypting/decrypting). Code repository: <a href="https://github.com/open-eid/libcdoc">https://github.com/open-eid/libcdoc</a> Documentation: <a href="https://open-eid.github.io/libcdoc/">https://open-eid.github.io/libcdoc/</a>.</td>
678+
<td>RIA</td>
679+
</tr>
680+
<tr>
648681
<td>Libdigidocpp</td>
649-
<td>C++ software library that enables handling documents in BDOC 2.1, ASiC and DIGIDOC-XML 1.3 formats (via SiVa service). Wiki: <a href="https://github.com/open-eid/libdigidocpp/wiki">https://github.com/open-eid/libdigidocpp/wiki</a> Code repository: <a href="https://github.com/open-eid/libdigidocpp">https://github.com/open-eid/libdigidocpp</a> Documentation: <a href="http://open-eid.github.io/libdigidocpp">http://open-eid.github.io/libdigidocpp</a>.</td>
682+
<td>C++ library that enables handling documents in BDOC 2.1, ASiC and DIGIDOC-XML 1.3 formats (via SiVa service). Wiki: <a href="https://github.com/open-eid/libdigidocpp/wiki">https://github.com/open-eid/libdigidocpp/wiki</a> Code repository: <a href="https://github.com/open-eid/libdigidocpp">https://github.com/open-eid/libdigidocpp</a> Documentation: <a href="http://open-eid.github.io/libdigidocpp">http://open-eid.github.io/libdigidocpp</a>.</td>
650683
<td>RIA</td>
651684
</tr>
652685
<tr>
@@ -755,6 +788,42 @@ <h3 id="cdoc4j-utility-programs-interfaces">CDoc4j utility program’s interface
755788
<ul>
756789
<li>CDoc4j API: see chap. <a href="#_CDoc4j_library’s_interfaces">CDoc4j library’s interfaces</a></li>
757790
</ul>
791+
<p><a name="_Libcdoc_library’s_interfaces"></a></p>
792+
<h3 id="libcdoc-librarys-interfaces">Libcdoc library’s interfaces</h3>
793+
<p>Provided:</p>
794+
<ul>
795+
<li>Libcdoc API<ul>
796+
<li>User: DigiDoc4, RIA DigiDoc, Libcdoc utility program</li>
797+
<li>Accessible with: C/C++</li>
798+
</ul>
799+
</li>
800+
</ul>
801+
<p>Required:</p>
802+
<ul>
803+
<li>Interfaces with base libraries:<ul>
804+
<li>OpenSSL, libxml2</li>
805+
</ul>
806+
</li>
807+
<li>Interfaces with cryptographic token’s drivers (described in chap. <a href="#_comp_drivers">Drivers</a>)<ul>
808+
<li>CNG interface</li>
809+
<li>PKCS#11 interface</li>
810+
<li>PKCS#12 interface</li>
811+
</ul>
812+
</li>
813+
</ul>
814+
<h3 id="libcdoc-utility-programs-interfaces">libcdoc utility program’s interfaces</h3>
815+
<p>Provided:</p>
816+
<ul>
817+
<li><a href="https://github.com/open-eid/libcdoc">libcdoc utility program’s interface</a><ul>
818+
<li>User: server application, end-user application, end-user</li>
819+
<li>Accessible with: command line</li>
820+
</ul>
821+
</li>
822+
</ul>
823+
<p>Required:</p>
824+
<ul>
825+
<li>Libcdoc API: see chap. <a href="#_Libcdoc_library’s_interfaces">Libcdoc library’s interfaces</a></li>
826+
</ul>
758827
<p><a name="_Libdigidocpp_library’s_interfaces"></a></p>
759828
<h3 id="libdigidocpp-librarys-interfaces">Libdigidocpp library’s interfaces</h3>
760829
<p>Provided:</p>
@@ -1387,6 +1456,14 @@ <h4 id="signature-verification-service-interface">Signature Verification Service
13871456
<li>Accessible from: <a href="https://siva.eesti.ee/V3/validate">https://siva.eesti.ee/V3/validate</a></li>
13881457
<li>Documentation: <a href="http://open-eid.github.io/SiVa/">http://open-eid.github.io/SiVa/</a></li>
13891458
</ul>
1459+
<p><a name="_CDoc_decryption_service"></a></p>
1460+
<h4 id="cdoc-20-decryption-service-interface">CDoc 2.0 Decryption Service interface</h4>
1461+
<ul>
1462+
<li>User: DigiDoc4, Libcdoc (RIA DigiDoc)</li>
1463+
<li>Accessible with: HTTPS protocol</li>
1464+
<li>Accessible from: <a href="https://cdoc2.id.ee">https://cdoc2.id.ee</a></li>
1465+
<li>Documentation: <a href="https://open-eid.github.io/CDOC2/">https://open-eid.github.io/CDOC2/</a></li>
1466+
</ul>
13901467
<h1 id="deployment-model">Deployment model</h1>
13911468
<p>The following subchapters describe physical deployment of ID-software components in collaboration with external components that were depicted in chap. <a href="#component-model">Component model</a> in case of the most common use cases.</p>
13921469
<h2 id="signing-in-web-browser">Signing in web browser</h2>
@@ -1507,5 +1584,5 @@ <h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
15071584

15081585
<!--
15091586
MkDocs version : 1.6.1
1510-
Build Date UTC : 2024-10-08 04:23:03.826864+00:00
1587+
Build Date UTC : 2025-10-10 07:47:12.132632+00:00
15111588
-->
5 KB
Loading

index_files/comp_mopp_signing.png

7.5 KB
Loading

search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

sitemap.xml.gz

0 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)