Aansluiten: verschil tussen versies
(Nieuwe pagina aangemaakt met 'Koppelen =Technische vereisten= Het kunnen versturen en ontvangen van berichten via SOAP 1.1 en het kunnen communiceren over een met SSL beveiligde verbinding zijn...') |
(→Stappenplan koppelen) |
||
| Regel 5: | Regel 5: | ||
Het voor SSL benodigde server certificaat is bij voorkeur gesigneerd door een officiële CA (Certificate Authority). | Het voor SSL benodigde server certificaat is bij voorkeur gesigneerd door een officiële CA (Certificate Authority). | ||
=Stappenplan koppelen= | =Stappenplan koppelen= | ||
| − | Het beheer van DSP ondersteunt deelnemers bij het tot stand brengen van een koppeling. | + | Het beheer van DSP ondersteunt deelnemers bij het tot stand brengen van een koppeling. |
| − | Uitgangspunten implementatie bespreken met beheer. | + | Het onderstaande stappenplan wordt als leidraad gebruikt en benoemt de te doorlopen stappen om te kunnen koppelen met het DSP. |
| − | Hoofdlijnen planning en eventuele fasering. | + | Sommige stappen zijn optioneel, deze zijn als dusdanig kenbaar gemaakt en het is aan de deelnemer om te bepalen en aan te geven welke stappen we met elkaar zullen doorlopen. |
| − | + | <br> | |
| − | + | <br> | |
| − | + | '''Beginfase''' | |
| − | Gewenste | + | <br> |
| − | Gewenste | + | In deze fase hebben we in eerste instantie overleg met elkaar over de mogelijkheden en tijdslijnen. |
| − | Technische | + | <br> |
| − | + | # Uitgangspunten implementatie bespreken met beheer. | |
| − | + | #:- Hierbij bespreken we welke ambities/doelen u heeft en hoe het DSP u daarbij kan helpen. | |
| − | + | # Hoofdlijnen planning en eventuele fasering. | |
| − | + | #:- We stemmen met elkaar af welke omgeving u wilt koppelen met het DSP en welke tijdslijnen u daarbij voor ogen heeft. | |
| − | + | <br> | |
| − | + | '''Informatiefase''' | |
| − | + | <br> | |
| − | + | In eerste instantie zullen we met elkaar de benodigde informatie uitwisselen om zo aan beide zeiden de configuratie van de end points op orde te kunnen maken. | |
| − | + | <br> | |
| − | + | * De basis informatie om aan te sluiten kunt u terugvinden in onze [[Hoofdpagina|Wiki]]. | |
| − | + | * Wij ontvangen graag de volgende informatie van u: | |
| − | + | *:- Gewenste manier van bijlage uitwisselen: via [https://en.wikipedia.org/wiki/SOAP_with_Attachments SOAP with Attachments (SwA)] of via [https://nl.wikipedia.org/wiki/Message_Transmission_Optimization_Mechanism Message Transmission Optimization Mechanism (MTOM)] | |
| − | + | *:- Gewenste organisatienaam: ten behoeven van de waardelijsten aangaande de netbeheerders en aannemers. | |
| − | + | *:- Technische gegevens van de omgevingen en systemen: | |
| − | + | *::* IP-adressen en poort nummers (uw outbound en inbound IP-adressen t.b.v. whitelisting) per omgeving. | |
| + | *::* Indien niet extern beschikbaar: uw server certificaat. | ||
| + | *::* Gewenste manier van authenticeren: Basic ''of'' Certificate. | ||
| + | *:::- In het geval van Certificate authenticatie, graag het client certificaat meesturen met deze informatie. | ||
| + | *::* Uw end points voor de verschillende berichttypen. | ||
| + | * U mag de volgende informatie van ons verwachten: | ||
| + | *:- Technische bestanden (XSD's en WSDL's) van de te implementeren berichtversie. | ||
| + | *:- IP-adressen en poortnummers van onze omgevingen. | ||
| + | *:- End points voor de verschillende berichttypen. | ||
| + | *:- Ons client certificaat indien u die wilt gebruiken voor de authenticatie. | ||
| + | *::* En anders krijgt u van ons de benodigde credentials t.b.v. de methode Basic authenticatie. | ||
| + | <br> | ||
| + | '''Oplevering-/testfase''' | ||
| + | <br> | ||
| + | Tijdens deze fase kan er, afhankelijk van de planning en de omgevingen waaraan gekoppeld wordt worden gestart met het uitvoeren van de eerste testen in de vorm van connectiviteitstesten. | ||
| + | Zorg er svp voor dat de volgende checks zijn uitgevoerd (per omgeving): | ||
| + | * Firewall aanpassingen voor binnenkomend en uitgaand verkeer van en naar de betreffende omgeving van het DSP zijn doorgevoerd. | ||
| + | * Eventuele ontbrekende CA-certificaten zijn ge-implementeerd in de benodigde key stores. | ||
| + | * Controleer of uw end points, die u eerder aan ons heeft doorgegeven, nog overeenkomen met de end points die gebruikt worden door het DSP om berichten bij u af te leveren. | ||
| + | <br> | ||
| + | Functioneel Beheer is uw eerste aanspreekpunt voor vragen en opmerkingen die betrekking hebben op de connectiviteitstesten. | ||
| + | <br> | ||
| + | Indien gewenst kan er een gezamenlijk testmoment worden afgestemd om te goede werking van de koppelingen te valideren. | ||
| + | <br> | ||
| + | Wanneer de connectiviteitstesten succesvol zijn gebleken en eventuele technische obstakels zijn weggenomen, staat het u vrij om ketentesten uit te voeren met ketenpartners die ook zijn gekoppeld met het DSP. | ||
| + | |||
=Web service responses= | =Web service responses= | ||
Na het verwerken van een bericht door een deelnemer of het DSP wordt een synchrone respons (ontvangst bevestiging of SOAPFault bij fouten in verwerking) verstuurd. | Na het verwerken van een bericht door een deelnemer of het DSP wordt een synchrone respons (ontvangst bevestiging of SOAPFault bij fouten in verwerking) verstuurd. | ||
Versie van 19 sep 2018 om 10:14
Koppelen
Technische vereisten
Het kunnen versturen en ontvangen van berichten via SOAP 1.1 en het kunnen communiceren over een met SSL beveiligde verbinding zijn vereist om via Webservices berichten uit te kunnen wisselen met het DSP. Hierbij wordt het gebruik van een servicebus aangeraden, maar is niet verplicht. Voor het uitwisselen van bijlagen ondersteund het DSP zowel MTOM als SwA (SOAP with Attachments). Het voor SSL benodigde server certificaat is bij voorkeur gesigneerd door een officiële CA (Certificate Authority).
Stappenplan koppelen
Het beheer van DSP ondersteunt deelnemers bij het tot stand brengen van een koppeling.
Het onderstaande stappenplan wordt als leidraad gebruikt en benoemt de te doorlopen stappen om te kunnen koppelen met het DSP.
Sommige stappen zijn optioneel, deze zijn als dusdanig kenbaar gemaakt en het is aan de deelnemer om te bepalen en aan te geven welke stappen we met elkaar zullen doorlopen.
Beginfase
In deze fase hebben we in eerste instantie overleg met elkaar over de mogelijkheden en tijdslijnen.
- Uitgangspunten implementatie bespreken met beheer.
- - Hierbij bespreken we welke ambities/doelen u heeft en hoe het DSP u daarbij kan helpen.
- Hoofdlijnen planning en eventuele fasering.
- - We stemmen met elkaar af welke omgeving u wilt koppelen met het DSP en welke tijdslijnen u daarbij voor ogen heeft.
Informatiefase
In eerste instantie zullen we met elkaar de benodigde informatie uitwisselen om zo aan beide zeiden de configuratie van de end points op orde te kunnen maken.
- De basis informatie om aan te sluiten kunt u terugvinden in onze Wiki.
- Wij ontvangen graag de volgende informatie van u:
- - Gewenste manier van bijlage uitwisselen: via SOAP with Attachments (SwA) of via Message Transmission Optimization Mechanism (MTOM)
- - Gewenste organisatienaam: ten behoeven van de waardelijsten aangaande de netbeheerders en aannemers.
- - Technische gegevens van de omgevingen en systemen:
- IP-adressen en poort nummers (uw outbound en inbound IP-adressen t.b.v. whitelisting) per omgeving.
- Indien niet extern beschikbaar: uw server certificaat.
- Gewenste manier van authenticeren: Basic of Certificate.
- - In het geval van Certificate authenticatie, graag het client certificaat meesturen met deze informatie.
- Uw end points voor de verschillende berichttypen.
- U mag de volgende informatie van ons verwachten:
- - Technische bestanden (XSD's en WSDL's) van de te implementeren berichtversie.
- - IP-adressen en poortnummers van onze omgevingen.
- - End points voor de verschillende berichttypen.
- - Ons client certificaat indien u die wilt gebruiken voor de authenticatie.
- En anders krijgt u van ons de benodigde credentials t.b.v. de methode Basic authenticatie.
Oplevering-/testfase
Tijdens deze fase kan er, afhankelijk van de planning en de omgevingen waaraan gekoppeld wordt worden gestart met het uitvoeren van de eerste testen in de vorm van connectiviteitstesten.
Zorg er svp voor dat de volgende checks zijn uitgevoerd (per omgeving):
- Firewall aanpassingen voor binnenkomend en uitgaand verkeer van en naar de betreffende omgeving van het DSP zijn doorgevoerd.
- Eventuele ontbrekende CA-certificaten zijn ge-implementeerd in de benodigde key stores.
- Controleer of uw end points, die u eerder aan ons heeft doorgegeven, nog overeenkomen met de end points die gebruikt worden door het DSP om berichten bij u af te leveren.
Functioneel Beheer is uw eerste aanspreekpunt voor vragen en opmerkingen die betrekking hebben op de connectiviteitstesten.
Indien gewenst kan er een gezamenlijk testmoment worden afgestemd om te goede werking van de koppelingen te valideren.
Wanneer de connectiviteitstesten succesvol zijn gebleken en eventuele technische obstakels zijn weggenomen, staat het u vrij om ketentesten uit te voeren met ketenpartners die ook zijn gekoppeld met het DSP.
Web service responses
Na het verwerken van een bericht door een deelnemer of het DSP wordt een synchrone respons (ontvangst bevestiging of SOAPFault bij fouten in verwerking) verstuurd. Zie Synchrone respons op ontvangen berichten voor meer informatie.
Gebruik SoapUI
SoapUI is een handig hulpmiddel bij het koppelen aan het DSP. Met dit programma kunnen deelnemers berichten die vanuit het eigen systeem worden gegenereerd toetsen t.o.v. de XSD’s. Ook biedt SoapUI de mogelijkheid om de interactie met het DSP/Aannemer/Netbeheerder te simuleren. Het ontvangen van een bericht van DSP in het eigen systeem kan worden gesimuleerd door het bericht te versturen vanuit SoapUI. Het verzenden van een bericht naar DSP kan worden gesimuleerd door het bericht te ontvangen in SoapUI middels een mockservice. Meer informatie over SoapUI is te vinden op: SoapUI - Getting Started
