Upload New File

482cdca1 · Dr. Tamas Molnar · 2823f905 · 482cdca1
Commit 482cdca1 authored 1 year ago by Dr. Tamas Molnar
--- a/Activity 1 - Enabling eCard Interoperability/Task 1.6 - Adapting feature sets from physical cards for the eCard App/Readme.md
+++ b/Activity 1 - Enabling eCard Interoperability/Task 1.6 - Adapting feature sets from physical cards for the eCard App/Readme.md
+
+# Technical requirements
+
+Java 11 (JDK 11)
+
+Maven
+
+Tomcat 8.5 and superior
+
+Postgres 12 and superior
+
+Reader : Any PC/SC with correct drivers
+
+LDAP or an another database (MySQL for exemple for the users)
+
+Apache shibboleth is required for a production intallation but as the authentication will not be used in a test environment, no need to configure any of this.
+
+These environment involves 3 blocks (+ the campus card app) :
+- the card management system : ESUP-SGC
+- the reader system : ESUP Nfc tag Server
+- the service where the reader is connected : ESUP NFC Tag desktop or ESUP NFC Tag keyboard or ESup-emargement
+
+# Installation
+
+Install Esup SGC solutions : Source provides for ESUP-SGC and Esup-nfc-tag-server 
+
+Follow the installation and configuration instructions.
+
+- [ESUP SGC wiki](https://www.esup-portail.org/wiki/pages/viewpage.action?pageId=612237478) *
+- [ESUP Nfc tag Server](https://www.esup-portail.org/wiki/display/ESUPNFC/ESUP-NFC-TAG-SERVER) *
+
+# Desfire Configuration
+
+## In esup-SGC :
+
+Add the configuration for the recognition of the app as a card service : here called for exemple si-service in src/main/resources/META-INF/spring/applicationContext-services.xml
+
+    <bean id="cardIdsService" class="org.esupportail.sgcs.cardid.CardIdsService">  
+	    <property name="cardIdServices">  
+		    <list>  
+			    <bean class="org.esupportail.sgcs.cardid.HCECardIdService">  
+				    <property name="appName" value="si-service"/>  
+	          <property name="postgresqlSequence" value="card_sequence"/-->  
+			    </bean>  
+		    </list>  
+	    </property>  
+    </bean>
+
+## In esup-nfc-tag-server :
+
+Add the test DESFIRE application configuration in the applicationContext-custom.xml (src/main/resources/META-INF/spring/applicationContext-custom.xml)
+
+    <bean id="desfireAuthEcarte" class="org.esupportail.nfctag.api.impl.DesfireReadConfig">  
+	    <property name="desfireKeyNumber" value="01"/>  
+	    <property name="desfireFileNumber" value="00"/>  
+	    <property name="desfireAppId" value="112233"/>  
+	    <property name="desfireIsoId" value="000185000076D2"/> <!--"000185000076D2"/-->  
+	    <property name="desfireAppName" value="si-service"/>  
+	    <property name="desfireFileOffset" value="000000"/> <!--10-->  
+	    <property name="desfireKey" value="FF112233445566778899AABBCCDDEEFF"/>  
+	    <property name="description" value="Authentification Desfire SI Service"/>  
+    </bean>
+
+In the applicationContext-desfire.xml
+
+
+    <bean class="org.esupportail.nfctag.beans.DesfireApplication" p:desfireAppId="112233" p:amks="0B" p:nok="83"> <!--p:isoId="000185000076D2" p:desfireAppId="112233"-->  
+	    <property name="files">  
+		    <util:list>  
+			    <bean class="org.esupportail.nfctag.beans.DesfireFile" p:fileNumber="00" p:communicationSettings="03" p:accessRights="1FFF" p:tagWriteApi-ref="eCardTagWriteEsupSgc"/>  
+			    <bean class="org.esupportail.nfctag.beans.DesfireFile" p:fileNumber="01" p:communicationSettings="03" p:accessRights="2FFF" p:tagWriteApi-ref="eCardTagWriteEsupSgc"/>  
+		    </util:list>  
+	    </property>  
+	    <property name="keys">  
+		    <util:list>  
+			    <bean class="org.esupportail.nfctag.beans.DesfireKey" p:keyNo="00" p:keyVer="01" p:key="FF112233445566778899AABBCCDDEEFF"/>  
+			    <bean class="org.esupportail.nfctag.beans.DesfireKey" p:keyNo="01" p:keyVer="01" p:key="FF112233445566778899AABBCCDDEEFF"/>  
+			    <bean class="org.esupportail.nfctag.beans.DesfireKey" p:keyNo="02" p:keyVer="01" p:key="FF112233445566778899AABBCCDDEEFF"/>  
+		    </util:list>  
+	    </property>  
+    </bean>
+
+
+Added a devRemoteUser="eppnOfTheChosenUser " in the src/main/resources/META-INF/spring/security.properties to by-pass authentication in a test environmnent.
+
+
+### Test the reading with the ESUP NFC reader system
+
+clone and install esup-nfc-tag-desktop ([https://github.com/EsupPortail/esup-nfc-tag-desktop](https://github.com/EsupPortail/esup-nfc-tag-desktop))
+
+Java FX is needed
+
+Follow the installation & configuration. (https://www.esup-portail.org/wiki/display/ESUPNFC/ESUP-NFC-TAG-DESKTOP *
+
+Most of all define the esup-nfc-tag instance url in src/main/resources/esupnfctag.properties
+    esupNfcTagServerUrl = https://hostnameOrIpToEsupNFCTagServer
+
+We make sure that the test DesfireKey is the same in the mobile app :
+
+FF112233445566778899AABBCCDDEEFF
+
+Connect the reader.
+
+Configure a Phone with the campuscardapp authenticated by any way you want ; the only requirement  is : the user has to be present in the esup SGC database or LDAP configured.
+
+Configure a test room to tag and tag with the test eCard app.
+
+<img src="screenshots/esupNFCtagReader.png" height="400">
+
+### Test the reading with the ESUP NFC keyboard Emulator
+
+clone and install https://www.esup-portail.org/wiki/display/ESUPNFC/ESUP-NFC-TAG-KEYBOARD *
+
+Sources : https://github.com/EsupPortail/esup-nfc-tag-keyboard
+
+Configure the properties in  src/main/resources/esupnfctagkeyboard.properties
+
+    port = 33333
+	esupNfcTagServerUrl = https://esup-nfc-tag-dev.normandie-univ.fr
+	noResponseMessage = -
+	numeroIds = keyboard-secondary-id, keyboard-csn, keyboard-eppn, keyboard-email
+	emulateKeyboard = true
+	forceCsn = false
+	lineFeed = true
+	redirect = false
+	redirectUrlTemplate = https://esup-sgc-dev.normandie-univ.fr/manager/{0}
+	prefix =
+	suffix  =
+	timeBetweenSameCard = 3000
+	cardReadSleepTime = 1000
+	onErrorSleepTime = 3000
+	beforeNextCardSleepTime = 1500
+
+
+### Test the reading with the ESUP attendencies app : 
+
+https://esup-emargement-dev.normandie-univ.fr/ (soon available)
+
+Specification : https://www.esup-portail.org/wiki/display/EMARGEMENT *
+
+sources : https://github.com/EsupPortail/esup-emargement
+
+
+ *\* use right click and trasnlate with your Chrome favorite language*
+
+
+
+## Important Note
+
+ You can test without installing the full system and use instead our instancies :
+
+https://esup-nfc-tag-dev.normandie-univ.fr and https://esup-sgc-dev.normandie-univ.fr
+
+Make sure you use the test user with this fields in the mobile app :
+
+ - lastname : Demo  
+ - surname : Robert 
+ -  birthday: 1982-02-28   
+ - LibraryId   : HUHS0123453
+
+## Milestone 1.5 and 1.6
+- Esup-SGC the french open source card management system with eCard comptibility
+- Esup-NFC Tag readers system compatibility with the eCard
+- Compatible services with esup-NFC-Tag : Library(esup nfc keaboard emulation), Culture pass (non open source app), Print (Papercut), Attendance list (Esup-Emargement)
+