Pingviini viki - Kasutaja kaastöö [et]

ID-kaart Manjaro Linuxis

2025-05-17T16:58:28Z

Zeroconf: /* libxml2.so.2 ei leitud */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka mõnda muud [https://wiki.archlinux.org/title/AUR_helpers AURi klienti].
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Sy web-eid-native web-eid-chrome web-eid-firefox --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* teadmiseks Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.

Selleks võib kasutada opensc pakis kaasas olevat käsku

pkcs11-register

Või manuaalselt läbi kasutajaliidese
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida, sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

==libxml2.so.2 ei leitud==

Siin võib vajalik olla luua sümbolviide (symlink) ja muidu DigiDoc rakendus ei käivitu.

Eelnevalt tasub vaadata, mis versioon libxml2 on olemas
<syntaxhighlight lang="bash">
ls -l /usr/lib/libxml2*
</syntaxhighlight>

Seejärel luua symlink:
<syntaxhighlight lang="bash">
sudo ln -sf /usr/lib/libxml2.so.16.0.3 /usr/lib/libxml2.so.2
</syntaxhighlight>

Siin parameeter f kirjutab eelmise symlingi üle. See vajalik kui symlink juba olemas kuid vahepeal libxml2 uuenenud ja vaja symlink üle kirjutada.

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2025-05-17T16:57:17Z

Zeroconf: /* libxml2.so.2 ei leitud */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka mõnda muud [https://wiki.archlinux.org/title/AUR_helpers AURi klienti].
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Sy web-eid-native web-eid-chrome web-eid-firefox --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* teadmiseks Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.

Selleks võib kasutada opensc pakis kaasas olevat käsku

pkcs11-register

Või manuaalselt läbi kasutajaliidese
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida, sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

==libxml2.so.2 ei leitud==

Siin võib vajalik olla luua sümbolviide (symlink) ja muidu DigiDoc rakendus ei käivitu.

Eelnevalt tasub vaadata, mis versioon libxml2 on olemas
<syntaxhighlight lang="bash">
ls -l /usr/lib/libxml2*
</syntaxhighlight>

Seejärel luua symlink:
<syntaxhighlight lang="bash">
sudo ln -sf /usr/lib/libxml2.so.16.0.3 /usr/lib/libxml2.so.2
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2025-05-17T16:55:55Z

Zeroconf:

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka mõnda muud [https://wiki.archlinux.org/title/AUR_helpers AURi klienti].
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Sy web-eid-native web-eid-chrome web-eid-firefox --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* teadmiseks Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.

Selleks võib kasutada opensc pakis kaasas olevat käsku

pkcs11-register

Või manuaalselt läbi kasutajaliidese
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida, sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

==libxml2.so.2 ei leitud==

Siin võib vajalik olla luua sümbolviide (symlink) ja muidu DigiDoc rakendus ei käivitu.

Eelnevalt tasub vaadata, mis versioon libxml2 on olemas
<syntaxhighlight lang="bash">
ls -l /usr/lib/libxml2*
</syntaxhighlight>

<syntaxhighlight lang="bash">
sudo ln -sf /usr/lib/libxml2.so.16.0.3 /usr/lib/libxml2.so.2
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2023-10-22T07:14:27Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka mõnda muud [https://wiki.archlinux.org/title/AUR_helpers AURi klienti].
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Sy web-eid-native web-eid-chrome web-eid-firefox --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* teadmiseks Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida, sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2023-10-22T07:06:40Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka mõnda muud [https://wiki.archlinux.org/title/AUR_helpers AURi klienti].
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid-native web-eid-chrome web-eid-firefox --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* teadmiseks Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida, sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

Vaba tarkvara

2023-01-10T17:23:11Z

Zeroconf: /* Välislingid */

[[Kategooria:Litsentsid]]
''See artikkel käsitleb vaba tarkvara nii, nagu see on defineeritud Vaba Tarkvara Sihtasutuse poolt. Tasuta tarkvara kohta vaata [[priivara]].''
----
'''Vaba tarkvara''' ehk '''vabavara''' või '''vabatarkvara''', nagu defineeritud Free Software Foundation'i ([https://et.wikipedia.org/wiki/Free_Software_Foundation Vaba Tarkvara Sihtasutuse]; edaspidi viidatud kui ''FSF'') poolt, on tarkvara, mida saab ilma piiranguteta kasutada, kopeerida, uurida, muuta ning edasi jagada. Vabadus sellistest piirangutest on keskne "vaba tarkvara" mõistele, niivõrd, et vaba tarkvara vastand on [[omanduslik tarkvara]], ning mitte tarkvara, mida müüakse raha eest, nagu näiteks kommertstarkvara. Vaba tarkvara võib olla mõnikord tuntud ka kui ''libre software'', [[FLOSS]] või avatud lähtekoodiga tarkvara. Tihti on omandusliku tarkvaraga seotud ka [[tootjalukustus]].

==Mõiste sisu==

Et aidata eristada vaba (nagu vabadus) tarkvara tasuta tarkvarast (mõnikord viidatud ka kui vabavara), arendas [[Richard Stallman]], Vaba Tarkvara Liikumise rajaja, sellise seletuse: "Vaba tarkvara puudutab vabadust, mitte hinda. Et mõistest aru saada, tuleks mõelda 'vabast' nagu see on "vabas sõnas"/"sõnavabaduses", ja mitte nagu 'tasuta õllest'." (Ingliskeelse sõna ''free'' tähendused on nii ''vaba'' kui ka ''tasuta''.)

Enamik vaba tarkvara levitatakse tasuta üle arvutivõrgu, nö liini pealt — või liiniväliselt (väljaspool arvutivõrke), levitamise marginaalse hinna eest, kuid hinna marginaalsus pole kohustuslik ning rahvas võib müüa koopiaid mistahes hinnaga. Läbivate suurtähtedega ingliskeelne termin "Open Source" ("avatud lähtekood") on lisatud definitsiooni, mis oli esialgselt loodud 1998. aastal Debiani ümberkirjutuses [[GNU]] "Vaba tarkvara" definitsioonist. Selle tulemusena on pea kõik Avatud lähtekoodiga programmid ka Vaba tarkvara, kuid on olemas mõned erandid.

Ehkki avatud-lähtekoodi ja vaba tarkvara liikumised jagavad pea identseid litsentsikriteeriume ja arendusmetoodikaid, on Stallmani meelest kahe liikumise vastavad põhimõtted fundamentaalselt erinevad. Stallman toetab termineid "Vaba/avatud-lähtekoodi-tarkvara" ("Free/Libre/Open-Source Software", "FLOSS") ning "Vaba ja avatud lähtekoodiga tarkvara" ("Free and Open Source Software", "F/OSS"), et vastavalt viidata "avatud-lähtekoodi tarkvarale" ja "vabale tarkvarale", et mitte ilmtingimata kahe osapoole  vahel valida või neid lahutada, aga ta palub inimestel kaaluda "vaba tarkvara" liikumise toetamist.


"[[Priivara]]" (nimetatakse sageli [[Priivara#Sõnakasutus|ekslikult ka vabavaraks]]) on tarkvara, mis on saadaval tasuta (ilma raha maksmata), kuid on üldjoontes [[Omanduslik_tarkvara|omanduslik]], kuna kasutajatel ei ole vabadust seda kasutada, kopeerida, uurida, muuta ja levitada. Priivara lähtekood pruugib või ei pruugi olla avaldatud ning luba muudetud versioonide edasijagamiseks pruugib või ei pruugi olla antud, seega priivara on ''gratis'', ehk ''tasuta'' ja mitte ''libre'', ehk ''vaba''.

== Vaba tarkvara lühike ajalugu ==

* 1960ndad ja 1970ndad — tarkvara nähti kui täiendusena, mida suurarvutite tarnijad varustasid, et raalid siis kasutuskõlbulikuks teha. Sellest johtuvalt programmeerijad ja arendajad jagasid oma tarkvara vabalt. See oli eriti laialdane suurtes kasutajagruppides, nagu DECUS, mis oli DEC Kasutajate Grupp (Digital Equipment Corporation Users Group).

* 1970ndate lõpp ja 1980ndate algus — ettevõtted hakkasid programmeerijatele jooksvalt piiranguid seadma tarkvara litsentsilepingutega. Mõnikord oli niimoodi seetõttu, et ettevõtted olid siis juba kommertsialiseeritud tarkvarast raha tegemas või püüdsid nad lähtekoodi peites hoida riistavara eripärasusi vaka all. Teinekord oli see sellest, et jätkuvalt suurenev korporatiivne suhtumine kasvavas ja varasemalt eklektilises tööstuses nägi intellektuaalse omandi kaitset normina, isegi kui see ei toonud mingit kasu ärile. [[Bill_Gates|Bill Gates]] andis muutuvatest aegadest märku, kui ta kirjutas kuulsa "Avaliku kirja hobilistele", kus ta ergutas häkkereid, et nad lõpetaksid litsentsilepingute murdmise läbi ''varastamise''.

* 1983 — Richard Stallman mõtles [[GNU]] projektile (GNU tegelik kirjutamine algas 1984. jaanuaris), rajades Vaba Tarkvara Sihtasutuse ("Free Software Foundation", FSF) [http://www.gnu.org/fsf/fsf.html] kaks aastat hiljem, peale sügavat pettumust arvutitööstuse ning kasutajate kultuuris. Üks selline intsident oli, kui printer ei töötanud, kuna Stallman ei saanud vea parandamiseks häkkida lähtekoodi, sest seda oli tagasi hoitud. Ta tutvustas "vaba tarkvara" ja "[[copyleft]]" definitsiooni, mis oli üles ehitatud kõigile tarkvara vabaduse tagamiseks.[http://cisn.metu.edu.tr/2002-6/free.php] Mõned väga pahaselt reageerisid Stallmani seisukoha vastu, pidades seda idealistlikuks nonsenssiks ning teda kõvasti pilati ja kritiseeriti.

* Tänapäev — Vaba tarkvara on väga edukas rahvusvaheline jõupingutus, mis valmistab tarkvara, mida kasutavad üksikisikud, suured organisatsioonid ja kogunisti terved riigid. Vaba tarkvara on massiivne tööstus. Vaba tarkvara mudeli majanduslikke eeliseid ning vähemal määral ka eetilisi põhimõtteid, millel see rajati, on hakatud laialdaselt tunnustama, isegi põhivoolu meedia poolt. Mõned teised, mitte-tarkvara tööstused, on hakanud ka tunnustama Vaba tarkvara sõnumi väärtust: näiteks teadlased vaatavad rohkem avatumate arendusprotsesside poole ning riistvara, nagu näiteks mikrokiipe, hakatakse juba arendama [[Copyleft]] litsentside all (vt. [[OpenCores]] projekt, näituseks). ''Creative Commons'' ja ''Avatud sisu'' (''Open Conent'') liikumised on samuti suuresti mõjutatud Vabast tarkvarast.

== Vaba tarkvara litsentsid ==
Stallmani ja FSF järgi annavad vaba tarkvara litsentsid —
*vabaduse jooksutada programmi mistahes eesmärgil (nimetet "vabadus 0");
*vabaduse uurida ja muuta programmi ("vabadus 1");
*vabaduse kopeerida programmi, et sul oleks võimalik aidata naabrit ("vabadus 2");
*vabaduse täiustada programmi ja oma täiustused avalikustada, et kogu kogukond sellest kasu lõikab ("vabadus 3").

Vabadused 1 ja 3 vajavad juurdepääsu [[lähtekood|lähtekoodile]], kuna tarkvara uurimine ja muutmine ilma lähtekoodita on erakordselt keeruline ning vägagi ebaefektiivne võrreldes märkmetega varustatud lähtekoodiga.

Vaba Tarkvara Sihtasutus ja Avatud Lähtekoodi Initsiatiiv (Open Source Initative; OSI) avaldavad mõlemad nimekirju litsentsidest, mis nad on välja selgitanud kui ühilduvatena nende definitsiooniga vastavalt vabast tarkvarast ja avatud lähtekoodiga tarkvarast.[http://www.gnu.org/licenses/license-list.html] Nimekirjad on paratamatult mittetäielikud, kuna kumbki organisatsioon ei pea olema litsentsist teadlik selle tarvis, et võimaldada neid vabadusi. Peale nende kahe organisatsioni näevad mõned inimesed Debiani projekti pakkuvat kasulikku nõu selle kohta, kas mingid konkreetsed litsentsid langevad kokku Debiani vaba tarkvara juhenditega. Heakskiidetud litsentsidest Debian nimekirja ei avalda, seega selle hinnanguid tuleb jälgida, kontrollides, millist tarkvara nad on lubanud oma arhiividesse. Ometi on see haruldane, kui litsents on kuulutatud ühilduvaks FSF või OSI ja mitte teise poole poolt (erandiks on Netscape Avalik Litsents (Netscape Public License, NPL), mida kasutati varaste Mozilla versioonidega), seega tingimuste täpsed definitsioonid ei ole poleemikat tekitanud.

Terminid Libre software, FLOSS, FOSS JA OSS/FS ei oma formaalseid tähendusi või ''de facto'' arbitraatoreid.

Enamik vaba tarkvara kasutab väikest rühma litsentse. Kõige populaarsemad neist on [[GNU_GPL|GNU Üldine Avalik Litsents]], GNU Vähem Üldine Avalik Litsents, BSD Litsents, Mozilla Avalik Litsents, MIT Litsents ja Apache Litsents.

Tarkvara, mis ei ole vaba tarkvara, on tuntud kui [[omanduslik tarkvara]]. See võib tulla kas mõnedega või üldse ilma ülaltoodud vabadustest ning peaaegu alati tuleb see lõppkasutaja litsentsilepinguga (End User License Agreement, EULA), mis näib tahtvat kasutada lepinguseadlust ja/või võlaõigusseadust eesmärgiga piirata kasutajate võimet tarkvara teatud viisidel jooksutada.

FSF-i vaba tarkvara definitsioon jätab tähelepanuta hinna. Laserplaadid, mis sisaldavad vaba tarkvara, nagu näiteks [[Linuxi_distributsioon|GNU/Linuxi distributsioone]], on tavaliselt müüdavad. Kuna sellegipoolest on plaadiostjal vaba tarkvara vabadused, on see vaba tarkvara. ''Tasuta õlle'' tarkvara ([[priivara]]), mis sisaldab piiranguid, mis on vastuolus FSF-i definitsioniga, peetakse omanduslikuks. Näiteks on lähtekood kättesaamatu, edasilevitajatel (-tarnijatel) võib olla keelatud nõuda tasu, jne.

Mõned inimesed kasutavad sõna "libre", et välistada sõna "vaba" kahemõttelisust (ingl. "free" on nii "vaba" kui "tasuta"). Siiski on need terminid enamasti kasutusel rohkem vaba tarkvara liikumises ning nad levivad aeglaselt edasi.

Vaba tarkvara variatsioonid FSF-i definitsiooni järgi:
* [[Copyleft]] litsentsid, neist kõige prominentsem [[GNU_GPL|GNU Üldine Avalik Litsents]]. Autor säilitab koopiaõiguse ning lubab teatud tingimustel edasilevitamist ja muutmist, tagamaks, et kõik muudetud versioonid jäävad vabaks.
* [[Avalik_omand|Avaliku omandi]] tarkvara (ingl. Public Domain software) — autor on koopiaõiguse loovutanud. Kuna avaliku omandi tarkvaral puudub autorikaitse, võib seda vabalt ühendada mistahes töö sisse, olgu see omanduslik või vaba.
* BSD-stiili litsentsid, niimoodi nimetatud, kuna neid rakendatakse suurele hulgale [[BSD]] opsüsteemidega levitatavale tarkvarale. Autor säilitab koopiaõiguse ainuüksi garantiist lahtiütlemise ja muudetud tööde temale korraliku omistamise kohustamise eesmärgil, kuid lubab edasilevitamist ja muutmist ''mistahes'' töödes, isegi omanduslikes.

Copyleftiga litsenseeritud tarkvara autoriõiguse omanik võib valmistada ja müüa versioone mistahes litsentsiga lisaks esialgse versiooni vaba tarkvarana levitamisele. Paljud vabatarkvara ettevõtted niimoodi teevadki; see ''ei piira'' copyleft versiooniga kasutajatele antud õiguseid.

Kõik vaba tarkvara litsentsid peavad andma inimestele kõik ülalpool arutatud vabadused. Välja arvatud siis, kui applikatsioonide litsentsid on ühilduvad, on programmide kombineerimine lähtekoodi kokku segades või otseselt binaaride ühendamise teel ometigi problemaatiline, litsentside tehniliste peensuste pärast. Kaudselt kokkuühendatud programmid võivad seesugust probleemi vältida.

== Vaba tarkvara näited ==

Silmapaistev vaba tarkvara:

* Operatsioonisüsteemid: [[GNU/Linux]], [[BSD]] ja Darwin.
* [[GNU_Compiler_Collection|GCC]] kompileerijad, GDB puugieemaldaja (debugger) ja [[C_%28programmeerimiskeel%29|C]] [[teek|teegid]].
* Serverid: BIND nimeserver, Sendmail e-posti transport, [[Apache]] veebiserver ja Samba failiserver.
* Relatsioonilised andmebaasisüsteemid: [[MySQL]] ja [[PostgreSQL]].
* Programmeerimiskeeled: [[Perl]], [[PHP]], [[Python]], [[Ruby]] ja [[Tcl]].
* Graafilise kasutajaliidesega seoses: [[X_Window_System|X Window System]]; [[GNOME]] ja [[KDE]] töölauakeskkonnad.
* [[OpenOffice.org]] kontoritöö pakett, [[Mozilla]] ja [[Firefox|Mozilla Firefox]] lehitsejad ning [[GIMP]] graafikatöötlusprogramm.
* Trükkimise ja dokumendi ettevalmistus-süsteemid Tex ja [[LaTeX]].
* [[MediaWiki]], tarkvara, millel töötab Vikipeedia.

Vaba Tarkvara Kataloog ("Free Software Directory") on vabatarkvara projekt, mis haldab suurt andmebaasi vaba tarkvara pakettidest.

Päris palju vaba tarkvara toetab mittevabu Microsoft [[Windows]]i või mittevabu Unix platvorme ning mittevaba tarkvara saab toetada vabu platvorme, ehkki vabatarkvara-puristid (ingliskeelsest sõnast ''pure'' — puhas) eelistavad üleni vaba tarkvara vabal platvormil, nagu [[GNU/Linux]].

Vaba tarkvara paketid moodustavad tarkvara ökosüsteemi, kus tarkvara võimaldab varustada teenuseid, saavutades vastastikuse kasu: näiteks Apache veebiserver haldamas HTTP protokolli, kasutades moodulit mod_python, et võimaldada dünaamilist sisu.

== Sotsiaalne tähendus ==

===Positiivsed sotsiaalsed tagajärjed===

* Vaba tarkvara on üldiselt saadaval vähese või puuduva kuluga (see on tasuta). Kui vaba tarkvara levib, siis selle kasulikkus on püsiv või isegi suureneb võrguefekti tulemusel. Seega on vaba tarkvara puhas avalik hüvang ja mitte isiklik hüvang.
* Selle vabadustest tulenevad püsivalt madalad kulud võrreldes omandusliku tarkvaraga, suurendades juurdepääsu tarkvarale ja selle majanduslikele ja sotsiaalsetele kasudele.
* Enamgi veel, vaba tarkvara avatus kergendab selle internatsionalisatsiooni (näiteks programmide tõlkimist emakeelde), andes juurde ja luues majanduslikku ja sotsiaalset kasu.

===Negatiivsed sotsiaalsed tagajärjed===

Võimalik majanduslike mõjustajate kadu tootmaks tarkvara, mis oli kaitstud koopiaõiguse seadusega või patentidega. Vaba tarkvara koopiaid saab müüa, ehkki sel juhul on tihtipeale vähem ajendeid vaba tarkvara ostmiseks, kui seda saab hankida tasuta.

==Poliitiline iseloomustus==

Arvutitarkvara on elutu ja seega mittepoliitiline. Ometi on selle mõjud ühiskonnale, nagu ka kõne, poliitilised.

===Vaba tarkvara kui kommunistlik liikumine===


UNIX-operatsioonisüsteemidele keskenduva California ettevõtte SCO Group'i peadirektor Darl McBride on kaldunud iseloomustama vaba tarkvara kui kommunistliku.[http://www.economist.com/business/displayStory.cfm?story_id=2020889] Ühendriikide kontekstis kasutab süüdistus antikommunismi mõjuka pärandi mõjujõudu turul või seaduseasjades efekti esilekutsumiseks.[http://news.com.com/2010-7344-5083904.html] Kommunism vastustab vaba turgu ning heidab kõrvale eraomandi. Vaba tarkvara annab kasutajatele samu vabadusi, mida omab koopiaõiguse valdaja, samas kui omandusliku tarkvara omanikud piiravad vabadusi kasumiteenimise eesmärgil. Kollektiivse valduse mudelid vabas tarkvaras on vastuolus kapitalistliku omanduse ja tootmisega. Siiski annavad vaba tarkvara litsentsid vabaduse tarkvara edasijagamise eest raha küsida. Lisaks on ühel või rohkemal autoriõiguse omanikul abiks autorikaitseseadus, panemaks vajadusel maksma nende vabatarkvara paketi litsentsi jõu.

=== Vaba tarkvara kui libertaarne liikumine ===

Libertaarset ideaali saab kirjeldada kui toetavat sotsiaalse vabaduse (kaasa arvatud sõnavabaduse, vaba ajakirjanduse ja [[privaatsus]]e), majandusvabaduse (kaasa arvatud eraomandi ja kontrolli eraomandi üle) ning vabaturumajanduse pooldamist. On tõendeid, et vaba tarkvara ühildub selliste libertaarsuse ideaalidega nagu ettevõtlusvabadus, intellektuaalne omand [http://libertariannation.org/a/f31l1.html] ja
privaatsuse kaitse.

Vaba tarkvara litsentsitingimused garanteerivad, et kes iganes, sattudes selle tarkvara omanikuks, omab ka selle lähtekoodi ning õigust seda muuta, paljundada ja levitada. Niisiis on igaüks vajalike teadmistega võimeline teostama muudatusi ja võimaldama tootele tuge. Muudatused on otseselt võimalikud läbi juurdepääsu lähtekoodile ning teisi teenuseid saavad pakkuda need, kes on toote hooldajate ja kasutajatena sellest  teada saanud, seda uurinud ja õppinud. Tulemuseks on konkurentsile avatud turuala laia osaliste hulga seast. Turule sisenemise barjääre on vähe või nad puuduvad, kuna kõik vajalikud load on litsentsi poolt rahuldatud. Sellise konkurentsi loomine teenuste jaoks on köitev libertaarsele ideaalile vabast turust ning hõlbustab ettevõtete ja äride loomist.

== Viited ==
* [[Mis on Linux ja miks seda valida?]]
* [http://www.teabekirjanduse.ee/sisukorrad/tarkvara.pdf Madis Peil: Tasuta tarkvara käsiraamat]
* [http://www.slideshare.net/UncleOwl/pingviini-ttuba Pingviini töötuba: vaba tarkvara ja Linuxit tutvustavad slaidid]
* [http://www.e-ope.ee/images/50001107/wmag.pdf Peeter P Mõtsküla: Vaba tarkvara litsentside süstemaatiline analüüs (mag töö Tartu Ülikoolis)]
* [http://isiklik.info/cc/wbt.pdf Peeter P Mõtsküla: Vaba tarkvara. Oht või võimalus (bak töö Tartu Ülikoolis)]
* [http://et.wikipedia.org/wiki/Vaba_tarkvara Sõsarartikkel Vikipeedias]
* [http://en.wikibooks.org/wiki/FLOSS_Concept_Booklet FLOSS Concept Booklet (inglise keeles)]

ID-kaart Manjaro Linuxis

2022-03-26T11:35:57Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka mõnda muud [https://wiki.archlinux.org/title/AUR_helpers AURi klienti].
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida, sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-25T11:03:15Z

Zeroconf: /* Vigade haldamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka ''sudo pamac''.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida, sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-25T11:02:41Z

Zeroconf: /* Vigade haldamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka ''sudo pamac''.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida (sõltumata sellest, kas need laiendused on paigaldatud pakina või veebilehitseja rakenduste poest).'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-25T11:01:51Z

Zeroconf: /* Vigade haldamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka ''sudo pamac''.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Kui mingil põhjusel pole web-eid pakett paigaldatud, siis ei saa ka Web eID laiendused veebilehitsejas toimida.'''

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-25T10:57:39Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka ''sudo pamac''.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame ''Token signing'' laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-25T10:57:04Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest. ''yay'' asemel võib kasutada ka ''sudo pamac''.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-22T12:32:00Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rns chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-21T01:16:25Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja (või ka arvuti) ja testime uuesti. Veendume, et veebilehitsejas on Web eID laiendus ja vana on eemaldatud. Tasub vaadata ka [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ juhiseid laienduse lubamiseks].

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-21T01:15:01Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
* testime Web eID laiendust aadressil [https://web-eid.eu/ https://web-eid.eu/], vajadusel taaskäivitame veebilehitseja ja testime uuesti

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-21T01:13:57Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* impordime Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-21T01:13:35Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* impordime esmalt Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-21T01:13:09Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
* impordime esmalt Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-20T19:02:23Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
* impordime esmalt Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-20T19:00:29Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest.
Paigaldame esmalt Web eID.
* impordime esmalt Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-20T18:59:17Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest
* paigaldame Web eID
* impordime esmalt Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
* paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
* eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-20T18:58:54Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest
* paigaldame Web eID
** impordime esmalt Web eID arendaja võtme
<syntaxhighlight lang="bash">
wget -q -O- https://github.com/mrts.gpg|gpg --import -
</syntaxhighlight>
** paigaldame Web eID
<syntaxhighlight lang="bash">
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
** eemaldame vana veebilehitseja laienduse
<syntaxhighlight lang="bash">
yay -Rn chrome-token-signing
</syntaxhighlight>
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-20T18:56:40Z

Zeroconf: /* Uuendamine Web eID peale */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=
Kui oli juba ID-kaarditarkvara paigaldatud, siis pole vaja kõike eemaldada ega uuesti paigaldada. Piisab väiksematest muudatustest
* paigaldame Web eID
** impordime esmalt Web eID arendaja võtme
wget -q -O- https://github.com/mrts.gpg|gpg --import -
** paigaldame Web eID
yay -Syu web-eid --noconfirm --needed --cleanafter && yay -Scc --noconfirm
** eemaldame vana veebilehitseja laienduse
yay -Rn chrome-token-signing
* eemaldame vajadusel Token signing laienduse veebilehitseja(te)st
* paigaldame Web eID laiendused veebilehitsejas: [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium jt analoogid] | [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-20T18:43:47Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Uuendamine Web eID peale=

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-18T00:26:52Z

Zeroconf: /* Skriptiga paigaldamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linuxis jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple selle põhjal tehtud distrotes] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-18T00:22:44Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:56:12Z

Zeroconf: /* Viited */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://web-eid.eu/ Web eID veebileht]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:53:06Z

Zeroconf: /* ID-kaarditarkvara automaatse paigaldamise skript */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [https://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.

=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:52:02Z

Zeroconf: /* Distrod */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:49:38Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:48:56Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

'''[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega.''' Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:48:04Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse.

[https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:47:02Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

Selleks, et [https://web-eid.eu/ Web eID] laiendused veebilehitsejas töötaks, on vaja eelnevalt [https://aur.archlinux.org/packages/web-eid web-eid] pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:44:18Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale + vajutada ''Enter'')
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:42:22Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale)
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:40:43Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada Web eID veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale)
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''
* salvestada muudatus - vajutada ''Enter'' või rea lõpus vastav nupp

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:38:52Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada Web eID veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale)
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.
* aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:38:32Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada Web eID veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale)
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis.

Aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:30:14Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada Web eID veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* '''about:preferences#privacy''' (sisestada aadressireale)
* '''Turvaseadmed -> Laadi'''
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:29:48Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada Web eID veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* about:preferences#privacy (sisestada aadressireale)
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T18:29:21Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada Web eID veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* about:preferences#privacy
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T15:48:43Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada Web eID veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T15:47:36Z

Zeroconf: /* Firefoxi seadistamine */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi on seal väärtus: '''Ask Every Time'''
* automaatse režiimi sisselülitamiseks kirjutada selle asemele: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T15:46:51Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID või muud nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi: '''Ask Every Time'''
* automaatne režiim: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T15:42:06Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>
Siiski tuleb ettevaatlik olla vanema laienduse paigaldamisega kuna see võib Web eID'ga konflikti minna. Siis on mõistlikum jätta alles Web eID ja vanema teenuse puhul näiteks Smart-ID vms nutiseadme-põhist lahendust kasutada kuniks teenusepakkuja ka Web eID peale ära on uuendanud.

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi: '''Ask Every Time'''
* automaatne režiim: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T15:38:07Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi: '''Ask Every Time'''
* automaatne režiim: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T15:36:36Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
<syntaxhighlight lang="bash">
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm
</syntaxhighlight>

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi: '''Ask Every Time'''
* automaatne režiim: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T15:35:41Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Kui siiski internetipangas või mujal ei toimi ID-kaart, kuna pole jõutud Web eID'd kasutusele võtta, siis paigaldada ka see pakett
yay -Syu chrome-token-signing --noconfirm --needed --cleanafter && yay -Scc --noconfirm

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi: '''Ask Every Time'''
* automaatne režiim: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T14:35:55Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
'''NB! Kasutajatel tuleb ise paigaldada veebilehitsejate laiendused:'''
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

[https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid], [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi: '''Ask Every Time'''
* automaatne režiim: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]

ID-kaart Manjaro Linuxis

2022-03-17T06:50:20Z

Zeroconf: /* Web eID */

=Skriptiga paigaldamine=

Skript on tekstifail, mis sisaldab vajalikke käske, mida muidu peaks käsurealt ükshaaval sisestama. Kuid need saab kirjutada vastavasse tekstifaili, millel on määratud [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang]. Sellist skripti käivitades täidetakse käsud kiirelt, vastavalt arvuti võimsusele. See annab võimaluse käsud hästi läbi mõelda ja vead parandada ning edaspidi seda skriptina käivitades aega kokku hoida. Vähe sellest, et käskude kirjutamine on aeglane, selle käigus tekivad ka vead. Vahel on vaja ka skripti kohandada, täiendada, kuid see on oluliselt lihtsam, kui kõike kogu aeg käsitsi sisestada.

Allolev skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt [https://distrowatch.com/search.php?ostype=Linux&category=All&origin=All&basedon=Arch&notbasedon=None&desktop=All&architecture=All&package=All&rolling=All&isosize=All&netinstall=All&language=All&defaultinit=All&status=Active#simple Arch Linuxi põhjal tehtud distrod] (vt [[#Distrod|testitud distrod]]). Hea oleks kuulda tagasisidet [https://viki.pingviin.org/index.php?title=Arutelu:ID-kaart_Manjaro_Linuxis&action=edit&redlink=1 arutelu kaardisakil], mis distrosid olete testinud ja kuidas on toiminud. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.

Kes soovib, saab skriptis olevaid käske ka ükshaaval terminalis käivitada. Trellidega algavad read nimetatakse välja kommenteeritud ridadeks ja need kuvatakse ka vastavalt. Seega aktiivsed read on need, mille ees trelle ei ole.

=Võtmete eelnev vaatamine AUR'ist=

See annab võimaluse AURi veebiliidesest puuduvad [https://www.gnupg.org/ GPG]-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse ''validpgpkeys'' juures ülakomade vahel ongi paigaldamisel kontrollitava [https://www.gnupg.org/ GPG] avaliku võtme [https://stackoverflow.com/questions/33735276/the-purpose-of-fingerprints-gpg sõrmejälg]:

* [https://aur.archlinux.org/packages/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
* [https://aur.archlinux.org/packages/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
* [https://aur.archlinux.org/packages/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
* [https://aur.archlinux.org/packages/firefox-extension-web-eid firefox-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chromium-extension-web-eid chromium-extension-web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid-webextension View PKGBUILD]
* [https://aur.archlinux.org/packages/chrome-token-signing/ chrome-token-signing] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=chrome-token-signing View PKGBUILD] (ei ole enam kasutusel seoses web-eid tulekuga)

Kavalam on mitte otse kasutada GPG-võtmete sõrmejälgi, vaid need otse viidatud veebilehtedelt importida. Skriptis on see ka nüüdseks lahendatud. Võti võib ka muutuda ja otse serverist importides tuleb alati õige GPG-võti.

=ID-kaarditarkvara automaatse paigaldamise skript=

Skript asub [http://alvatal.ee/ Alvatali] koodivaramus [https://koodivaramu.eesti.ee/alvatal/id-kaart ID-kaart]:
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/blob/main/manjaro-id-kaart.sh skripti veebis vaatamine ja allalaadimine]
* [https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh otselink failile]

Linuxis:
* kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
* avada terminal (Manjaro Linuxis: kiirklahv F12; muidu tavaliselt CTRL+ALT+T)
* skripti allalaadimine kausta ''Allalaadimised'' (või mistahes muus keeles süsteemi allalaadimiste kausta):
** üks võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, seejärel klõpsata hiirerattaga terminalis ja käivitab (vajadusel vajutada veel Enter, et käivitada)
** teine võimalus: hiire vasaku klahviga 3 klõpsu kiirelt märgib terve rea, CTRL+C kopeerib, SHIFT+CTRL+V asetab terminali ja käivitab (vajadusel vajutada veel Enter, et käivitada)
<syntaxhighlight lang="bash">
wget -q --show-progress -O $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh https://koodivaramu.eesti.ee/alvatal/id-kaart/-/raw/main/manjaro-id-kaart.sh
</syntaxhighlight>
* skripti käivitamine [https://en.wikipedia.org/wiki/Bourne_shell Bourne'i kestprogrammi] abil:
<syntaxhighlight lang="bash">
sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh
</syntaxhighlight>

Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.

Seejärel lubada veebilehitseja laiendused ja käivitada veebilehitseja või ka DigiDoc rakendus. Kui veebilehitseja oli avatud laienduste paigaldamise ajal, siis tasub see uuesti käivitada.

DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
=Web eID=
15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust [https://web-eid.eu/ Web eID] ja asendab senise [https://github.com/open-eid/chrome-token-signing chrome-token-signing] laienduse. [https://web-eid.eu/ Web eID veebilehel] saab ka sisselogimist ja digiallkirjastamist testida uue laiendusega. Vajutades avalehel olevat nuppu ''Authenticate'', pakutakse värskelt paigaldatud Web eID laienduse abil esmalt sisselogimist ID-kaardiga ja seejärel ka digiallkirjastamist. Värskelt digiallkirjastatud *.asice konteineri saab ka alla laadida. Tegevuste lõpetamiseks saab välja logida proovikeskkonnast.

Ametlik uudis: [https://www.ria.ee/et/uudised/id-tarkvara-varske-versioon-sai-uuendusliku-web-eid-liidese.html eesti keeles] | [https://www.ria.ee/en/news/latest-version-id-software-includes-innovative-web-eid-interface.html inglise keeles] | [https://www.ria.ee/ru/novosti/poslednyaya-versiya-programmnogo-obespecheniya-dlya-id-karty-poluchila-innovacionnyy-veb.html vene keeles]

Web eID seadistamine: [https://www.id.ee/artikkel/veebibrauserite-seadistamine-id-kaardi-kasutamiseks/ eesti keeles] | [https://www.id.ee/en/article/configuring-browsers-for-using-id-card/ inglise keeles] | [https://www.id.ee/ru/artikkel/nastrojka-veb-brauzerov-dlya-ispolzovaniya-id-karty/ vene keeles]

Web eID laiendused veebilehitsejatele:
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad]
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]

=Firefoxi seadistamine=

Firefoxis võib olla vajalik lisada käsitsi turvamoodul, kui seda mingil põhjusel ei ole tekkinud.
* Turvaseadmed -> Laadi
* Nimi: '''OpenSC smartcard'''
* asukoht: '''/usr/lib/onepin-opensc-pkcs11.so'''

Lisaks kasulik automaatne sertifikaadi valimine Firefoxis
aadressireale kirjutada '''about:config''' ja vajutada ''Enter'' ning olla nõus hoiatusega
* otsida üles parameeter '''security.default_personal_cert'''
* vaikimisi: '''Ask Every Time'''
* automaatne režiim: '''Select Automatically'''

=Distrod=
Käesolevat skripti on testitud järgmiste distrotega ja leitud töötavat:
* [https://manjaro.org/ Manjaro Linux]
* [https://endeavouros.com/ Endeavour OS]

=Vigade haldamine=

Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.

''sudo'' kasutamiseks peab kasutaja olema ka samanimelises rühmas.

Tavaliselt on probleemiks arvutiga ühendatud ID-kaardilugeja äratundmine. Vajadusel taaskäivitada DigiDoc klient kui ei taha ID-kaardilugejat ära tunda. Sama kehtib ka veebilehitseja kohta, mida tasub siis taaskäivitada vajadusel.

Veebilehitseja puhul tasub muidugi ka veenduda, et ID-kaarditarkvara laiendus on lubatud - selle töölesaamiseks on käesoleva viki lehe lõpus viidete hulgas artikkel ''Manjaro ja ID-kaart'' koos piltidega selle kohta, kuidas neid lubada ja seda kontrollida. Samas artiklis on ka juhised lisatarkvara paigaldamiseks, kui on kasutusel selline ID-kaardilugeja, mida ''[https://ccid.apdu.fr/ ccid]'' tarkvara poolt ära ei tunta.

'''Arvutiga ühendatud ID-kaardilugejat aitab ära tunda, kui teenus ''pcscd.socket'' taaskäivitada - selleks ei ole vaja arvutit taaskäivitada.''' Arvuti taaskäivitamine aitab ka vaid siis, kui teenus ''pcscd.socket'' on lubatud automaatselt käivituda operatsioonisüsteemi käivitumisel. Vastav rida on automaatse paigaldamise skripti lõpus olemas, mis seda lubab - vajadusel saab seda sealt siis eraldi käsitsi kasutada, et teenus ''pcscd.socket'' lubada. Teenuse olekut: seisab (''inactive''), töötab (''active'') selle lubamine (''enable'') või keelamine (''disable'') käesoleval juhul ei muuda.

Kui teenus ''pcscd.socket'' ei tööta, siis ka ''restart'' paneb selle tööle:

<syntaxhighlight lang="bash">
sudo systemctl restart pcscd.socket
</syntaxhighlight>

Teenuse ''pcscd.socket'' puhul saab kasutada: ''start'' (käivita), ''stop'' (seiska), ''restart'' (taaskäivita), ''status'' (näita olekut).

Teenus ''pcscd.service'' pannakse seisma, kui ID-kaardilugejat ei leitud süsteemist. Kuid teenus ''pcscd.socket'' jääb tööle. Kui ''pcscd.socket'' töötas, siis niipea, kui ID-kaardilugeja külge tuleb, pannakse ''pcscd.service'' tööle ''pcscd.socket'''i poolt. Kui näiteks ''pcscd.socket'' seisma panna, seiskub ka ''pcscd.service''. Taaskäivitades teenust ''pcscd.socket'', taaskäivitatakse ka teenus ''pcscd.service''. Muidugi ei saa keegi keelata ''pcscd.service'' teenust eraldi hallata, kuid selleks vajadus tavaliset puudub, kuna teenus ''pcscd.socket'' tegeleb sellega.

Arvutiga ühendatud ID-kaardilugejate vaatamine terminalis:
<syntaxhighlight lang="bash">
opensc-tool --list-readers
</syntaxhighlight>
Kui ei leita ID-kaardilugejaid, siis tulebki sellega tegeleda, et ära tuntaks - näiteks taaskäivitada ''pcscd.socket'' teenus. Põhjus võib olla ka selles, et paigaldatud ID-kaardilugeja tarkvara ''[https://ccid.apdu.fr/ ccid]'' ei tunne ära kasutatavat ID-kaardilugejat ja on vaja tegeleda sellega, et ID-kaardilugejale sobiv tarkvara leida ja esmalt paigaldada. Sellest on muuhulgas juttu ''Manjaro ja ID-kaart'' artiklis, mille viide on käesoleva artikli lõpus.

Kui ID-kaart on kaardilugejas, siis võimalik ka ID-kaardi sertifikaate terminalis vaadata:
<syntaxhighlight lang="bash">
pkcs15-tool --list-certificates
</syntaxhighlight>

=Tänud=
Suured tänud Arvo Mägile, kes juhtis tähelepanu skripti optimeerimisele, et vältida mitmekordset varamutest uuendamist. Samuti kiirema peegelserveri valik ja yay saadavus kogukonna varamus. Vana kool räägib, et yay paigaldatakse Git'ist, kuid see on siiski olemas ka kogukonna varamus juba, seega on optimaalsem sealt paigaldada. Lisaks ka kena võimalus paigaldada paketti siis, kui see vajalik on ehk siis paigaldamata. Asi, mida Ubuntus ka vaja läheks. Lisaks ka võimalusele, et alati ei pruugi teenus ''pcscd.socket'' toimida, mistõttu on kavalam seda taaskäivitada, mis omakorda ka käivitab teenuse, kui see veel ei töötanud.

=Viited=
* [https://valley-railway-053.notion.site/283b773276724261aecbb8f09eaa0ab4 Manjaro ja ID-kaart] - siin lisaks skriptile ka samm-haaval käsitsi paigaldamine läbi tehtud, sh veebilehitsejas laienduste lubamine ja ekraanipildid ka lisatud. Lisaks on selgitatud ka teiste ID-kaardilugejate tarkvarapakettide paigaldamisvõimalusi, mis ka AURi varamus olemas.
* [https://github.com/open-eid/linux-installer/wiki/Linux-Packages ID-kaarditarkvara tugi teistes Linuxi distrotes]
* [https://www.id.ee/artikkel/paigalda-id-tarkvara/ ametlik ID-kaarditarkvara paigaldamise leht]
* [https://github.com/open-eid/ RIA open-eid lähtekoodi varamu]
* [https://github.com/open-eid/DigiDoc4-Client DigiDoc4-Client varamu]
* [https://github.com/web-eid Web eID varamu]