ID-kaart Manjaro Linuxis: erinevus redaktsioonide vahel

Allikas: Pingviini viki
Mine navigeerimisribaleMine otsikasti
← Vanem muudatus
Zeroconf (arutelu | kaastöö)
735 muudatust
Zeroconf (arutelu | kaastöö)
735 muudatust
 
(ei näidata 2 kasutaja 135 vahepealset redaktsiooni)
1. rida: 1. rida:
=Skriptiga paigaldamine=
=Skriptiga paigaldamine=


Skript on tekstifail, mis sisaldab vajalikke käske. Allolev skript tahab veel testimist. Viidete hulgas on artikkel, kus on pikemalt seletatud graafiliselt paigaldades, mille põhjal ka automaatse paigaldamise skript kirjutatud.
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=
=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. Ü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]:
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/xml-security-c/ xml-security-c] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c View PKGBUILD]
  validpgpkeys=('DCAA15007BED9DE690CD9523378B845402277962')
* [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/libdigidocpp/ libdigidocpp] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp View PKGBUILD]
  validpgpkeys=(
    'D1EBC666EFCBFBD3CFC2EBAA90C0B5E75C3B195D'  # Raul Metsma
  )
* [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/qdigidoc4/ qdigidoc4] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=qdigidoc4 View PKGBUILD]
  validpgpkeys=(
* [https://aur.archlinux.org/packages/web-eid web-eid] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=web-eid View PKGBUILD]
    'D1EBC666EFCBFBD3CFC2EBAA90C0B5E75C3B195D'  # Raul Metsma
  )
* [https://aur.archlinux.org/packages/esteidpkcs11loader/ esteidpkcs11loader] → [https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=esteidpkcs11loader View PKGBUILD]
  validpgpkeys=(
    'D1EBC666EFCBFBD3CFC2EBAA90C0B5E75C3B195D'  # Raul Metsma
  )
* [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]
  validpgpkeys=(
    'D1EBC666EFCBFBD3CFC2EBAA90C0B5E75C3B195D'  # Raul Metsma
  )
 
Võib vajadusel kaaluda ka võtmeserveri eelnevat süsteemi lisamist või anda importimisel käsitsi võtmeserver ette (''gpg --keyserver...'').


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.
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.
32. rida: 20. rida:
=ID-kaarditarkvara automaatse paigaldamise skript=
=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">
<syntaxhighlight lang="bash">
#!/bin/sh
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>


# skript käivitada
Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.
# sh skript.sh
# osa käske peavad minema tööle tavakasutajana


# uuendame tarkvarapakettide andmebaasid ja kogu süsteemi
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.
# peale uuendamist tühjendame pacmani vahemälu
sudo pacman -Syyu
sudo pacman -Scc --noconfirm


# Paigaldame Git'i
DigiDoc rakendus tunneb ID-kaardilugeja ära kohe peale PC/SC teenuse käivitumist ja ei pea selleks sulgema.
sudo pacman -Syyu git --noconfirm
sudo pacman -Scc --noconfirm


# Paigaldame yay, et omakorda paigaldada AURi pakette Pacmani abil. Seda on vaja vaid üks kord teha. Kui juba on varasemalt yay olemas, siis need read tasub siit välja kommenteerida.
=Web eID=
git clone https://aur.archlinux.org/yay-git.git
'''NB! Kasutajatel tuleb ise paigaldada [https://www.ria.ee/ RIA] väljastatud [https://web-eid.eu/ Web eID] veebilehitsejate laiendused:'''
cd yay-git
* [https://chrome.google.com/webstore/detail/web-eid/ncibgoaomkmdpilpocfeponihegamlic Chromium ja sellepõhised veebilehitsejad (Google Chrome, Brave, jt)]
makepkg -si --noconfirm # see peab käivituma tavakasutajana, vajalikul hetkel küsitakse sudo kaudu salasõna
* [https://addons.mozilla.org/en-US/firefox/addon/web-eid-webextension/ Firefox]
rm -fr ~/yay-git


###############
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.
# VÕTMESERVER #
###############
# GPG-võtmeservereid
# keyserver.ubuntu.com
# keys.openpgp.org
# https://wiki.archlinux.org/title/GnuPG#Key_servers
keyserver=keyserver.ubuntu.com


###########################
[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!
# GPG-VÕTMETE IMPORTIMINE #
###########################
# Puuduvate GPG-võtmete importimine eelnevalt
# xml-security-c
# võtame GPG-võtme otse AURi serverist
gpg --keyserver $keyserver --recv-keys $(curl -fsSL "https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=xml-security-c" | grep validpgpkeys | cut -d";" -f2 | rev | cut -d"&" -f2 | rev)
#
# libdigidocpp, qdigidoc4, esteidpkcs11loader, chrome-token-signing
gpg --keyserver $keyserver --recv-keys $(curl -fsSL "https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=libdigidocpp" | grep "Raul Metsma" | cut -d";" -f2 | rev | cut -d"&" -f2 | rev)


# automatiseeritult kõikide imporditud GPG-võtmete täielik usaldamine
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.
for i in `gpg --list-keys --with-colons --fingerprint | sed -n 's/^fpr:::::::::\([[:alnum:]]\+\):/\1/p'` ; do printf "trust\n5\ny\nquit" | gpg -q --no-tty --command-fd 0 --status-fd 2 --expert --edit-key $i 2>/dev/null 1>/dev/null ; done


##################################
'''[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.
# VAJALIKU TARKVARA PAIGALDAMINE #
##################################
# paigaldame ID-kaarditarkvara AUR'ist
yay -Syyu qdigidoc4 chrome-token-signing esteidpkcs11loader --noconfirm --cleanafter
#
# paigaldame ametlikust varamust kaardilugejate tarkvara
sudo pacman -Syu --noconfirm ccid
#sudo pamac install ccid --no-confirm
#
#puhastame paketihaldurite vahemälu paigaldatud tarkvarast
sudo pacman -Scc --noconfirm
sudo yay -Scc --noconfirm
sudo pamac clean --build-files --no-confirm
sudo pamac clean --no-confirm
# rm -rf ~/.cache/*


#####################################
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]
# CHROMIUMI JAOKS VAJALIK SEADISTUS #
#####################################
# see on kasutajaspetsiifiline seadistus
# tuleb käivitada iga kasutaja all üks kord
modutil -dbdir sql:$HOME/.pki/nssdb -add opensc-pkcs11 -libfile onepin-opensc-pkcs11.so -mechanisms FRIENDLY -force


# kontroll:
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]
# modutil -dbdir sql:$HOME/.pki/nssdb -list


# vajadusel kustutamine kinnitust küsimata
=Uuendamine Web eID peale=
# modutil -dbdir sql:$HOME/.pki/nssdb -delete onepin-opensc-pkcs11 -force
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].
# VÕI ka
* eemaldame vana veebilehitseja laienduse
# modutil -dbdir sql:$HOME/.pki/nssdb -delete opensc-pkcs11 -force
<syntaxhighlight lang="bash">
#
yay -Rns chrome-token-signing
# kui moodul on lisatud, siis teist korda sama moodulit lisada ei saa
</syntaxhighlight>
# siis tuleb kõigepealt eemaldada
* 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=
# PC/SC TEENUSE KÄIVITAMINE #
 
#############################
Käsud käivitada terminalis, mille avamiseks Manjaros kiirklahv F12, ka CTRL+ALT+T.
sudo systemctl start pcscd.socket
 
# vajadusel teenuse taaskäivitamiseks asendada start sõnaga restart
''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>


Seejärel avada terminal (kiirklahv F12) ja käivitada see skript selles kataloogis, kuhu see tehti. Kasutaja peab olema ''sudo'' rühmas, kuid skripti ei käivitata ''sudo'' abil, kuna osad käsud peavad minema käima tavakasutajana.
Seejärel luua symlink:
Näiteks
<syntaxhighlight lang="bash">
  sh idkaart-manjaro.sh
sudo ln -sf /usr/lib/libxml2.so.16.0.3 /usr/lib/libxml2.so.2
</syntaxhighlight>


Kui kõik hästi läheb, siis on ID-kaarditarkvara peale vajalike pakettide kompileerimist paigaldatud.
Siin parameeter f kirjutab eelmise symlingi üle. See vajalik kui symlink juba olemas kuid vahepeal libxml2 uuenenud ja vaja symlink üle kirjutada.


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.
=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=
=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
* [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]

Viimane redaktsioon: 17. mai 2025, kell 19:58

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 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 selle põhjal tehtud distrotes (vt testitud distrod). Hea oleks kuulda tagasisidet 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 GPG-võtmed ennem paigaldamist järgi vaadata ja skripti importimiseks kopeerida. Väärtuse validpgpkeys juures ülakomade vahel ongi paigaldamisel kontrollitava GPG avaliku võtme sõrmejälg:

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 Alvatali koodivaramus ID-kaart:

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)
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

sh $(xdg-user-dir DOWNLOAD)/manjaro-id-kaart.sh


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 RIA väljastatud Web eID veebilehitsejate laiendused:

Selleks, et Web eID laiendused veebilehitsejas töötaks, on vaja eelnevalt web-eid pakett paigaldada, mida automaatse paigaldamise skript ka teeb.

chromium-extension-web-eid, firefox-extension-web-eid laiendused on vaid nende testimiseks, arendamiseks!

15.märtsil 2022 tulnud ID-kaarditarkvara kasutab uut veebilehitseja laiendust Web eID ja asendab senise chrome-token-signing laienduse.

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: eesti keeles | inglise keeles | vene keeles

Web eID seadistamine: eesti keeles | inglise keeles | 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 AURi klienti.

  • eemaldame vana veebilehitseja laienduse
yay -Rns chrome-token-signing
  • eemaldame Token signing laienduse veebilehitseja(te)st
  • impordime Web eID arendaja võtme
wget -q -O- https://github.com/mrts.gpg|gpg --import -
  • paigaldame Web eID
yay -Sy web-eid-native web-eid-chrome web-eid-firefox --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.

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:

Loodud automaatpaigaldamise skript võiks toimida mitte ainult Manjaro Linuxis, vaid ka Arch Linux jt Arch Linuxi põhjal tehtud distrod (vt testitud distrod). Hea oleks kuulda tagasisidet 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 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: 

sudo systemctl restart pcscd.socket

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: 

opensc-tool --list-readers

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 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: 

pkcs15-tool --list-certificates

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 

ls -l /usr/lib/libxml2*

Seejärel luua symlink: 

sudo ln -sf /usr/lib/libxml2.so.16.0.3 /usr/lib/libxml2.so.2

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

Pärit leheküljelt "https://viki.pingviin.org/index.php?title=ID-kaart_Manjaro_Linuxis&oldid=10081"