Info |
---|
Documentation en partie obsolète, merci de vous référer à ESUP-SGC-Client et édition des cartes |
Sommaire |
---|
esup-sgc-client correspond au client esup-sgc/esup-nfc-tag permettant après
- après impression de la carte
...
- l'enrolement de la carte physique électronique dans esup-sgc (via lecture du CSN)
- l'encodage de la carte, gra?e grâce à esup-nfc-tag et éventuellement grâce à esupà esup-cnous-client (pour les cartes non pré-encodées crous/izly)
...
- https://github.com/EsupPortail/esup-sgc-client/releases/tag/esupsgcclient-v2.0 (Encodage manuel)
- https://github.com/EsupPortail/esup-sgc-client/releases/tag/esupsgcclient-r2d2-v2.0 (Encodage via le robot ZXP3)
...
- )
...
Info |
---|
Il est nécessaire d'utiliser une version 2.2 (ou supérieur) d'Esup-NFC-TAG-Server pour faire fonctionner le client 2.0 |
Le lancement par jnlp nous permettait de passer les paramètres d'encodage à l'application (notamment le numéro Id du périphérique et les urls d'esup-sgc et esup-nfc-tag). Avec la nouvelle application on récupère maintenant un jar que l'on peut lancer directement. Au passage, l'application n'a plus besoin d'être signée. L'établissement qui met en place cette nouvelle application doit par contre la packagée elle-même, ce pour pouvoir y renseigner les urls esup-sgc et esup-nfc-tag de ses propres serveurs.La nouvelle application -client demande une connexion shibboleth via une webview intégrée (identique à l'application mobile) et utilise un localstorage pour stocker les informations nécessaires.
...
Avertissement |
---|
Pour que le client Esup-Sgc-Client voit l'application d’écriture SGC configurée dans Esup-NFC-TAG-Server, il faut que l'option "Visible" soit cochée dans l'interface d'Esup-NFC-TAG-Server. |
ESUP-SGC-CLIENT
Fonctionnalités
- L'application lit le QR code imprimé sur la carte à encoder qui correspond à l'identifiant du futur propriétaire de la carte.
- Demande la sélection dans esup-sgc de l'individu à encoder
- L'application récupéré les commandes à exécuter sur la carte via esup-nfc-tag-server
- Validation de l'encodage et activation de la carte
- Éventuellement encodage de l'application CROUS ( voir https://www.esup-portail.org/wiki/display/SGC/FAQ#FAQ-Peut-onencoderl'applicationCROUSquandonutilisedescartesvierges?)
Environnement
Logiciel
- L'application fonctionne sous java avec JavaFX.
- L'application fonctionne sur Linux ou Windows 10 64bits (l'encodage CROUS necessite Windows 10 64bits)
- pour l'encodage de l'application CROUS le pilote OMNIKEY CardMan 6121 (pilote) (voir ESUP-CNOUS-CLIENT)
Materiel
L'application nécessite :
- une webcam gérant la résolution VGA (640x480)
- un lecteur de carte compatible PC/SC
- pour l'encodage de l'application CROUS il faut connecter la clé SAM OMNIKEY CardMan 6121 avec sa carte sim
...
La webcam est placée pour filmer le lecteur de carte (procéder à la mise au point si besoin). Lorsqu'une carte est posée sur le lecteur de carte, la webcam détecte le QR code et la procédure d'encodage démarre
Documentation de mise en œuvre ESUP-SGC / ESUP-NFC-TAG#SGC/ESUP-NFC-TAG-Installationmaterielle
Installation
Le plus rapide est de récupérer le jar esup-sgc-client et/ou l'installateur windows depuis https://esup-sgc-client-web-installer.univ-rouen.fr/
Vous pouvez le packager/builder vous même également cependant, cf ci-dessous.
Sources :
https://github.com/EsupPortail/esup-sgc-client.git
Bloc de code | ||||
---|---|---|---|---|
| ||||
git clone https://github.com/EsupPortail/esup-sgc-client.git git checkout -b esupsgcclient-univ-ville esupsgcclient-v2.13 |
Paramétrage
Il faut modifier le fichier src/main/resources/esupsgcclient.properties pour y mettre vos adresses esup-nfc-tag-server et esup-sgc et activer ou non l'encodage CNOUS
Bloc de code | ||||
---|---|---|---|---|
| ||||
esupSgcUrl = https://esup-sgc.univ-ville.fr
esupNfcTagServerUrl = https://esup-nfc-tag.univ-ville.fr
encodeCnous = false
localStorageDir = /AppData/Local/EsupSgcClient/ |
Compilation esup-sgc-client
Dans le dossier esup-sgc-client executer :
Bloc de code | ||||
---|---|---|---|---|
| ||||
mvn clean package |
Pour disposer du jar au sein du site ESUP-SGC :
Copier le fichier esupsgcclientesup-2.1sgc-jarclient-with-dependenciesfinal.jar (répertoire target) en le renommant esupsgcclient-shib.jar dans la webapp esup-sgc ou dans vos sources sous src/main/webapp/ avant de compiler esup-sgc
pour le client zxp3 le fichier (esupsgcclient-**-jar-with-dependencies.jar) doit être renommé esupsgcclient-r2d2-shib.jar.
Lancement
Si vous utilisez l'installateur windows, vous n'avez qu'à lancer le client depuis le raccourci créé par celui-ci, l'installateur embarque directement une distribution d'un openjdk et openjfx !proposés par la communauté Zulu !
Vous pouvez aussi utilise openJDK fourni depuis Sinon, sur vos postes, nous recommandons l'usage d'openJDK https://jdk.java.net et openJFX openJFX fourni depuis https://gluonhq.com/products/javafx/ (voir également https://openjfx.io/openjfx-docs/ ) qui sont des produits opensource et gratuits .également.
esup-sgc-client est compatible avec les JDK 9 et supérieurs. Depuis juin 2022, l'installateur windows embarque les versions JDK/JFX 18 packagées par Zulu (les dernières en date).
Suivant l'intégration de JAVAFX, la La commande à lancer est la suivante :
Bloc de code | ||||
---|---|---|---|---|
| ||||
java. exe exe --module-path %PATH_TO_FX% --add-modules javafx.controls,javafx.fxml,javafx.base,javafx.media,javafx.graphics,javafx.swing,javafx.web -Dcom.sun.webkit.useHTTP2Loader=false -jar esupsgcclient-shib.jar |
L'option "-Dcom.sun.webkit.useHTTP2Loader=false" donnée ici à titre indicatif permet de forcer l'usage de HTTP 1 et peut permettre d'éviter d'éventuels problèmes avec des serveurs web (apache) un peu anciens.
Précisions
Les installations d'openJDK et OpenJFX correspondent à dézipper leurs archives dans un répertoire donné.
...
En plaçant le JAR d'esup-sg-client (esupsgcclient-shib.jar) dans ce même répertoire C:\esup-sgc-client on peut ainsi finalement exécuter le JAR ainsi :
Bloc de codeinfo | ||
---|---|---|
| ||
C:\esup-sgc-client\jdk-12.0.1\bin\java.exe --module-path C:\esup-sgc-client\javafx-sdk-12.0.1\lib --add-modules javafx.controls,javafx.fxml,javafx.base,javafx.media,javafx.graphics,javafx.swing,javafx.web -jar C:\esup-sgc-client\esupsgcclient-shib.jar |
Si vous utilisez cette commande au travers d'un raccourci windows (pour faciliter son usage c'est une bonne idée, et c'est ce que propose l'installateur windows que vous pouvez générer depuis https://esup-sgc-client-web-installer.univ-rouen.fr), n'oubliez pas également de préciser le répertoire d'exécution comme étant également C:\esup-sgc-client.
A l'exécution ce client esup-sgc-client esupsgcclient-shib.jar écrit en effet 2 fichiers dans le répertoire courant :
- un fichier de logs pour éventuellement tracer les actions/infos/erreurs
- un fichier contenant un jeton d'authentification permettant à l'utilisateur d'éviter de devoir resssisir ses identifiants à chaque lancement de l'application.
ESUP-SGC-CLIENT-ZXP3
Esup-sgc-client-zxp3 est l'application permettant d'encoder les cartes Mifare Desfire dans le cadre du Système de gestion de carte Esup-sgc. Elle est identique à Esup-sgc-client mais elle utilise une imprimante Zebra ZXP3 pour automatiser l'encodage.
Environnement
Logiciel
- OS Windows 10 64bits (L'application devrait pouvoir tourner sous Linux si l'encodeur SDI010 est bien reconnu)
- L'application est prévue pour tourner sur du java 8 . Elle est lancée en JWS il faudra donc autoriser l'application qui va demander tous les droits sur la machine cliente.avec javafx (le SDK de Zebra requiert un JDK8 et n'est donc pas compatible avec un JDK11 par exemple). La version du JDK 8 d'Oracle embarque javafx et fonctionne, mais suite au changement de license côté Oracle, il faudrait maintenant s'acquitter d'une license pour un usage en production. Aussi le mieux ici est de prendre la version d'OpenJdk avec OpenJFX de communauté Zulu Nous en gardons une copie ici : zulu8.44.0.13-ca-fx-jdk8.0.242-win_x64.zip
- Le pilote Zebra ZXP3
- Le pilote PCSC SDI010
- Le SDK Zebra LinkOs
- Pour permettre l'encodage CNOUS il faut utiliser une machine windows 64bits pour lancer le client et il faut avoir installé l'application CNOUS Espu-sgc-cnous (voir ESUP-CNOUS-CLIENT)
Materiel
L'application nécessite :
...
La webcam est placée dans l'imprimante (qui reste ouverte) pour filmer le lecteur de carte. Il faut donc placer quelque chose dans le capteur de fermeture du couvercle. voir : https://www.esup-portail.org/wiki/pages/viewpage.action?pageId=613384398
Reglage offset lecteur sans contact à 0
Via les outils du driver (sous windows "Propiétés de l'imprimante > Device Settings > Tools > Command to send to printer") lancer la commande : +OS 0
réponse : 0 <ACK>
Installation
Sources : https://github.com/EsupPortail/esup-sgc-client/tree/univ-rouen-robot-zxp3
Bloc de code | ||||
---|---|---|---|---|
| ||||
git clone https://github.com/EsupPortail/esup-sgc-client.git git checkout -b esupsgcclient-r2d2-v2.0 esupsgcclient-r2d2-v2.0 |
Compilation Maven
Installation des dépendances ZSDK_API et ZSDK_CARD_API
Pour communiquer avec la Zebra ZXP3 esup-sgc-client-zxp3 utilise le SDK Zebra. Pour fonctionner il est installé en tant que depot maven local.
Le sdk se récupère à cette adresse : https://www.zebra.com/fr/fr/products/software/barcode-printers/link-os/link-os-sdk.html
Après l'installation du mpsdk-installer il faut , vous pouvez ainsi récupérer et copier les deux jar présents dans le dossier link_os_sdk/PC-Card/v2.12.3968/lib :
- ZSDK_API.jar, renomé ZSDK_API-2.12.3968.jar, dans le dossier src/lib/com/zebra/sdk/comm/ZSDK_API/2.12.3968/
- ZSDK_CARD_API.jar, renomé ZSDK_CARD_API-2.12.3968.jar, dans le dossier src/lib/com/zebra/sdk/common/card/ZSDK_CARD_API/2.12.3968/
Pour la compilation avec maven, copier tout le dosier com situé dans src/lib dans le dossier ~/.m2/repository
Il faut, de plus, copier les dll ZebraNativeUsbAdapter_32.dll et ZebraNativeUsbAdapter_64.dll dans c:\Windows\System32 et c:\Windows\SysWOW64 du poste client
documentation du SDK : http://techdocs.zebra.com/link-os/2-12/
Compilation / paramétrage esup-sgc-client-zxp3
Voir Configuration / paramétrage
ESUP-CNOUS-CLIENT
voir la FAQ : FAQ
L'application esup-cnous-client permet la lecture et l'encodage de l'application CNOUS sur une carte préalablement configurée (application desfire F58540 déjà présente)
Fonctionalitées
- CreationCarteCrous.exe ou CreationCarteCrous.exe -h : affiche l'aide
- CreationCarteCrous.exe -t : contrôle de l'application. Retourne true si tout est OK
- CreationCarteCrous.exe -l : lit l'application CNOUS de la carte présente sur le lecteur
- CreationCarteCrous.exe -e XXXXXXXXXXX : encode l'application CNOUS avec le numéro passé en paramètre (le numéro doit comporter 15 caractères)
Environnement
Matériel
- un lecteur de carte compatible PC/SC
- une clé SAM OMNIKEY CardMan 6121 (l'application utilise automatiquement la clé de type 6121 comme clé SAM et l'autre lecteur de carte comme encodeur)
Logiciel
- un environnement windows 64bits
- le framework .net 2 minimum
Installation
Pour un fonctionnement avec le client esup-sgc-client, l’exécutable doit être copié dans le dossier c:\cnousApi du poste sur lequel sera lancé l'encodage. De plus, l'application nécessite la présence de 4 librairies dans ce même dossier:
- cnous_fournisseur_carte.dll (à demander auprès du CNOUS)
- libeay32.dll (openssl)
- libssl32.dll (openssl)
- pcsc_desfire.dll (springcard)
la version de la dll cnous doit etre x64
Sources : https://github.com/EsupPortail/esup-crous-client
Bloc de code | ||
---|---|---|
| ||
git clone https://github.com/EsupPortail/esup-crous-client.git |
Compilation
Compilation maven
Depuis le répertoire source on lance :
Bloc de code | ||||
---|---|---|---|---|
| ||||
mvn package |
Vous pouvez alors renommer target/esupsgcclient-r2d2-2.1-SNAPSHOT-jar-with-dependencies.jar en esupsgcclient-r2d2-shib.jar.
Lancement depuis un poste windows
Sur le poste client il vous faut également indiquer dans le path le répertoire link_os_sdk/PC-Card/v2.12.3968/lib en plus du répertoire bin de votre JDK+JFX Zulu - voir copié d'écran :
Avec JDK+JFX Zulu, et en valuant ainsi votre PATH, vous n'avez plus qu'à lancer le jar ainsi :
Bloc de code | ||||
---|---|---|---|---|
| ||||
java -jar esupsgcclient-r2d2-shib.jar |
Note : documentation du SDK : http://techdocs.zebra.com/link-os/2-12/Pour compiler la solution il suffit de télécharger la dernière version de Visual Studio Community (https://www.visualstudio.com/fr/downloads/) ainsi que le framework .net version > 2