Zoeken in deze site

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:

  1. het zip-bestand van de publieke deel van het certificaat bedrijvenacceptatieomgeving en productieomgeving gebruikte PKI-certificaten
  2. 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
  3. de koppelvlakspecificatie (Functioneel ontwerp koppelvlak LAVS)
  4. een testbericht 'statusOpvraging' om te controleren of uw server met de server van LAVS kan communiceren (Functioneel ontwerp berichtenverkeer)
  5. 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:

Technische gegevens:

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.