dev/esup-nfc-tag-server
6
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
EsupNfcTagServer is the server part of the EsupNfcTag project https://www.esup-portail.org/wiki/display/ESUPNFC/
274 commits 8 branches 20 tags 16 MiB
Find a file
Exact
Vincent Bonamy 48cefda1b6 Màj librairies
2026-05-29 16:27:06 +02:00
src Debug creation base avec hibernate.hbm2ddl.auto à create 2026-05-29 16:25:47 +02:00
.gitignore First official commit 2016-07-20 14:57:10 +02:00
LICENSE First official commit 2016-07-20 14:57:10 +02:00
NOTICE esupNfcTagServer V2 (SNAPSHOT) 2017-09-15 15:38:21 +02:00
pom.xml Màj librairies 2026-05-29 16:27:06 +02:00
README.md README... 2025-09-02 14:25:03 +02:00

README.md

Esup NFC Tag Server - EsupPortail

Application permettant d'utiliser comme lecteur/borne de badge NFC :

Ce projet vise à permettre et faciliter le développement de services autour des cartes NFC dites "multiservice"

Il propose une architecture standardisée et connectée autour du badgeage d'une carte présentant un identifiant (CSN ou identifiant codé en Desfire AES) correspondant à une carte valide d'un individu connu du système d'information.

L'application EsupNfcTagServer, elle est développée en Spring et tourne sur Tomcat (ou Jetty).

Installation

Pré-requis

  • Java - JDK : OpenJDK 17-25 : le mieux est de l'installer via le système de paquets de votre linux.
  • Maven : le mieux est de l'installer via le système de paquets de votre linux.
  • Postgresql 9 ou > : le mieux est de l'installer via le système de paquets de votre linux.
  • Tomcat 10 ou Jetty (11 ou 12)
  • Apache + libapache2-mod-shib2 : https://services.renater.fr/federation/docs/installation/sp (ou équivalent)
  • Git

Configuration Apache Shibboleth

L'authentification repose sur Shibboleth. Apache doit être configuré pour faire du mod_shib (ou équivalent si vous optez pour une authentification cas, oidc, ....).

Une fois le SP Shibboleth et Apache configurés usuellement (voir : https://services.renater.fr/federation/docs/installation/sp), il faut sécuriser /manager et /nfc en ajoutant ceci à la conf apache (à adapter cependant en fonction des versions d'Apache et mod_shib) :

   <Location /manager>
     AuthType shibboleth
     ShibRequestSetting requireSession 1
     require shib-session
     ShibUseHeaders On
   </Location>

   <Location /nfc>
     AuthType shibboleth
     ShibRequestSetting requireSession 1
     require shib-session
     ShibUseHeaders On
   </Location>

Configuration PostgreSQL

  • pg_hba.conf : ajout de
host all all 127.0.0.1/32 password
  • redémarrage de postgresql
  • psql
create database esupnfctag;
create USER esupnfctag with password 'esup';
grant ALL ON DATABASE esupnfctag to esupnfctag;
ALTER DATABASE esupnfctag OWNER TO esupnfctag;

Paramétrage mémoire JVM :

Pensez à paramétrer les espaces mémoire JVM :

export JAVA_OPTS="-Xms1024m -Xmx1024m -XX:MaxPermSize=256m"

Pour maven :

export MAVEN_OPTS="-Xms1024m -Xmx1024m -XX:MaxPermSize=256m"

Recupération des sources

git clone https://github.com/EsupPortail/esup-nfc-tag-server

Obtention du war pour déploiement sur tomcat ou autre :

mvn clean package

Lancement de la mise à jour de la base de données

mvn exec:java -Dexec.args="dbupgrade"

Configuration

Voir la page wiki Esup : https://www.esup-portail.org/wiki/display/ESUPNFC/ESUP-NFC-TAG-SERVER