Skip to content

Commit 58649de

Browse files
mrtsmrts
committed
docs(index.html),script: emphazise latest official Open EID packages, mention the Snap problem, re-enable installation in download-install-web-eid.sh
1 parent e43e53e commit 58649de

File tree

2 files changed

+37
-16
lines changed

2 files changed

+37
-16
lines changed

‎example/src/main/resources/static/scripts/download-install-web-eid.sh‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,9 @@ make_install() {
4242
wget "https://installer.id.ee/media/web-eid/Ubuntu/web-eid-chrome_${VERSION}.${BUILD}-${UBUNTU_VERSION}_all.deb"
4343
wget "https://installer.id.ee/media/web-eid/Ubuntu/web-eid-firefox_${VERSION}.${BUILD}-${UBUNTU_VERSION}_all.deb"
4444
wget "https://installer.id.ee/media/web-eid/Ubuntu/web-eid-native_${VERSION}.${BUILD}-${UBUNTU_VERSION}_amd64.deb"
45-
# sudo apt install -y ./web-eid*.deb
46-
# cd /tmp
47-
# rm -r $TMPDIR
45+
sudo apt install -y ./web-eid*.deb
46+
cd /tmp
47+
rm -r $TMPDIR
4848
}
4949

5050
### main

‎example/src/main/resources/templates/index.html‎

Lines changed: 34 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,8 @@ <h2>Web eID: electronic ID smart cards on the Web</h2>
2828
</p>
2929
<p>
3030
Estonian, Finnish, Latvian, Lithuanian and Croatian eID cards are supported in the first phase, but only
31-
Estonian eID card support is currently enabled in the test application below.
31+
Estonian eID card support is currently enabled in the test application below. Belgian eID support is
32+
upcoming.
3233
</p>
3334
<p>
3435
Please get in touch by email at [email protected] in case you need support with adding Web eID to your project
@@ -45,26 +46,37 @@ <h4>Table of contents</h4>
4546

