Guide de l`application cliente des Web Services de

Spécifications Fonctionnelles Détaillées
Guide de l’application cliente des Web Services de l’Annuaire Santé
Identification du document
Référence
Annuaire_sante_fr_Guide_App_Cliente_WebServices_V1.1.5.docx
Date de création
15/05/2013
Date de dernière mise à jour
04/12/2013
Etat
Validé
Version
V1.1.5
Classification
Confidentiel - Non public
Nombre de pages
21
Historique du document
Version
Date
Auteur
Commentaires
V0.0.1
15/05/13
ASIP Santé
Initialisation du document
V1.0.0
28/06/13
ASIP Santé
Version pour diffusion

Guide application cliente – Webservices de consultation du repertoire annuaire.sante.fr 17/12/13
Classification : public 2 / 21
Documents de référence
Référence
Descriptif
[ref 1] Annuaire_sante_fr_DSFT_WebServices_Consultation
Dossier des spécifications Fonctionnelles et techniques
des Webservices du repertoire annuaire.santé.fr
[ref 2] NAS-Ressources terminologiques utilisées par le RASS
NAS - Ressources terminologiques associées aux
données publiées par le répertoire annuaire.sante.fr
[ref.3 ] CI-SIS : EVOLUTION DU VIHF : PROFIL POUR ANNUAIRE DE
PROFESSIONNEL DE SANTÉ
CI-SIS : Evolution du VIHF : profil pour annuaire de
professionnel de santé

Guide application cliente – Webservices de consultation du repertoire annuaire.sante.fr 17/12/13
Classification : public 3 / 21
Sommaire
1. Introduction ..................................................................................................................... 4
1.1 Objet du document ..................................................................................................................... 4
1.2 Documents relatifs ...................................................................................................................... 4
1.3 Fonctions implémentées ............................................................................................................. 4
1.4 Avertissement ............................................................................................................................. 4
2. Application cliente ............................................................................................................ 5
2.1 Contenu....................................................................................................................................... 5
2.2 Description des sources .............................................................................................................. 5
2.2.1 Dossier src/main/java .................................................................................................... 5
2.2.2 Dossier src/main/resources ........................................................................................... 7
2.2.3 Dossier src/test/java ...................................................................................................... 7
2.2.4 Dossier src/test/resources ............................................................................................. 8
2.3 Description détaillée des classes ................................................................................................ 8
2.3.1 Dossier src/main/java .................................................................................................... 8
2.3.2 Dossier src/test/java .................................................................................................... 11
2.4 Configuration de l’application cliente ....................................................................................... 12
2.4.1 Fichier de configuration ............................................................................................... 12
2.4.2 Authentification ........................................................................................................... 13
2.4.3 Utilisation derrière un proxy ........................................................................................ 14
3. Principes de fonctionnement .......................................................................................... 14
3.1 Connexion sécurisée TLS mutuelle ........................................................................................... 14
3.2 Authentification directe (carte CPS) ......................................................................................... 15
3.2.1 Extraction des informations de la carte CPS ................................................................ 15
3.2.2 Signature des données avec la carte CPS ..................................................................... 15
3.3 Authentification indirecte (certificats établissement) .............................................................. 16
3.3.1 Obtenir l’accès aux méthodes du certificat PKCS12 .................................................... 16
3.4 Jeton VIHF ................................................................................................................................. 16
3.4.1 Structure du jeton VIHF................................................................................................ 16
3.4.2 Construction du jeton VIHF .......................................................................................... 16
4. Installation de l’application cliente ................................................................................. 18
4.1 Prérequis ................................................................................................................................... 18
4.2 Installation ................................................................................................................................ 18
4.3 Remarques ................................................................................................................................ 19
4.4 Configuration de l’application cliente ....................................................................................... 19
4.5 Exécution des tests ................................................................................................................... 19
5. Tests avec SoapUI ........................................................................................................... 21

Guide application cliente – Webservices de consultation du repertoire annuaire.sante.fr 17/12/13
Classification : public 4 / 21
1. Introduction
1.1 Objet du document
La lecture des spécifications des contrats d’interfaces des Web Services permettant la consultation
des données rattachées aux personnes morales et physiques de l’Annuaire Santé, est un prérequis à
la compréhension de l’application cliente.
1.2 Documents relatifs
 Dossier de spécifications fonctionnelles et techniques détaillées des Web Services de
consultation.
 Cadre d’interopérabilité des SIS (Volet Synchrone pour Client Lourd).
1.3 Fonctions implémentées
Les principales fonctions implémentées par l’application cliente sont :
 Authentification par carte ou par certificat serveur ;
 Génération d’un jeton VIHF ;
 Etablissement d’une connexion sécurisée TLS ;
 Génération des requêtes Soap des clients des quatre web services de consultation des
données des personnes physiques et des personnes morales :
1. Client du Web Service de recherche de personnes physiques ;
2. Client du Web Service de consultation des données d’une ou de plusieurs personnes
physiques ;
3. Client du Web service de recherche de personnes morales ;
4. Client du Web Service de consultation des données d’une ou de plusieurs personnes
morales.
1.4 Avertissement
Les codes sources sont fournis « tels quels », sans support.
L’attention du partenaire est appelée sur les modalités d’utilisation du code exemple.
Ce dernier est fourni à titre d’information permettant au partenaire de réaliser librement
l’adaptation personnalisée nécessaire à la création de l’interfaçage de son logiciel.
L’ASIP Santé en garantit la pertinence intrinsèque mais pas l’utilisation in situ chez le partenaire.
Le partenaire est seul responsable des bonnes conditions de son utilisation et libre de s’inspirer des
éléments fournis et de les adapter par ses propres moyens à la situation particulière de la solution
logicielle qu’il développe.
Ainsi notamment, il est déconseillé de procéder par voie de copier-coller du code à partir des
exemples fournis.
L’ASIP Santé décline toute responsabilité en cas de mauvaise mise en œuvre du code exemple.

Guide application cliente – Webservices de consultation du repertoire annuaire.sante.fr 17/12/13
Classification : public 5 / 21
2. Application cliente
2.1 Contenu
L’application cliente est livrée sous forme d’archive au format zip : annuaire-sante-webservices-client-
<version>-src.zip, contenant un projet Java configuré sous l’IDE Eclipse. L’archive décompressée
donne lieu au dossier annuaire-sante-webservices-client-<version>, dont le contenu est le suivant :
Dossier
Description
.settings
Dossier de configuration du projet Eclipse
Certificates
Dossier contenant les certificats P12 et les keystore
d’authentification
repo
Dossier contenant une structure de repository Maven propre au
projet pour embarquer le jar client des Web Services de
consultation annuaire-sante-wsclient-<version>.jar, ce dernier
contient les fichiers WSDL et XSD des Web Services
src/main/java
Dossier contenant les sources des classes java
src/main/resources
Dossier contenant les ressources utiles à l’exécution des classes de
l’application cliente (fichiers de configurations, keystores,...)
src/test/java
Dossier contenant les sources des classes java des tests JUnit des
services (permet l’exécution des web-services)
src/test/resources
Dossier contenant les ressources utiles à l’exécution des classes de
test (fichiers de test, ...)
.classpath
Fichier de configuration du classpath du projet Eclipse
.project
Fichier de configuration principal du projet Eclipse
pom.xml
Fichier de configuration Maven pour le projet
assembly.xml
Fichier de configuration de l’assemblage des sources pour Maven
2.2 Description des sources
L’application cliente contient les packages suivants :
2.2.1 Dossier src/main/java
Ce dossier est le dossier source principal de l’application cliente. Il contient les packages suivants :
2.2.1.1 Package fr.sante.annuaire.webservices.client.authentification
Ce package contient la classe de service d'appel au gestionnaire du jeton VIHF et de la connexion TLS.