arti/Estonian-ID-card-mobile-authenticator-POC
1
0
Fork 0
mirror of https://github.com/TanelOrumaa/Estonian-ID-card-mobile-authenticator-POC.git synced 2024-12-22 04:20:16 +02:00
Code Packages Releases Wiki Activity
https://github.com/TanelOrumaa/Estonian-ID-card-mobile-authenticator-POC
117 Commits 10 Branches 7 Tags 25 MiB
Kotlin 72.3%
Java 16.1%
Vue 6.6%
JavaScript 3.1%
Shell 1.1%
Other 0.8%
b66c2386f0
Go to file
TanelOrumaa b66c2386f0 MOB-55 Small addition to readme
2021-12-12 20:25:24 +02:00
.github/workflows Merge pull request #7 from TanelOrumaa/MOB-33 2021-10-09 15:25:28 +03:00
demoBackend MOB-55 Small addition to readme 2021-12-12 20:25:24 +02:00
MobileAuthApp MOB-40 Changed header type from string to map and now will be used in requests 2021-12-12 20:05:18 +02:00
TestMobileApp testing new approach 2021-12-06 22:08:04 +02:00
.gitignore MOB-9 Added gitignore to ignore intellij and kotlin unnecessary files. 2021-10-02 14:19:47 +03:00
gradle.properties Fixes package name. 2021-10-05 23:52:27 +03:00
LICENSE Initial commit 2021-09-12 17:36:11 +03:00
README.md Removed irrelevant information from the readme 2021-11-23 11:40:07 +02:00

README.md

Estonian-ID-card-mobile-authenticator-POC

This is a proof-of-concept project for creating an Android app for authenticating yourself using an NFC-enabled Estonian ID card. This project will be created for the University of Tartu course "Software project".

Requirements to use the application

  • The smartphone's operating system must be Android 8.0 or newer
  • The smartphone must support NFC technology and it must be enabled
  • The user must have an Estonian ID card with NFC capability (issued since 2018)

Installing the application on the phone

The first option is to open the MobileAuthApp folder of the project on the Android Studio and use the smartphone instead of an emulator (the application does not work with emulators because real ID card has to be scanned, which an emulator can not do) to run the application. This way the application gets installed on the phone automatically.

More information about using real devices with Android studio: https://developer.android.com/studio/run/device

The second and more reliable option is to get the .apk that is generated under the Artifacts of GitHub Actions when the project is built. Download the .apk file and move it to the smartphone and install it (phone permissions might have to be changed because it is not installed through Google Play). After the application has been installed it should open as any other application.

More info about installing third party applications on the Android phones: https://www.androidauthority.com/how-to-install-apks-31494/

NB! Before using the application make sure that the NFC is enabled on the phone, otherwise information can not be read from the ID card.

Testing the application

The project comes with a test mobile application and a test web application that can be used to try the MobileAuthApp authentication feature even if you don't have any web applications or mobile applications that require user authentication. Both projects come with a README file that help with a setup. The mobile authentication application, when launched by the user not a website or some other application, can also read card holder's information, which can be used to verify whether the application reads the information from the ID card correctly.

Wiki pages relevant for the "Software project" subject