...
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 50228de1-8944-1038-a3d5-001999465982 on retrouve ainsi le code pic 999465982 de l'Université de Rouen Normandie.
On note que la "version" hexadecimal correspond à 50228de189441038a3d5001999465982, soit une chaîne hexadecimale de 16 octets.
ESUP-SGC ne propose pas cependant d'utiliser le QR-Code pour identifier la carte dans un usage courant après édition.
...
| Bloc de code |
|---|
<bean id="escUidFactoryService" class="org.esupportail.sgc.services.esc.EscUidFactoryService">
<property name="pic" value="le-code-pic-de-letablissement"/>
<property name="prefixe" value="1 " /> <!-- si plusieurs sgc, l'établissement doit les distinguer par un préfixe différent -->
<property name="qrCodeUrlPrefixe" value="http://esc.gg/" /> <!-- pour l'instance ESC de pre-production on mettra http://pp.esc.gg/ -->
</bean> |
...
Enregistrement d'une carte dans ESC-R
Présentation
Pour que la carte puisse être reconnue par un service d'un établissement européen partenaire, il faut que celui-ci puisse la récupérer techniquement depuis ESCR qui est la plateforme d'échange (le hub ou Router) des identifiants de cartes/étudiants du projet ESC.
Enregistrer une carte c'est donc enregistrer à la fois l'étudiant et la carte dans ESCR.
ESUP-SGC permet à ce que ce soit sur demande de l'étudiant que l'enregistrement ait lieu (RGPD). Ensuite, ESCR elle-même propose à l'étudiant de diffuser au cas par cas ses identifiants aux services des établissements partenaires.
L'identifiant de carte est l'ESCN.
L'identifiant de l'utilisateur est construit ainsi : code pays - code pic - code ine.
La connaissance de l'INE est donc obligatoire ici.
Mise en oeuvre
La configuration d'esup-sgc en tant que client ESCR pour enregistrer les cartes se fait dans src/main/resources/META-INF/spring/applicationContext-crous.xml
| Bloc de code |
|---|
<bean id="europeanStudentCardService" class="org.esupportail.sgc.services.esc.ApiEscrService">
<property name="enable" value="true"/>
<property name="webUrl" value="http://api.europeanstudentcard.eu/v1" />
<property name="key" value="clef-a-recuperer-auprès-d-escr" />
<property name="restTemplate" ref="restTemplate" />
<property name="countryCode" value="FR"/>
<property name="picInstitutionCode" value="le-code-pic-de-letablissement"/>
<!--
Type of cards. Possibles values are :
1 - passive card, with no electronic
2 - Smartcard without European common data zone
3 - Smartcard with European common data zone
4 - Smartcard on which application may be installed by service providers
-->
<property name="cardType" value="2"/>
</bean> |
Récupération d'une carte depuis ESC-R
...