4647
<hr/>
4748
<h3><a id="usage"></a>Usage</h3>
48-
<p>
49-
Instructions for installing and testing the latest version in Firefox, Chrome, Edge or Safari:
49+
<p>The recommended way of installing Web eID is by installing <a
50+
href="https://www.id.ee/en/article/install-id-software/">the latest Open-EID ID-software package</a>.
51+
In case you do not need or want to install the Open-EID package, install the latest Web eID packages in
52+
Firefox, Chrome, Edge or Safari according to the following instructions:
5053
</p>
5154
<ol>
5255
<li>
5356
Download and run the Web eID native app and browser extension installer:
5457
<ul>
5558
<li>on <b>Ubuntu Linux</b>, for Firefox and Chrome, download and execute the<br>
56-
<a href="/scripts/download-install-web-eid.sh"><code>download-install-web-eid.sh</code></a> script from the console with<br>
57-
<code>wget -O - https://<span th:text="${#httpServletRequest.serverName}"/>/scripts/download-install-web-eid.sh | bash</code><br>
59+
<a href="/scripts/download-install-web-eid.sh"><code>download-install-web-eid.sh</code></a>
60+
script from the console with<br>
61+
<code>wget -O - https://<span th:text="${#httpServletRequest.serverName}"/>/scripts/download-install-web-eid.sh
62+
| bash</code><br>
63+
<b>Note that Firefox is installed with Snap in Ubuntu 22.04 or later by default and as the
64+
Snap sandbox does not allow communication with the external native messaging host, Web
65+
eID will not work.</b>
66+
Install Firefox via the Debian package instead of Snap if you want to use Web eID with
67+
Firefox in Ubuntu 22.04+. Instructions how to do that are available <a
68+
href="https://www.omgubuntu.co.uk/2022/04/how-to-install-firefox-deb-apt-ubuntu-22-04">here</a>.
5869
</li>
5970
<li>on <b>macOS</b> 10.15 or later, for Firefox and Chrome from <a
6071
href="https://installer.id.ee/media/web-eid/web-eid_2.0.2.565.dmg">here</a>,
6172
</li>
6273
<li>on <b>macOS</b> 10.15 or later, for Safari, install the extension from <a
6374
href="https://apps.apple.com/ee/app/web-eid/id1576665083?mt=12">App Store</a>,
6475
</li>
65-
<li>on <b>Windows</b> 10, Windows 11, Windows Server 2016, Windows Server 2019, Windows Server 2022,
76+
<li>on <b>Windows</b> 10, Windows 11, Windows Server 2016, Windows Server 2019, Windows Server
77+
2022,
6678
for Firefox, Chrome and Edge from <a
67-
href="https://installer.id.ee/media/web-eid/web-eid_2.0.2.566.x64.exe">here</a>.
79+
href="https://installer.id.ee/media/web-eid/web-eid_2.0.2.566.x64.exe">here</a>.
6880
</li>
6981
</ul>
7082
</li>
@@ -74,6 +86,9 @@ <h3><a id="usage"></a>Usage</h3>
7486
the browser or from the browser extensions management page and may need browser restart under
7587
certain circumstances.
7688
</li>
89+
</ol>
90+
<p>Testing:</p>
91+
<ol>
7792
<li>
7893
Attach a smart card reader to the computer and insert the eID card into the reader.
7994
</li>
@@ -171,7 +186,8 @@ <h3><a id="documentation"></a>Documentation</h3>
171186
</p>
172187
<p>
173188
Security analysis of the solution is available
174-
<a href="https://web-eid.github.io/web-eid-cybernetica-analysis/webextensions-main.pdf">in this document</a>.
189+
<a href="https://web-eid.github.io/web-eid-cybernetica-analysis/webextensions-main.pdf">in this
190+
document</a>.
175191
</p>
176192
<hr/>
177193
<h3><a id="for-developers"></a>For developers</h3>
@@ -190,19 +206,24 @@ <h3><a id="for-developers"></a>For developers</h3>
190206
<ul>
191207
<li>in Java use the <i>web-eid-authtoken-validation-java</i> library in
192208
the back end of the web application according to the instructions
193-
<a href="https://github.com/web-eid/web-eid-authtoken-validation-java#quickstart">here</a>,</li>
194-
<li>in .NET/C# use the <i>web-eid-authtoken-validation-dotnet</i> library according to the instructions
195-
<a href="https://github.com/web-eid/web-eid-authtoken-validation-dotnet#quickstart">here</a></li>
209+
<a href="https://github.com/web-eid/web-eid-authtoken-validation-java#quickstart">here</a>,
210+
</li>
211+
<li>in .NET/C# use the <i>web-eid-authtoken-validation-dotnet</i> library according to the
212+
instructions
213+
<a href="https://github.com/web-eid/web-eid-authtoken-validation-dotnet#quickstart">here</a>
214+
</li>
196215
</ul>
197216
</li>
198217
<li>for digital signing
199218
<ul>
200219
<li>in Java use the <i>digidoc4j</i> library in the back end of the web
201220
application according to the instructions
202-
<a href="https://github.com/web-eid/web-eid-spring-boot-example#integration-with-digidoc4j-components">here</a>,</li>
221+
<a href="https://github.com/web-eid/web-eid-spring-boot-example#integration-with-digidoc4j-components">here</a>,
222+
</li>
203223
<li>in .NET/C# use the <i>libdigidocpp</i> library in the back end of the web
204224
application according to the instructions
205-
<a href="https://github.com/web-eid/web-eid-asp-dotnet-example#3-setup-the-libdigidocpp-library-for-signing">here</a>.</li>
225+
<a href="https://github.com/web-eid/web-eid-asp-dotnet-example#3-setup-the-libdigidocpp-library-for-signing">here</a>.
226+
</li>
206227
</ul>
207228
</li>
208229
</ul>

0 commit comments

Comments
 (0)