...
Le QR-Code européen consiste en une url dans laquelle on retrouve l'url d'accès au serveur ESC http://esc.gg/ suivi d'un numéro de carte 'ESCN' qui est un identifiant codé en hexadécimal, formaté pour une meilleur lecture avec des - supplémentaires.
Exemple : d88b02c1-894e-1038-a711-001999465982
Cet ESCN est construit pour être unique, ESUP-SGC utilise directement la librairie escn-generator disponible depuis les repositories centraux de maven (le code source y est également donné) : https://search.maven.org/artifact/eu.europeanstudentcard/escn-generator
Cet identifiant de carte est construit via l'heure système suffixé d'un code qui correspond au pic de l'établissement lui-même préfixé par un numéro supplémentaire.
Dans l'exemple de d88b02c1-894e-1038-a711-001999465982 on retrouve ainsi le code pic 999465982 de l'Université de Rouen Normandie.
On note que la "version" hexadecimal correspond à d88b02c1894e1038a711001999465982, soit une chaîne hexadecimale de 16 octets.
...
On active l'utilisation du QR-Code européen (en lieu de l'usage de l'EPPN en tant que QR-Code) en allant dans l'interface web, "Admin" > "Configurations" > "QRCODE_ESC_ENABLED" que l'on doit mettre à true.
...
Pour proposer à certains "userType" (populations) d'utilisateurs d'activer leur carte dans ESCR, il faut renseigner le paramètre DISPLAY_FORM_EUROPEAN_CARD dans l'interface web, "Admin" > "Configurations".
Le paramètre ENABLE_EUROPEAN_CARD permet quant à lui de sélectionner les userType pour lesquels on active par défaut la carte dans ESCR.
Générer un token d'API
- Se connecter sur https://router.europeanstudentcard.eu
- Sélectionner "Organisations" sur le menu de gauche
- Dans le tableau qui s'affiche, cliquez sur l'icône "oeil"
- Dans le tableau API tokens, cliquer sur "+ ADD", nommez-le ("esup-sgc" par exemple) et mettez une date lointaine, sauf si vous souhaitez le changer régulièrement
- Le token s'affiche une seule fois, reportez le dans la configuration du bean europeanStudentCardService (key)