======SOAPUI======

[[http://www.soapui.org/|SOAPUI]] est une interface graphique écrite à Java permettant de faire des tests sur des webservices.

=====Exemple d'utilisation : EJBCA=====

   * Exécuter SOAPUI
   * Cliquer sur le menu File, puis **New WSDL Project**
   * Définir le nom du projet (par exemple : EJBCA)
   * Spécifier l'URL du fichier WSDL  [[http://<adresseIP>:8080/ejbca/ejbcaws/ejbcaws?wdsl]]
   * Vérifier que la case à cocher **Create sample requests for all operations** soit bien cochée
   * Cliquer sur le bouton **OK**

SOAPUI va alors récupérer le fichier WSDL, le parser, puis générer une requête d'exemple pour chaque méthode décrite par le fichier WSDL.

{:documentation:soapui-1.png}}

=====Modification du endpoint et chargement d'un keyStore=====

====Modification du point de service====

L'appel aux webservices EJBCA étant sécurisé (SSLv3 avec authentification client) il est nécessaire de modifier le endpoint (URL à utilisée pour l'appel aux méthodes) du WS. Pour cela, double cliquer sur l'entrée **EjbcaWSPortBinding** de la fenêtre de gauche, puis cliquer sur l'onglet **Service Endpoints**. Modifier l'entrée existant pour passer de [[http://<hostname>:8080]] à [[https://<hostname>:8443]].

{{:documentation:soapui-2.png}}

====Chargement du keystore====

Cliquer maintenant sur l'entrée **File** du menu de SOAPUI, puis **Preferences**, et finalement sur l'onglet **SSL Settings**. Cliquer maintenant sur le bouton **Browse** et charger le fichier PKCS#12 de l'administrateur EJBCA (superadmin.p12 par exemple) puis spécifier le champ **KeyStore Password**.

{{:documentation:soapui-3.png}}

=====Appel de la méthode editUser=====

Cliquer maintenant sur l'entrée **editUser** de l'arbre, puis sur **Request 1**, ouvrant une nouvelle fenêtre. Définir la requête de la manière suivante :

<code xml>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.protocol.core.ejbca.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:editUser>
         <!--Optional:-->
         <arg0>
            <caName>NewUI</caName>
            <certificateProfileName>ENDUSER</certificateProfileName>
            <clearPwd>true</clearPwd>
            <email>bbonfils@linagora.com</email>
            <endEntityProfileName>EMPTY</endEntityProfileName>
            <keyRecoverable>true</keyRecoverable>
            <password>foo123</password>
            <sendNotification>false</sendNotification>
            <status>10</status>
            <subjectDN>cn=Demo</subjectDN>
            <tokenType>P12</tokenType>
            <username>demo</username>
         </arg0>
      </ws:editUser>
   </soapenv:Body>
</soapenv:Envelope>
</code>

Puis cliquer sur le bouton vert représentant un bouton de lecture, si tout est ok devrait fractionner la fenêtre pour obtenir le résultat suivant :

{{:documentation:soapui-4.png}}


Auteur : Bruno Bonfils