arti/Estonian-ID-card-mobile-authenticator-POC

Fork 0

mirror of https://github.com/TanelOrumaa/Estonian-ID-card-mobile-authenticator-POC.git synced 2024-12-22 12:30:16 +02:00

History

TanelOrumaa 7daea4b6c2 MOB-55 Added vue frontend		2021-12-06 18:14:01 +02:00
..
.mvn/wrapper	MOB-42 Added backend server, two frontend webpages and rest endpoints for getting challenge, submitting authentication token and getting authentication object. MOB-21 Added JWT creation, but whole process still needs some work.	2021-11-08 17:30:56 +02:00
src	MOB-55 Added vue frontend	2021-12-06 18:14:01 +02:00
.gitignore	MOB-42 Added backend server, two frontend webpages and rest endpoints for getting challenge, submitting authentication token and getting authentication object. MOB-21 Added JWT creation, but whole process still needs some work.	2021-11-08 17:30:56 +02:00
mvnw	MOB-42 Added backend server, two frontend webpages and rest endpoints for getting challenge, submitting authentication token and getting authentication object. MOB-21 Added JWT creation, but whole process still needs some work.	2021-11-08 17:30:56 +02:00
mvnw.cmd	MOB-42 Added backend server, two frontend webpages and rest endpoints for getting challenge, submitting authentication token and getting authentication object. MOB-21 Added JWT creation, but whole process still needs some work.	2021-11-08 17:30:56 +02:00
pom.xml	MOB-42 Fixed token authentication issues (wrong library version, cache getting recreated every request, origin in wrong form)	2021-11-11 21:47:27 +02:00
README.md	Added readme to backend demo project	2021-11-08 17:49:42 +02:00

README.md

Demo backend + website for mobile authentication project.

How to run.

1. Clone GIT repository

2. Setup HTTPS

Since Web eID only works over HTTPS connection, you'll need to serve the backend and website with an HTTPS certificate. A suitable tool for that is ngrok (https://ngrok.com/). To use ngrok, download it and then run the command (may need administrator rights) ngrok http 8080 and you should see something like this:

ngrok by @inconshreveable                                                                               (Ctrl+C to quit)

Session Status                online                                                                                    
Account                       TanelOrumaa (Plan: Free)                                                                  
Version                       2.3.40                                                                                    
Region                        United States (us)                                                                        
Web Interface                 http://127.0.0.1:4040                                                                     
Forwarding                    http://somethinghere.ngrok.io -> http://localhost:8080                              
Forwarding                    https://somethinghere.ngrok.io -> http://localhost:8080                             
                                                                                                                        
Connections                   ttl     opn     rt1     rt5     p50     p90                                               
                              1508    0       0.00    0.00    2.31    75.59                                             
                                                                                                                        
HTTP Requests                                                                                                           
-------------

Copy the second forwarding link (the one with https) and put it in com.tarkvaratehnika.demobackend.config.ApplicationConfiguration.kt as val WEBSITE_ORIGIN_URL = "https://yourlinkhere.com"

3. Run the project

Use your favourite IDE or just run it via commandline with ./mvnw spring-boot:run

On your Android device browser navigate to the url you copied earlier and you should see the website landing page. If you have the mobile authentication app installed, you should be able to log into the website with your Estonian ID-card.

Credits...

...go out to creators of https://github.com/web-eid/web-eid-spring-boot-example. That example project was used in some parts as an example (files where inspiration was taken are correctly annotated with the appropriate license text).