Application de lecture de carte SESAM-Vitale Jeebop Présentation Le module de lecture de carte SESAM-Vitale Jeebop est une application Java Web Start, c'est à dire une application Java qui se télécharge et s'installe sur le poste client en cliquant simplement sur un lien externe de type JNLP. Lors du premier clic sur le lien, l'application JWS s'installe, lors des clics suivants, elle se lance (du cache du navigateur). Les données SESAM-Vitale lues sont transmises de façon sécurisée vers un serveur HTTPS paramétrable (pré-renseigné). Cette application existe pour les systèmes Windows et Mac OS X. A l'installation, cette application installe les librairies CPS nécessaires à la lecture de la carte SESAM-Vitale, puis ouvre un dialogue de configuration permettant à l'utilisateur (le professionnel de santé en l occurrence) de renseigner un certain nombre de paramètres (nom, prénom, identifiant etc...). Ces paramètres sont envoyés au serveur HTTPS en même temps que les données de la carte SESAM-Vitale. Il est également possible de faire passer à l'application des paramètres par la page JNLP. Utilisation Au lancement de l'application, la fenêtre suivante apparaît : En cliquant sur le bouton Config, le dialogue suivant apparaît :
URL serveur est l'adresse où sont envoyées les données lues de la carte SESAM-Vitale. La valeur est renseignée par le serveur d'où l'application a été téléchargée. Si cet URL est protégé par une authentification, il faut renseigner le Nom d'utilisateur et le Mot de passe ici. Les données Nom, Prénom, Identifiant interne et Code établissement sont des données permettant au serveur d'identifier d'où vient l'appel. Elles sont transmises au serveur. Une fois tous les paramètres correctement renseignés, il faut tester la connexion en cliquant sur le bouton Tester ; le dialogue suivant apparaît alors : Notez que le texte affiché (HTML) provient du serveur contacté. Lorsqu'on clique sur le bouton Lecture, la carte SESAM-Vitale insérée dans le lecteur est lue. Si l'option «Utiliser la carte CPS» est cochée, un dialogue demandant la saisie du code porteur est présenté. Si le code saisi est vide, l'opération est annulée. Dans le cas contraire, le code est enregistré dans l'application, et s'il est vérifié ne sera plus demandé. A la fin de la lecture de la carte Vitale, les personnes en carte sont affichées :
Les touches flèche haut et bas permettent de se déplacer dans la liste, la touche Escape à la même action que le bouton Fermer, la touche Enter à la même action que le bouton Envoyer. Un clic sur l'icône Information en haut à droite permet d'afficher un dialogue contenant des informations sur le logiciel. La première personne en carte (le porteur de carte) est toujours sélectionné par défaut. Si l'option -sb est passée au JNLP (voir plus bas Options du fichier JNLP) un bouton Sauver apparaît, qui permet de sauver les informations de la carte en local dans un fichier XML. Si l'option -hs est passée au JNLP (voir plus bas Options du fichier JNLP) le bouton Envoyer n'est pas affiché, l'application ne permet alors seulement que de sauver les données de la carte en local. En cliquant sur le bouton Envoyer, les données de la carte SESAM-Vitale sont envoyées au serveur. En retour, le dialogue suivant s'affiche :
Notez qu'ici encore il s'agit du message renvoyé par le serveur qui s'affiche. Mode One screen En passant à l'application (par le fichier JNLP) le paramètre -1s, l'application s'exécute en mode one screen, c'est à dire qu'à son lancement, le premier écran est sauté, l'application lit directement la carte SESAM-Vitale présente dans le lecteur (et qui doit donc être introduite avant le lancement de l'application). Le premier écran qui s'affiche est donc la liste des personnes en carte. Le bouton «Envoyer» procède à l'envoi des données, puis le programme se termine sans afficher la réponse du serveur. En cas d'erreur, un dialogue est affiché et l'application se termine sur clic du bouton OK. Mode Two screen En passant à l'application le paramètre -2s, l'application s'exécute en mode two screen, c'est à dire qu'à son lancement, le premier écran est sauté, l'application lit directement la carte SESAM-Vitale présente dans le lecteur (et qui doit donc être introduite avant le lancement de l'application). Le premier écran qui s'affiche est donc la liste des personnes en carte. Le bouton «Envoyer» procède à l'envoi des données, puis le programme affiche la réponse du serveur. En cas d'erreur, un dialogue est affiché et l'application se termine sur clic du bouton OK. Technique Les données sont envoyées au serveur HTTPS sous forme d'un message XML contenant un objet <header>, et un objet <testconnection> s'il s'agit d'un test de connexion, ou <vitaledata> s'il s'agit d'un envoi de données. En-tête L'en-tête transmise est de la forme : <header> <system> <os> <name>windows 7</name> <arch>amd64</arch> <version>6.1</version> </os> <java> <jvm-name>java HotSpot(TM) 64-Bit Server VM</jvm-name> <version>1.7.0_03</version> <home>c:\program Files\Java\jre7</home> </java> <home>d:\sesam-vitale</home> </system> <nom>livingstone</nom> <prenom>david</prenom> <identifiant>0506123j</identifiant> <etablissement>wrp</etablissement> </header> L'élément <system> permet d'obtenir des informations sur la partie installée. L'option -sys doit être
passé à l'application pour que cet élément soit ajouté au <header> (voir plus bas Options du fichier JNLP) Données transmises Les données transmises sont de la forme : <choixpersonneencarte>1</choixpersonneencarte> <inscvitale> <element> <nomusuel>dupont</nomusuel> <nompatronymique>tatayer</nompatronymique> <prenomusuel>jean</prenomusuel> <datenaissance>500801</datenaissance> <nir>1500815051040 18</nir> <insc>1541187387477485562488</insc> </element> </inscvitale> <vitaledata><![cdata[<?xml version="1.0" encoding="iso-8859-1"? ><t_asndonneesvitale><listebenef><element><ident><nomusuel>dupont</nomusuel><nom Patronymique>TATAYER </nompatronymique><prenomusuel>jean</prenomusuel><naissance><dateencarte>500801< /dateencarte></naissance><nir>1500815051040 18</nir><adresse><ligne1>APPARTEMENT 1 BATIMENT GRAVIER</ligne1><ligne2>RESIDENCE DES PLATANES</ligne2><ligne3>CHEMIN DES BOIS DE LA FORET DOC</ligne3><ligne4>PLUCVAILLON</ligne4><ligne5>72650 LA CHAPELLE SAINT AUBIN</ligne5></adresse><rangDeNaissance>1</rangDeNaissance></ident><amo><qualBe nef>0</qualbenef><coderegime>10</coderegime><caisse>000</caisse><centregestion>0 009</centreGestion><codeGestion>10</codeGestion><centreCarte>0000</centreCarte>< listeperiodesdroits><element><debut>15081990</debut></element></listeperiodesdro its><service><codeservice>00</codeservice></service><medecintraitant>i </tech></t_asndonneesvitale> ]]></vitaledata> L'élément <choixpersonneencarte> correspond à la personne en carte choisie. L'élément <vitaledata> correspond à la totalité des informations lues de la carte SESAM- Vitale telles que décrites par le XSD cvitale.xsd. L'élément <inscvitale> correspond aux données lue de la carte SESAM-Vitale qui ont servie à calculer l'insc (et qu'on retrouve évidemment dans l'élément <vitaledata>) Options du fichier JNLP -license <license> : la licence fournie par Wraptor Laboratories. Sans ce paramètre, l'application ne pourra fonctionner. -url <url> : l'url du serveur où doivent être envoyées les données lues de la carte. Du type : https://nom_machine:8043/chemin/servlet. Notez que si la licence concerne un seul serveur, le nom de la machine sera remplacé par le serveur correspondant. -home <dir> : permet de forcer l'installation du programme dans le dossier spécifié -nc : ne propose pas d'installer les CryptoLibs lors de l'installation -title <titre> : permet de redéfinir le titre de la fenêtre de l'application. -1s : passe l'application en mode one screen -2s : passe en mode two screen
-cps : coche par défaut la case «Utiliser la carte CPS» -sb : affiche le bouton permettant de sauver en local les données lues de la carte Vitale -localdir : permet de définir le répertoire local où seront sauvés les fichiers -localfilename : permet de définir le nom de fichier unique où seront sauvés les données. -svo : Sauve dans le fichier uniquement les données de la carte Vitale (tag XML <t_asndonneesvitale>) -hs : cache le bouton «Envoyer» -hc : cache le bouton de configuration (si les modes one screen ou two screen ne sont pas activés) -sys : ajoute des informations relatives à la plate-forme dans le ficher XML envoyé -st : cache le bouton de configuration, mais affiche à la place le bouton de test -uninstall : désinstalle l'application -p <libellé=valeur> : permet de passer des paramètres à l'application qui seront transmis lors de l'envoi au serveur, dans le header du flux XML Ces options doivent être passées à l'application par la page JNLP. Voici un exemple de fichier JNLP : <?xml version="1.0" encoding="utf-8"?> <jnlp spec="1.6+" codebase="http://www.jeebop.com/sesam-vitale/" href="/sesam-vitale/windows.jnlp"> <security> <all-permissions/> </security> <resources> <j2se version="1.6+" java-vm-args="-xnoclassgc"/> <jar href="lib/jeebop-vitale-win.jar"/> </resources> <application-desc main-class="jeebop.tools.vitalereader"> <argument>-license</argument> <argument>xxxyyyzzz</argument> <argument>-url</argument> <argument>https://localhost:8043/sesam-vitale/xml</argument> <argument>-2s</argument> <argument>-p</argument> <argument>tokenid=76543298</argument> </application-desc> <information> <title>jeebop Vitale Reader for Windows</title> <vendor>wraptor Laboratories</vendor> <description>lit les cartes SESAM-Vitale et les transmet à un serveur sécurisé</description> <description kind="short">lecteur de carte Jeebop SESAM-Vitale</description>
<icon kind="splash" href="images/splash.jpg"/> <offline-allowed/> <shortcut online="false"> <desktop/> <menu submenu="wraptor Laboratories"/> </shortcut> </information> </jnlp> Servlet de traitement Si les données sont à envoyer à un serveur Jeebop, il faut mettre en place l'application WEB (servlet) de réception des données. Les applications web sont situées dans repository/tomcat/webapps. Vous pouvez définir par exemple une application sesam-vitale qui permettra d'accéder aux pages JNLP, ainsi que de définir le servlet de traitement des données. La livraison Jeebop contient une classe servlet de traitement qui sauve les données reçus dans un fichier au format XML, dans un dossier paramétrable par les paramètres du servlet. Exemple de fichier de configuration du servlet (web.xml) : <web-app> <display-name>reception de donnees SESAM-Vitale</display-name> <servlet> <servlet-name>sesamvitaleservlet</servlet-name> <servlet-class>jeebop.tools.sesamvitaleservlet</servlet-class> <load-on-startup>1</load-on-startup> <param-name>charset</param-name> <param-value>iso-8859-1</param-value> <param-name>debug</param-name> <param-value>true</param-value> <param-name>savefile</param-name> <param-value>true</param-value> <param-name>formatxml</param-name> <param-value>true</param-value>
<param-name>savetwofiles</param-name> <param-value>false</param-value> <param-name>savedir</param-name> <param-value>${jeebop.home}${/}svdata</param-value> <param-name>nomsite</param-name> <param-value>jeebop SESAM-Vitale</param-value> </servlet> <servlet-mapping> <servlet-name>sesamvitaleservlet</servlet-name> <url-pattern>/xml/*</url-pattern> </servlet-mapping> </web-app> Les paramètres supportés sont : charset (String, par défaut "UTF-8") : le jeux de caractères utilisé ack (String) : nom d'un fichier contenant les informations à renvoyer à l'application savefile (boolean, par défaut true) : si true, les données transmises sont sauvées dans un fichier formatxml (boolean, par défaut true) : si savefile à true, la chaine XML reçue est formattée savetwofiles (boolean, par défaut false) : si mis à troue, deux fichiers seront créés : data_xxx.xml (contenant l'en-tête et le choix de la personne en carte) et VITALEdata_xxx.xml (contenant les données de la carte Vitale, formatées) savedir (String, par défaut "${jeebop.home}${/}svdata") : si savefile à true, le nom du dossier dans lequel sont écrit les fichiers XML reçus debug (boolean) : permet de positionner des traces dans le servlet nomsite (String, par défaut "Jeebop") : nom du site de l'application pong (boolean) : si true, les données transmises sont renvoyées à l'application (mode de test)