Esup-nfc-tag-droid permet de lire (et potentiellement encoder) les cartes Mifare Desfire.
Le client s'appuie sur la platefome https://github.com/EsupPortail/esup-nfc-tag-server qui calcule les commandes (APDU) à transmettre à la carte.
Esup-nfc-tag-droid permet d'utiliser un smartphone Android pour badger, en utilisant l'UID (CSN) ou en faisant une lecture d'un fichier Desfire (avec autentification AES)
Une APK ESUP officielle et générique d'esup-nfc-tag-droid est diffusée depuis le Google Play ESUP : https://play.google.com/store/apps/details?id=org.esupportail.esupnfctagdroid
L'application peut aussi être packagée sous la forme d'un apk que l'on peut alors installer sur un smartphone Android en autorisant les applications de sources inconnues.
L'application peut être installée et debugée depuis Android-Studio ou compilée directement à l 'aide de Gradle
1 - L'application esup-nfc-tag-droid se comporte de la même manière que l'application Java [esup-nfc-tag-desktop] (https://github.com/EsupPortail/esup-nfc-tag-desktop "esup-nfc-tag-desktop")
2 - L'application repose sur un composant webview qui se connecte et affiche la vue fournie par esup-nfc-tag-server
3 - Après l'authentification Shibboleth il faut choisir la salle de badgeage
4 - Pour badger il suffit de poser une carte sur le lecteur nfc (à l'arrière du smartphone)
L'application est prévue pour tourner sous Android 5 minimun
Un smartphone Android (version 5 ou supérieur) équipé d'un lecteur NFC et disposant d'un accès Internet
Vous pouvez utiliser directement l'APK officielle et générique diffusée depuis Google Play par ESUP :
https://play.google.com/store/apps/details?id=org.esupportail.esupnfctagdroid
L'APK envoyée sur Google Play le 26 sept. 2023 est la version 1.2.4 disponible également depuis le Tag github 1.2.4.
Si vous êtes responsable d'un serveur esup-nfc-tag d'un établissement de l'ESR que vous souhaitez voir apparaître votre serveur esup-nfc-tag dans la liste des serveurs disponibles depuis cette version esup-nfc-tag-droid fournie sur le google play, vous pouvez en faire la demande au travers d'un Pull Request proposant la modification du listing des urls disponibles :
https://github.com/EsupPortail/esup-nfc-tag-droid/blob/master/src/main/assets/urls
Ce fichier est récupéré dynamiquement par esup-nfc-tag-droid à chaque démarrage, aussi dès que votre Pull Request est accepté, votre serveur esup-nfc-tag-server est disponible depuis un esup-nfc-tag-droid.
git clone https://github.com/EsupPortail/esup-nfc-tag-droid.git |
Si vous souhaitez proposer votre propre ESUP-NFC-TAG-DROID pointant directement sur votre serveur esup-nfc-tag, il vous faut construire votre propre APK.
Vous pouvez le faire de 3 manières :
En dehors d'android studio, la récupération du SDK d'Android peut se faire via le 'Android SDK tools package' en lignes de commandes.
https://developer.android.com/studio/#command-line-tools-only (dernier test en date depuis commandlinetools-linux-9123335_latest.zip )
On le télécharge et on le dézippe en tant qu'utilisateur (esup ici pour nous) qui se chargera de compiler/packager l'application android.
Le cmdline-tools est donc disponible ici : /home/esup/cmdline-tools
On installe mainetant le sdk d'android , level 28 :
[esup@carbonne bin]$ ./sdkmanager 'platforms;android-28' --sdk_root=/home/esup [esup@carbonne bin]$ ./sdkmanager 'build-tools;28.0.3' --sdk_root=/home/esup |
On accepte au passage la licence proposée.
Le SDK et outils associés ont ainsi été installés dans le home d'esup.
On pourra positionner ANDROID_HOME ainsi dans le .bashrc de l'utilisateur esup :
[esup@carbonne ~]$ echo 'export ANDROID_HOME=/home/esup' >> ~/.bashrc |
Si à la compilation (cf ci-dessous compilation via gradlew clean assemble), vous trouvez des erreurs types
java.io.IOException: Cannot run program "/home/esup/build-tools/22.0.1/aapt": error=2, Aucun fichier ou dossier de ce type |
Il vous manque sans doute des librairies.
En exécutant /home/esup/build-tools/22.0.1/aapt directement on voit quelle librairie il cherche.
Ensuite un
yum whatprovides 'libz.so.1' |
nous donne le paquet à installer avec yum install.
[root@carbonne ~]# yum install libstdc++* zlib* |
Des librairies 32 bits seront à installer notamment.
keytool -genkey -v -keystore esup-android-apps.keystore -alias LeoDroidApp -keyalg RSA -keysize 2048 -validity 10000 |
/home/esup/gradle-4.10.3/bin/gradle clean assemble |
cp ./build/outputs/apk/release/esup-nfc-tag-droid-release.apk /<path to>/esup-nfc-tag-server/src/main/resources/apk/esupnfctagdroid.apk |