Handleiding VSV-testomgeving voor softwareleveranciers; de Proeftuin
1/6
Inhoudsopgave Hoofdstuk 1 Inleiding ................................................................................................................................ 3 1.1 Het gebruikersveld ............................................................................................................................... 3 1.2 Historie ..................................................................................................................................................... 3 Hoofdstuk 2 Gebruikte criteria voor inrichting proeftuin..................................................... 4 2.1 Authenticatie en autorisatie ............................................................................................................. 4 2.2 Toegang tot de proeftuin ................................................................................................................... 4 2.3 Testdata in plaats van echte persoonsgegevens ...................................................................... 4 2.4 Variatie in testgevallen en opvoer van testgevallen ............................................................... 4 2.5 Beschikbaarheid en performance ................................................................................................... 5 2.6 Communicatie over beschikbaarheid en performance ........................................................... 5 2.7 Aanspreekpunt DUO ............................................................................................................................ 5 2.8 Loketfunctie ............................................................................................................................................ 5 Hoofdstuk 3 Procedures ........................................................................................................................... 6 3.1 Procedure nieuwe partner/leverancier ......................................................................................... 6 3.1.1 Doorlooptijd .................................................................................................................................... 6 3.1.2 Certificaten (authenticatie) ....................................................................................................... 6 3.1.3 BRIN of instantiecode (autorisatie) ....................................................................................... 6 3.2 Procedure voor ondersteuning ........................................................................................................ 6 3.3 Procedure voor technische wijzigingen op de infrastructuur ............................................... 6
2/6
Hoofdstuk 1 Inleiding Deze handleiding is voor softwareleveranciers van scholen en gemeenten/RMC ten behoeve voor de test van hun softwarepakketten bij DUO.
1.1 Het gebruikersveld DUO stelt een testomgeving beschikbaar voor softwareleveranciers van scholen en softwareleveranciers van gemeenten/RMC’s. DUO faciliteert deze testomgeving en levert informatie over functionaliteit en specificaties aan de leveranciers. Daarnaast levert DUO de testcoördinator die de testen begeleidt. De softwareleveranciers zijn verantwoordelijk voor de testlocaties bij instellingen en gemeenten/RMC’s. Daarnaast zijn ze verantwoordelijk voor het functioneel afstemmen met de instellingen en gemeentes/RMC’s en het aanpassen van hun softwarepakketten om deze geschikt te maken voor de koppeling met de VSV-applicatie. 1.2 Historie De wens voor een (permanente) testomgeving werd al uitgesproken in 2008 toen VSV voor het eerst testen ging uitvoeren met softwareleveranciers. Door de tijd kwam deze vraag terug tijdens technische overleggen en tijdens de implementatie van nieuwe releases. Eind 2009 kreeg de toen bestaande testomgeving een permanent karakter. Die testomgeving is nu vervangen door een nieuwe testomgeving, de proeftuin De proeftuin heeft een betere infrastructuur met eenduidige procedures waardoor testen gestandaardiseerd worden.
3/6
Hoofdstuk 2 Gebruikte criteria voor inrichting proeftuin In dit hoofdstuk worden de wensen van de partners/leveranciers toegelicht met betrekking tot de proeftuin. We staan ook stil bij afhankelijkheden die de partners/leveranciers raken wanneer DUO wijzigingen doorvoert. 2.1 Authenticatie en autorisatie De proeftuin maakt gebruik van testcertificaten die worden uitgegeven door DUO. De testomgeving maakt weliswaar geen gebruik van PKI-overheidscertificaten echter het authenticatie/autorisatiesysteem is precies hetzelfde als in de productieomgeving. Gebruikers worden geautoriseerd op basis van de subject, issuer en BRIN of instantiecode. In de proeftuin wordt gebruikgemaakt van testcertificaten omdat productiecertificaten in een testomgeving niet zijn toegestaan. 2.2 Toegang tot de proeftuin De proeftuin is bereikbaar via het internet: Versie 6: https://xml-test.duo.nl:6912/GV8/vsv6/services/VSVService-v6.0 Versie 7 voor scholen: https://xml-test.duo.nl:6912/GV8/vsv7/services/DUO_RelatiefVerzuim_V1 Versie 7 voor gemeenten: https://xml-test.duo.nl:6912/GV8/vsv7/services/DUO_RelatiefVerzuimActie_V1
2.3 Testdata in plaats van echte persoonsgegevens Softwareleveranciers willen graag met productiegegevens testen omdat hun klanten over deze gegevens beschikken. Ook zouden softwareleveranciers graag situaties voor een specifieke klant vanuit de productieomgeving willen testen. DUO zich moet echter conformeren aan de privacywet. Daarom mag er geen gebruik worden gemaakt van echte persoonsgegevens of van testdata die herleidbaar zijn naar echte persoonsgegevens. Maar er zijn wel gegevens die productie-like kunnen worden uitgevoerd in de proeftuin. De volgende gegevens worden productie-like uitgevoerd in de proeftuin: • Instanties; • BRIN’s; • De routering1 2.4 Variatie in testgevallen en opvoer van testgevallen Om aan de wens van grotere diversiteit in testsituaties tegemoet te komen, is een loketfunctie beschikbaar om als softwareleverancier de andere kant van de keten (school of gemeente) te simuleren. Meldingen kunnen op twee manieren worden aangemaakt: - via de M2M koppeling indien de partner/softwareleverancier voor scholen actief is; - via het loket. Deze functie is interessant voor zowel een gemeente- als schoolleverancier (zie paragraaf 2.8). 1
Routering. De routering bepaalt naar welke instantie waar een melding wordt gerouteerd (LP/RMC).
4/6
Bij de toegang tot de proeftuin is een vulling van meldingen beschikbaar voor softwareleveranciers van gemeenten en scholen. De softwareleveranciers werken met een geanonimiseerde productieset. 2.5 Beschikbaarheid en performance De proeftuin is op werkdagen beschikbaar van 7:00 uur tot 18:00 uur. Ondanks dat de proeftuin wekelijks wordt gecontroleerd op correcte werking, kan DUO geen garanties geven op de werking of beschikbaarheid van de proeftuin. 2.6 Communicatie over beschikbaarheid en performance Wanneer onderhoud van invloed is op de beschikbaarheid of performance van de proeftuin informeert DUO de softwareleveranciers via e-mail. Dat gebeurt twee dagen voor implementatie van de wijziging. Indien spoedonderhoud nodig, behoudt DUO zich het recht toe om een wijziging acuut te implementeren zonder softwareleveranciers vooraf te informeren. 2.7 Aanspreekpunt DUO DUO ondersteunt softwareleveranciers in de proeftuin. Softwareleveranciers kunnen DUO via e-mail ondersteuning vragen:
[email protected]. Bij een aanvraag voor ondersteuning ontvangt de softwareleverancier een indicatie over de termijn wanneer het verzoek tot ondersteuning zal worden afgehandeld, waarbij de volgende onderverdeling wordt aangehouden: - We streven ernaar om een vraag over de documentatie binnen vijf werkdagen af te handelen; - Overige vragen worden doorgaans binnen vijf werkdagen beantwoord. 2.8 Loketfunctie Om testsituaties inzichtelijker te maken, is voorzien in een loketfunctie. In deze loketfunctie kunnen meldingen worden bekeken opgevoerd en gewijzigd. Via de proeftuin kunt u op het loket inoggen met een gebruikersnaam, wachtwoord en token. DUO voorziet de softwareleverancier van een gebruikersnaam, wachtwoord en token en van welke BRIN of Instantie gebruik zal worden gemaakt. Het loket vindt u op internet via: https://vt-zakelijk.ocwduo.nl/zp
5/6
Hoofdstuk 3 Procedures 3.1 Procedure nieuwe partner/leverancier Gaat u voor het eerst testen in de proeftuin? Dan neemt een relatiebeheerder van DUO telefonisch contact met u op In dit gesprek wordt een toelichting gegeven op de procedure. Hierna worden de volgende zaken toegestuurd: - de dan geldende productie XSD’s; - verdere documentatie; - het testcertificaat met wachtwoord; - de benodigde testset. 3.1.1 Doorlooptijd De softwareleverancier ontvangt de gevraagde gegevens binnen vier weken. In deze periode worden de volgende acties uitgevoerd: - het aanmaken van testgevallen - het laten aanmaken van een testcertificaat - autorisatie voor de proeftuin 3.1.2 Certificaten (authenticatie) Om te kunnen testen in de proeftuin moet de softwareleverancier gebruik maken van een testcertificaat. Dit certificaat maakt DUO en ontvangt de softwareleverancier. Het certificaat is alleen te gebruiken voor toegang tot de proeftuinomgeving. Een testcertificaat is 5 jaar geldig. 3.1.3 BRIN of instantiecode (autorisatie) De proeftuin maakt gebruik van een autorisatiemiddel dat is gebaseerd op een geldig certificaat in combinatie met een BRIN of Instantiecode. De BRIN of instantiecode is naar voorkeur hetzelfde als in productie. Hiervan kan alleen in extreme gevallen worden afgeweken. Voor een nieuwe partner of leverancier toegang tot de proeftuin krijgt vraagt DUO welke BRIN of instantiecode gebruikt moet worden voor initiële vulling.
3.2 Procedure voor ondersteuning Vragen voor ondersteuning kunnen worden gestuurd naar het e-mailadres
[email protected] waar deze worden beantwoord door de beheerders van SRV. De partner/leverancier krijgt via e-mail te horen wanneer het verzoek wordt behandeld.
3.3 Procedure voor technische wijzigingen op de infrastructuur Wijzigingen of onderhoud aan de proeftuin zullen tijdig worden aangekondigd via het emailadres
[email protected]
6/6