Aansluiten op SOAP
U wilt aansluiten op een berichtstroom van Digipoort koppelvlak SOAP. Hieronder vindt u de verschillende stappen met informatie die u moet doorlopen.
Stap 1: aanvragen aansluiting op Digipoort
Vul het aanvraagformulier Digipoort SOAP in. Bent u een Authentication Service Provider (AuSP), vul dan het aanvraagformulier Digipoort SOAP voor AuSP in.
Door het ondertekenen van dit formulier accepteert u de gebruiksvoorwaarden van Digipoort SOAP.
Aanvraagformulier SOAP (PDF | 874 kB)
Aanvraagformulier SOAP voor AuSP (PDF | 874 kB)
Stap 2: implementatie van de koppelvlakspecificaties
Na uw aanvraag voor Digipoort kunt u beginnen met het implementeren van de koppelvlakspecificaties SOAP.
De factsheet preproductie-omgeving geeft een overzicht van de benodigde url's om aan te sluiten op de preproductie-omgeving.
De handleiding portaal beschrijft hoe u het portaal van Digipoort kan gebruiken. Dit portaal gebruikt u bij het aanleveren van berichten en het bekijken van statusinformatie en meldingen van aangeleverde berichten.
Handleiding Digipoort SOAP voor bedrijven (PDF | 113 kB)
Koppelvlakspecificaties SOAP (link naar interne pagina)
Factsheet preproductie-omgeving (PDF | 88 kB)
Handleiding portaal Digipoort (PDF | 380 kB)
Stap 3: aanvragen PKIoverheid-certificaat
Voor een productieaansluiting op Digipoort bent u verplicht gebruik te maken van een PKIoverheid-certificaat (X.509). Dit certificaat waarborgt de veiligheid en betrouwbaarheid van de verbinding tussen u en Digipoort. Let wel, het PKIoverheid-certificaat is alleen verplicht op de productie-omgeving. In de preproductie-omgeving is het ook mogelijk om gebruik te maken van self-signed certificaten.
U kunt een PKIoverheid-certificaat aanvragen via een CSP (Certificate Service Provider). Een overzicht van de huidige CSP's is te vinden op deze website onder PKIoverheid. Wegens de doorlooptijd van de aanvraag, adviseren wij u een PKIoverheid-certificaat vroegtijdig aan te vragen.
PKIoverheid en SHA256: nieuw beveiligingscertificaat
Sinds 1 januari 2011 moeten overheidswebsites PKIoverheid-certificaten met de SHA256-technologie gebruiken. Deze certificaten maken gebruik van een sterker algoritme om informatie te versleutelen. Meer informatie over PKIoverheid en SHA256 kunt u vinden onder PKIoverheid.
Stap 4: testen van uw verbinding
Na de implementatie van de koppelvlakspecificaties, kunt u zelf gaan testen of u berichten kunt versturen via de preproductie-omgeving (https://preprod.procesinfrastructuur.nl/). Gebruik bij deze test een PKIoverheid-certificaat, op basis van SHA256-versleuteling.
Op dit moment moet u contact opnemen met de servicedesk van de ontvangende overheidsorganisatie om gezamenlijk de berichtinhoud af te stemmen.
Stap 5: aansluiten op de productie-omgeving
Als de test uit stap vier naar tevredenheid is verlopen, kunt u aansluiten op de productie-omgeving van Digipoort.
De factsheet productie-omgeving geeft een overzicht van de benodigde url's om aan te sluiten op de productie-omgeving.
Factsheet productie-omgeving (PDF | 42 kB)
Stap 6: afspraken maken
Voordat u een bericht in productie verstuurt naarde overheidsorganisatie, moet u met hen contact opnemen. Zo weet de overheidsorganisatie dat er een bericht van u als nieuwe aanleverende partij onderweg is.
Meer informatie?
Heeft u vragen over het gehele aansluitproces, dan kunt u contact opnemen met Servicecentrum Logius. Vermeld hierbij duidelijk dat het gaat om een aansluiting op Digipoort koppelvlak SOAP voor bedrijven.
