Werkwijze koppelen bedrijfssysteem aan asbestvolgsysteem
Om het koppelvlak van LAVS te gebruiken, doorloopt de gebruiker een aantal stappen.
Productie-omgeving
Allereerst moet de gebruiker aantonen dat er succesvol gekoppeld is met de bedrijvenacceptatieomgeving (b-acc) van het LAVS. U moet hiervoor een eHerkenning aanvragen met betrouwbaarheidsniveau 2 (test-account) en daarmee inloggen op de b-acc-omgeving. Deze omgeving is een oefenomgeving waarmee het bedrijfsleven zonder veel risico haar koppeling kan testen. De b-acc-omgeving en de productieomgeving zijn functioneel gezien hetzelfde.
Na het testen stelt u vast of de koppeling in de b-acc-omgeving zowel technisch als functioneel goed functioneert. Als dit het geval is, kunt een koppeling realiseren met de productieomgeving van het LAVS.
Wat heeft u nodig
Om te koppelen met de productie-omgeving van het LAVS heeft u de volgende producten en onderstaande documenten nodig:
- het zip-bestand van de publieke deel van het certificaat bedrijvenacceptatieomgeving en productieomgeving gebruikte PKI-certificaten
- het zip-bestand met het technisch ontwerp koppelvlak WSDL-definitie van het LAVS.
Een bestand voor de b-acc-omgeving en een bestand voor de productieomgeving - de koppelvlakspecificatie (Functioneel ontwerp koppelvlak LAVS)
- een testbericht 'statusOpvraging' om te controleren of uw server met de server van LAVS kan communiceren (Functioneel ontwerp berichtenverkeer)
- de eindpunten voor de bedrijvenacceptatie- en de productieomgeving:
- eindpunt voor de b-acc-oefenomgeving:
https://acceptatie.tws-esb.rws.nl/lavs-koppelvlak-bacc - eindpunt voor de productieomgeving met standaard https-poort:
https://tws-esb.rws.nl/lavs-koppelvlak
Documenten
Functioneel Ontwerp:
- Functioneel Ontwerp koppelvlak LAVS (pdf, 1.3 MB)
- Functioneel Ontwerp Berichtenverkeer (pdf, 385 kB)
Technische gegevens:
- Enumeraties (xlsx, 14 kB) (xlsx, 14 kB)
- Publieke deel certificaat bedrijvenacceptatieomgeving (zip, 2.5 kB) (m7z, 9.7 kB)
- Publieke deel certificaat productieomgeving (zip, 2 kB) (zip, 1.9 kB)
- Technisch Ontwerp koppelvlak (WSDL) versie 4.3 (zip, 12 kB) (zip, 12 kB)
Wat moet u doen
- Aanvragen eHerkenning beveiligingsniveau 2 (testaccount).
- Aanvragen account in de bedrijfsacceptatieomgeving.
- Vraag een certificaat van PKI-overheidservices voor het LAVS aan bij een van de marktpartijen voor de koppeling met de productieomgeving. U heeft een tweede certificaat nodig voor een koppeling voor de b-acc-omgeving. Voor meer informatie over PKI-certificaten, zie de pagina PKIoverheid van Logius.
- Installeer uw certificaten op de eigen server(s) en installeer, als dit nog niet aanwezig is, ook het publieke deel van de certificaten.
- Neem contact op met de helpdesk LAVS via het vragenformulier met uw voornemen om te koppelen, en het verzoek om een koppeling met het LAVS te maken op de b-acc-omgeving. Stuur het publieke deel van uw certificaat van PKI-overheidservices (crt-formaat) voor het koppelen met de b-acc-omgeving mee naar de helpdesk. Het publieke deel is aan de LAVS-kant nodig om de verbinding op te bouwen. Wij nemen contact met u op om een moment af te spreken waarop u een test kunt beginnen op de b-acc-omgeving.
- Om de tweezijdige SSL-verbinding te testen, stuurt u het testbericht 'statusOpvraging'. Dit XML-bericht leest alleen en maakt geen wijzigingen in het LAVS. Als deze test geslaagd is, krijgt u een bericht dat lijkt op het onderstaande voorbeeld.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:StatusOpvragingResponse xmlns:ns1="http://www.egem.nl/StUF/StUF0301" xmlns:ns2="http://www.interaccess.nl/ienm/lavs/portal/1_1"> <ns2:status>SUCCESVOLVERWERKT</ns2:status> </ns2:StatusOpvragingResponse> </soap:Body> </soap:Envelope>
- Voer nu inhoudelijke testen uit om te controleren of de koppeling inhoudelijk klopt. U moet alle relevante functies van het koppelvlak testen.
- Zodra u kunt aantonen dat de testen goed zijn verlopen, neemt u opnieuw contact op via het vragenformulier. U verzoekt de koppeling te realiseren met de productieomgeving van LAVS. Toon hierbij aan dat u uw koppeling heeft getest en dat deze functioneert. Stuur hierbij ook het publieke deel van het certificaat van PKI-overheidservices (crt-formaat) dat u heeft aangeschaft voor het koppelen met de productieomgeving mee naar de helpdesk.
Direct naar het vragenformulier van de helpdesk LAVS.