eIDAS-klient projekt on näidislahendus, mis vastavalt eIDAS konnektorteenuse liidese spetsifikatsioonis sätestatud nõuetele suhtleb Eesti eIDAS Node konnektorteenusega.
Lahendus koosneb kahest osast:
- Teek - pakub usaldustoiminguteks vajalikke funktsioone, sh teenusepakkuja metateabe koostamine, konnektorteenuse metateabe hankimine, autentimispäringute koostamine ja -vastuse valideerimine ning töötlus.
- Veebiteenus - mikroteenus, mis pakub veebiliidest SAML spetsiifiliste operatsioonide teostamiseks. Toetatud on teenusepakkuja metateabe publitseerimine, konnektorteenuse metateabe töötlus ja autentimispäringute saatmine ning vastuvõtt konnektorteenuselt.
Ülevaate eIDAS-klient projekti ehitusest ja komponentidest leiab siit.
Ülevaate sellest, milliseid otspunkte pakub eIDAS-klient veebiteenus, leiad siit.
eIDAS-klient veebiteenuse paigaldamiseks ja käivitamiseks vajalikud tegevused lühidalt (eeldab Java 1.8+):
- Hangi githubist viimane lähtekood
git clone https://github.com/e-gov/eIDAS-Client.git
- Ehita eIDAS-klient projekt
./mvnw clean install
- Genereeri näidisvõtmed ja seotud konfiguratsioonifail (või loo ise, vt Seadistamine)
eidas-client-webapp/src/test/resources/scripts/generateTestConfiguration.sh
- Käivita veebiteenus
java -Dspring.config.location="./eidas-client-webapp/target/generated-test-conf/application.properties" -jar eidas-client-webapp/target/eidas-client-webapp-1.0.0-SNAPSHOT.war
- Veendumaks, et rakendus käivitus edukalt, ava brauseris URL http://localhost:8889/metadata
NB! Selleks, et eidas-klienti reaalselt test konnektorteenuse vastu kasutada tuleb sõlmida liitumisleping ning edastada RIA-le genereeritud võtmehoidlast metateabe avalik võti (genereeritud näidiskonfiguratsiooni puhul /eidas-client-webapp/target/generated-test-conf/sp_metadata.crt)
Pikema ja täpsema seletuse selle kohta, kuidas veebiteenust paigaldada ja seadistada leiad integraatori juhendist.