...
En lieu et place d'une implémentation spécifique à réaliser par vous-même, notez que vous pouvez utiliser les implémentations TagIdCheckLdap (ou TagIdCheckSql) ou TagIdCheckSql permettant de récupérer ces informations de carte via une requête ou ldap ( ou une requête SQL.
En entrée, de ces TagIdCheck (TagIdCheckRestWs, TagIdCheckLdap ou TagIdCheckSql) le retour de badgeage tel que configuré est donnée : le cas simple est l'usage du CSN mais c'est également possible de récupérer un numéro de carte (ou donnée) récupéré depusi la lecture d'un fichier via chiffrement AES au travers du protocole Desfire.
Ces configurations pourront prendre place dans la fichier applicationContext-custom.xml - par défaut un exemple y est donnée pour TagIdCheckLdap.
TagIdCheckLdap
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<bean id="tagIdCheckApiLdapWithCsn" class="org.esupportail.nfctag.service.api.impl.TagIdCheckLdap">
<property name="searchFilter" value="supannRefId='{'ISO15693'}'{0}"/>
<property name="description" value="via LDAP ISO15693"/>
<property name="ldapServices">
<util:list>
<ref bean="ldapServiceUnivVille"/>
</util:list>
</property>
</bean> |
Si on reprend les recommandations SupAnn on pourra avoir :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<bean id="tagIdCheckApiLdapWithCsn" class="org.esupportail.nfctag.service.api.impl.TagIdCheckLdap">
<property name="searchFilter" value="supannCMSId;x-mifare-xlsb={0}"/>
<property name="description" value="via LDAP ISO15693"/>
<property name="ldapServices">
<util:list>
<ref bean="ldapServiceUnivVille"/>
<ref bean="ldapServiceUnivVille2"/>
</util:list>
</property>
</bean> |
Ici on a en plus configuré l'usage de plusieurs Ldap, dans le cadre où on voudrait proposer une application de badgeage multi-établissements disposant donc de plusieurs ldap.
ldapServiceUnivVille et ldapServiceUnivVille2 devant correspondre à des LdapService ainsi
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<bean id="ldapContextSourceUnivVille" class="org.springframework.ldap.core.support.LdapContextSource"> <property name="url" value="ldap://ldap.univ-ville.fr" /> <property name="base" value="dc=univ-ville,dc=fr" /> </bean> <bean id="ldapTemplateUnivVille" class="org.springframework.ldap.core.LdapTemplate"> <constructor-arg ref="ldapContextSourceUnivVille" /> </bean> <bean id="ldapServiceUnivVille" class="org.esupportail.nfctag.service.LdapService"> <property name="ldapTemplate" ref="ldapTemplateUnivVille" /> </bean> |
TagIdCheckSql
Pour cette implémentation, il est à noter que suivant que le badgeage consisite à lirte le CSN ou un fichier Desfire, le nom de la propriété portant la requête sql diffère.
Pour le CSN :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<bean id="tagIdCheckApiDonuts" class="org.esupportail.nfctag.service.api.impl.TagIdCheckSql">
<property name="dataSource" ref="maBaseSiDataSource" />
<property name="csnAuthSql" value="SELECT * FROM Carte WHERE csn=? AND statut=1" />
<property name="description" value="via la base du SI"/>
</bean> |
Pour le badgeage via un fichier d'une application Desfire :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<bean id="tagIdCheckApiDonuts" class="org.esupportail.nfctag.service.api.impl.TagIdCheckSql">
<property name="dataSource" ref="maBaseSiDataSource" />
<property name="desfireAuthSql" value="select * from EasyId where identifiantDesfireAppliEmargement=? and statut=1" />
<property name="description" value="via la base du SI"/>
</bean> |
maBaseSiDataSource correspondra à un javax.sql.DataSource défini via un org.springframework.jndi.JndiObjectFactoryBean ou plus simplement via un org.apache.commons.dbcp.BasicDataSource
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<bean class="org.apache.commons.dbcp.BasicDataSource"
destroy-method="close" id="dataSource">
<property name="driverClassName" value="${database.driverClassName}" />
<property name="url" value="${database.url}" />
<property name="username" value="${database.username}" />
<property name="password" value="${database.password}" />
<property name="testOnBorrow" value="true" />
<property name="testOnReturn" value="true" />
<property name="testWhileIdle" value="true" />
<property name="timeBetweenEvictionRunsMillis" value="1800000" />
<property name="numTestsPerEvictionRun" value="3" />
<property name="minEvictableIdleTimeMillis" value="1800000" />
<property name="validationQuery" value="SELECT version();" />
</bean> |
TagIdCheckRestWs
TagIdCheckRestWs En fait, TagIdCheckRestWs est utilisé lorsqu'on utilise esup-nfc-tag avec esup-sgc par exemple : esup-sgc implémente cette API TagIdCheckAPI TagIdCheck
Cette implémentation peut se faire dans le langage de votre choix, pour réaliser cette documentation nous nous basons ici sur une implémentation réalisée en Java (avec Spring MVC).
...
Pour ce faire il faut implémenter une fonction ou un webservice qui accepte en entrée un csn et/ou identifiant d'un fichier d'une application desfire et qui retourne un objet « TagLog » contenant à minima :
| Bloc de code | ||||
|---|---|---|---|---|
|
@JsonIgnoreProperties(ignoreUnknown=true) public class TagLogEsupNfcTagLog { String csn; String eppn; String lastname; String firstname; String location; } |
L'implémentation de "référence" d'eusp-sgc est donnée ici : https://github.com/EsupPortail/esup-sgc/blob/5cc2feb60725e091cde7e585bb21287a2fd076ec/src/main/java/org/esupportail/sgc/web/wsrest/WsRestEsupNfcController.java#L503C2-L529C3
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
@RequestMapping(value="/tagIdCheck", params={"csn"}, method=RequestMethod.GET, produces = "application/json;charset=UTF-8") @ResponseBody public EsupNfcTagLog tagIdCheck(@RequestParam String eppnInit; csn) { log.debug("tagIdCheck with csn = " + csn); EsupNfcTagLog esupNfcTagLog = null; Card card = null; try { card = Card.findCardsByCsn(csn).getSingleResult(); } catch(Exception e){ log.info("card not found ", e); } if(card!=null) { esupNfcTagLog = new EsupNfcTagLog(); esupNfcTagLog.setCsn(card.getCsn()); esupNfcTagLog.setEppn(card.getEppn()); esupNfcTagLog.setFirstname(card.getUser().getFirstname()); esupNfcTagLog.setLastname(card.getUser().getName()); log.info("tagIdCheck OK " + esupNfcTagLog); } else { log.info("tagIdCheck failed, " + csn + " not retrieved"); } return esupNfcTagLog; } |