Basisregistratie Ondergrond (BRO) Testen verbinding webservices met SoapUI Booronderzoek Datum 28 maart 2017 Status Versie 1.0
Testen verbinding webservice met SoapUI Booronderzoek Dit document beschrijft hoe een dataleverancier of dataafnemer de verbinding met de webservice van de BRO kan testen. Deze test wordt uitgevoerd met SoapUI, waarover in paragraaf A.1 meer geschreven wordt. In de paragrafen A.2 en A.3 staat vervolgens beschreven hoe de test uitgevoerd moet worden: met een PKIoverheid Services Server testcertificaat (A.2) of met een gebruikersnaam/wachtwoord combinatie (A.3). Hierbij gaat het specifiek om het aansluiten op de webservices voor Booronderzoek. A.1 SoapUI Het testen van de verbinding met de webservice van de BRO wordt in de volgende paragraaf uitgewerkt door gebruik te maken van SoapUI. SoapUI is een Java-applicatie. Voor zowel Linux als Windows en OS X zijn opensource installaties beschikbaar via www.soapui.org. Om 256bit encryptie in Java te ondersteunen moeten twee files in de Java installatie worden vervangen. Download de "Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files" voor de Java versie die u gebruikt. Deze kunt u vinden op de Java SE website: http://www.oracle.com/technetwork/java/javase/downloads/jce 8-download-2133166.html. Ga naar de <JAVA_HOME>\lib\security directory en vervang de bestaande files local_policy.jar en US_export_policy.jar door de versies in de gedownloade zipfile. Als Java separaat is geïnstalleerd kan de <JAVA_HOME> directory worden gevonden in een cmdbox met het commando java version. Is de Java JRE met SoapUI mee geïnstalleerd dan zijn de files te vinden in <SOAP-UI INSTALLATIE DIR>\jre\lib\security. Zijn voor SoapUI niet de goede JCE libraries geïnstalleerd, dan verschijnt de volgende foutmelding zodra verbinding gemaakt wordt met de ketentest- of inregelomgeving: Error getting response; javax.net.ssl.sslhandshakeexception: Received fatal alert: handshake_failure
A.2 Testen webservices met PKIoverheid Services Server testcertificaat In de uitleg die nu volgt, wordt de dataleverancier of dataafnemer als test aangesloten op de webservice van de Uitgifte Service Booronderzoek met een PKIoverheid Services Server testcertificaat. Deze instructie is ook van toepassing op de inname webservice maar dan met een ander url.! Heeft de dataleverancier of data-afnemer nog geen PKIoverheid Services Server testcertificaat, dan is het niet mogelijk om onderstaande stappen uit te voeren. Ga naar A.3 om met een gebruikersnaam/wachtwoord combinatie de webservice te testen. Maak voor het testen van de BRO webservices binnen SoapUI via [File New Workspace] een nieuwe workspace aan. Om vervolgens de webservice te kunnen benaderen moet het aangeschafte PKIoverheid Services Server testcertificaat gekoppeld worden aan SoapUI. Open hiervoor via [File Preferences] de tab [SSL settings]. Gebruik als KeyStore het <myserver>.p12 bestand. Gebruik als KeyStore Password het bijbehorende password. Zet tot slot een vinkje bij Client Authentication en sluit de dialoog met de ok button. Pagina 4 van 8
Maak nu binnen de aangemaakte workspace een nieuw SoapUI project aan. Open hiervoor via [File New SOAP project] de benodigde dialoog. Gebruik als Inital WSDL de locatie van de WSDL Uitgifte Services Booronderzoek. De url staat op het inlegvel (zie inlegvel, punt D) dat hoort bij Handleiding voor aansluiten op webservices. Na het sluiten van de dialoog met de ok button zal het WSDL bestand en de daaraan gekoppelde XSD bestanden worden opgehaald en op basis van hun inhoud worden request templates aangemaakt voor alle functies van de gekozen webservice. Open nu het Request1 window van de dispatchobject service en vervang bij <ns:broid> het vraagteken met de waarde BHR000000003785. Druk op het run icon linksboven in het Request window (zie volgende afbeelding). SoapUI zal Pagina 5 van 8
vervolgens het request naar de webservice van de BRO sturen, waarna het antwoord in het rechter venster verschijnt. A.3 Testen webservices met gebruikersnaam/wachtwoord combinatie Voor dataleveranciers en data-afnemers die nog geen PKIoverheid Services Server testcertificaat hebben, is het ook mogelijk om met een gebruikersnaam/wachtwoord combinatie de verbinding met de webservice te testen. Maak voor het testen van de BRO webservices binnen SoapUI via [File New Workspace] een nieuwe workspace aan. Maak nu binnen de aangemaakte workspace een nieuw SoapUI project aan. Open hiervoor via [File New SOAP project] de benodigde dialoog. Gebruik als Inital WSDL de locatie van de WSDL Uitgifte Services Booronderzoek. De url staat op het inlegvel (zie inlegvel, punt D) dat hoort bij Handleiding voor aansluiten op webservices. Pagina 6 van 8
Na het sluiten van de dialoog met de ok button zal het WSDL bestand en de daaraan gekoppelde XSD files worden opgehaald en op basis van hun inhoud worden request templates aangemaakt voor alle functies van de gekozen webservice. Er kan gelijk begonnen worden met het doen van een uitgifteverzoek. Open nu in het Request1 window van de dispatchobject service en vul bij Username en Password het verstrekte gebruikersnaam/wachtwoord in. Daarna vervang bij <ns:broid> het vraagteken met de waarde BHR000000003785. Druk op het run icon linksboven in het Request window (zie volgende afbeelding). SoapUI zal Pagina 7 van 8
vervolgens het request naar de webservice van de BRO sturen, waarna het antwoord in het rechter venster verschijnt. Pagina 8 van 8