GEBRUIKERSHANDLEIDING KNOOPPUNTDIENSTEN BERICHTUITWISSELING VIA WEBSERVICE

Transcriptie

1 GEBRUIKERSHANDLEIDING KNOOPPUNTDIENSTEN BERICHTUITWISSELING VIA WEBSERVICE AANVRAGEN EN INSTALLATIE CPA Versie 1.0 Datum Mei 2016 Auteur Communicatie Inlichtingenbureau

2 Aansluiting op Digikoppeling..1 Wat is een CPA?... 1 Benodigd voor aanvragen en installatie CPA 2 Stappen CPA aanvragen via portaal... 2 Testen CPA met test berichtuitwisseling... 7 CPA test profiel uitzetten

3 Aansluiten op Digikoppeling Om berichten uit te wisselen via webservice heeft u een Digikoppeling aansluiting nodig en een Digikoppeling adapter. Daarnaast moeten de uit te wisselen berichten (bv ijw, iwmo en/of PGB) voldoen aan de standaarden en moet uw applicatie leverancier een release installeren die webservices ondersteunt. Voor het inrichten van de Digikoppeling-infrastructuur dient connectiviteit te worden gerealiseerd met de Compliancy-voorziening. Daarnaast moet de Digikoppeling-software geïnstalleerd en geconfigureerd worden binnen de ICT-infrastructuur van uw gemeente. Digikoppeling kan zowel over Internet als over Diginetwerk plaatsvinden. Diginetwerk is een afsprakenstelsel voor het koppelen van besloten netwerken van de overheid. Via deze gekoppelde netwerken kunnen overheidsorganisaties onderling gegevens uitwisselen. Door het besloten karakter is Diginetwerk een veiliger alternatief dan het open internet voor het uitwisselen van gegevens tussen overheidsorganisaties. U maakt gebruik van het afsprakenstelsel Diginetwerk door aan te sluiten bij één van de besloten gekoppelde (overheids)netwerken. Uw softwareleverancier kan u helpen met het inrichten van Digikoppeling. Meer informatie over Digikoppeling en Diginetwerk vindt u op de website van Logius: Wat is een CPA? Om berichten uit te kunnen wisselen via Digikoppeling dient er aan de kant van de gemeente een CPA geïmporteerd te worden. Deze moet u eerst aanvragen via het GGK portaal. CPA (Collaboration Protocol Agreement) is een soort contract in een XML-bestand om een Digikoppeling adapter te configureren voor berichtenverkeer met een specifieke partner; in dit geval met stichting RINIS. In een CPA staan de gegevens van de partijen die met elkaar een verbindingscontract aangaan en beveiligd berichten gaan uitwisselen (in dit geval een gemeente enerzijds en RINIS anderzijds). De CPA bevat informatie over de partijen zoals de te hanteren afleveradressen (end-points), OIN nummers (overheidsidentificatienummer), publieke gedeelten van PKI-certificaten, etc. Deze CPA dient door beide partijen op hun Digikoppeling ebms-adapter (versie 2.0) geïmporteerd te worden, zodat de adapter weet met welke partij(en) er uitgewisseld kan worden en wat er uitgewisseld mag worden. 3

4 Benodigd voor aanvragen en installatie CPA 1. Aansluiting op internet of Diginetwerk 2. Digikoppeling adapter en digikoppeling aansluiting (raadpleeg uw Digikoppeling leverancier) 3. eherkenning (tenminste niveau EH3) + mobiele telefoon (zie handleiding inloggen op het portaal knooppuntdiensten) 4. Rechten als productbeheerder (deze rechten kan uw gebruikersbeheerder toekennen) 5. De gegevens benodigd voor de CPA aanvraag, zie tabel 2. (Uw Digikoppeling leverancier kan u helpen bij het achterhalen van de exacte gegevens) Stappen CPA aanvragen via portaal Indien voorgenoemde gegevens bekend zijn, kunt u via het GGK portaal de CPA aanvragen. (zie figuur 1). Doorloop de onderstaande stappen; voor eventuele ondersteuning kunt u het beste uw softwareleverancier raadplegen. 1. De productbeheerder logt in het GGK portaal in. (Zie handleiding gebruikersbeheerder) 2. Selecteer in het rechter menu de pagina CPA Beheer. 3. Vul alle velden om een CPA aan te vragen (zie tabel 2 voor aanvullende informatie over de velden) 4. Klik op opslaan. De opgeslagen gegevens worden doorgestuurd aan RINIS. Wanneer RINIS de CPA heeft gegenereerd, wordt deze zichtbaar in het portaal. Gemiddeld kan dit tot 1 uur duren. 5. Tenminste één uur na de aanvraag van de CPA, logt de productbeheerder wederom in in het GGK portaal 6. Selecteer in het rechter menu de pagina CPA Beheer 7. Download onderaan de pagina bij Download CPA, de gegenereerde CPA. (zie figuur 3) 8. Installeer de gedownloade CPA in de Digikoppeling adapter. 9. Om de verbinding tussen RINIS en de gemeenten te testen moet er een Ping Pong test worden uitgevoerd. De gemeente moet hiervoor een bericht (Ping) aan RINIS versturen; dit betreft een ebms-ping, dit bericht is onderdeel van de Digikoppeling standaard. Als de verbinding goed staat ingesteld zal de gemeente van RINIS een Pong terug krijgen. Dit alles gaat in een fractie van een seconde. (Mocht deze Ping Pong test niet slagen, kunt u het beste contact opnemen met: beheer@rinis.nl of via ) 10. Het Inlichtingenbureau activeert na een geslaagde Ping Pong test de CPA in het portaal handmatig. De CPA is daarna zichtbaar op de routeerpagina in het portaal bij het betreffende product. Gemiddeld kan dit tot 2 uur duren. 4

5 Figuur 1: CPA Beheer 5

6 Tabel 2: In te vullen velden Profielnaam: Overheidsidentificatienummer (OIN)/ Handelsregisternummer (HRN) Ingangsdatum: Einddatum: Connectietype: URL van de service die het bericht kan ontvangen (Endpoint): Source IP: Geef een herkenbare naam aan het CPA profiel (bijvoorbeeld: Gemeentenaam en productnaam -> Test Gemeente iwmo). OIN nummer van uw gemeente. Voor bedrijven en privaatrechtelijke organisaties die niet in aanmerking komen voor een OIN, is dit het HRN die wordt uitgegeven bij de aanvraag van een PKI certificaat Activatiedatum van het certificaat. Einde geldigheid certificaat. Diginetwerk of Internet (Diginetwerk heeft de voorkeur). Adres van het endpoint waar de berichten op afgeleverd moeten worden. Geef alle IP-adressen die behoren bij het Endpoint. Dit geldt zowel voor de inkomende als uitgaande IP-adressen. LET OP: Alleen connecties vanaf deze IPadressen worden toegestaan. IP-adressen kunnen komma gescheiden worden ingevoerd of met behulp van de CIDRnotatie. Server certificaat: Public key van het servercertificaat (Base 64 gecodeerd). Het betreft de Base64 encoded inhoud van het certificaat. Kopieer van het certificaat van "-----BEGIN CERTIFICATE-----" tot "-----END CERTIFICATE-----" in het scherm. Let op dat er geen laatste lege regel of spatie wordt mee gekopieerd! Client certificaat: Public key van het client certificaat. Het betreft de Base64 encoded inhoud van het certificaat. Kopieer van het certificaat van "- ----BEGIN CERTIFICATE-----" tot "-----END CERTIFICATE-----" in het scherm. Let op dat er geen laatste lege regel of spatie wordt mee gekopieerd! 6

7 Figuur 3: Download CPA Testen CPA met test berichtuitwisseling Voordat de CPA wordt gekoppeld aan een berichtuitwisseling, kan de CPA gekoppeld worden aan een test berichtuitwisseling. Om zo dicht mogelijk bij de werkelijkheid te blijven, wordt er getest met de aangevraagde CPA die ook voor de reguliere berichtuitwisseling wordt gebruikt. Koppel op het tabblad Routeren de CPA aan de TEST-uitwisseling (zie figuur 4). Daarnaast moet ook in de kolom Uitwisseling via de optie Digikoppeling worden geselecteerd. Klik vervolgens op opslaan. Let op! Indien de CPA getest gaat worden, kan de CPA niet gekoppeld zijn aan een al in gebruik zijnde berichtuitwisseling, zoals bv WMO 301/302. Zodra de instellingen zijn verwerkt, krijgt de routering de status Actief. Dit duurt maximaal 1 uur. Raadpleeg regelmatig het tabblad routeren om te kijken of de status is gewijzigd. Wanneer de status is gewijzigd van connectietest geslaagd naar Actief, kan de berichtuitwisseling plaatsvinden. 7

8 Om te testen stuurt u een valide WMO of JW 301 bericht via webservice. Onderstaande tabel toont met welke berichtcode het retourbericht in de eigen applicatie wordt getoond. Verstuurd bericht door gemeente WMO 301 JW 301 Retourbericht TEST-WMO TEST-JW Wanneer een retourbericht is ontvangen in de eigen applicatie met berichtcode TEST WMO of TEST JW is de test geslaagd. U dient nu nog het CPA test profiel uit te zetten (zie hieronder) alvorens de CPA te kunnen instellen voor de daadwerkelijk uit te wisselen berichten. CPA test profiel uitzetten Op het tabblad routeren moet in de kolom Uitwisseling via bij de testuitwisseling via het drop down menu de keuze GEEN worden aangezet (figuur 4). Klik vervolgens op opslaan. Vanaf nu kan de CPA worden ingesteld via het tabblad Routeren voor de daadwerkelijke uit te wisselen berichten. Figuur 4: Testen berichtuitwisseling met CPA 8