Netbeheerder Test Dienst (NTD)

Transcriptie

1 0.1 Klantinstructie Netbeheerder Test Dienst (NTD) Datum 9 juni 2016 Versie 1.77 ConceptMateriebeleid PPB-LVGeo- en Vastgoedinformatie en Advies

2 Versiehistorie Versie datum locatie omschrijving /06/2016 Geheel Diverse aanpassingen Versie juni / 27

3 Inhoudsopgave 1 Klantinstructie Inleiding De NTD gebruiken U voert de certificering uit Inloggen in Mijn Kadaster Selecteren van de beheerder: alleen voor serviceproviders Keuzescherm Het testen Welke testen moet ik uitvoeren? U ontvangt feedback over de verzonden testberichten Bericht met netbeheerdersinformatie Feedback per testcase Verzoek tot Certificering Scope Randvoorwaarden: Bruikbare websites Versie juni / 27

4 1 Klantinstructie 1.1 Inleiding Voor netbeheerders is certificering met behulp van de Netbeheerders test dienst (hierna: NTD) een verplicht onderdeel om aan te kunnen sluiten op de digitale levering (Klic-online). Het doel van het certificeren is dat het Kadaster kan vaststellen dat het systeem van elke afzonderlijke netbeheerder voldoet aan de aansluiteisen voor Klic-online. Na het met succes doorlopen van deze test is de netbeheerder klaar om aan te sluiten op Klic-online. Ter voorbereiding op de certificering is het mogelijk om uw eigen systemen en de communicatielijnen met het Kadaster te testen met de verschillende NTD testen. Wij raden u dringend aan, om eerst deze NTD testen te doorlopen. Daarbij is het van belang, dat u beschikt over een PKI overheidscertificaat uit de G2 root. Deze heeft u ook nodig om te kunnen aansluiten op Klic-online. Na het doorlopen van de testen, kunt u starten met de certificering. De certificering omvat: vijf testcases voor de Graafmelding; vijf testcases voor het Oriëntatieverzoek; drie testcases voor de Calamiteitenmelding. Een toelichting van de testcases vindt u op de Kadaster website onder Certificeren. Onder hoofdstuk staat per situatie welke testcases u verplicht moet doorlopen. Na doorlopen van de testcases stuurt de netbeheerder een verzoek tot certificering en een testrapport met bijlagen naar het Kadaster. Het Kadaster beoordeelt het verzoek en gaat bij goed resultaat over tot certificering van de netbeheerder. Let op: voor het doorlopen van de Certificering is het PKI Overheidscertificaat uit de G2 root verplicht. Versie juni / 27

5 2 De NTD gebruiken 2.1 U voert de certificering uit U doorloopt verplicht een aantal testcases op de onderdelen Graafmelding, Oriëntatieverzoek en Calamiteitenmelding. Alle testen staan beschreven in het Word document KLIC testcases BMKL certificeringstool NTD. Op het formulier staat een toelichting per testcase. Dit formulier dient er tevens voor om de resultaten op bij te houden. Aan het eind van elke testcase ontvangt u een mail waarin de testresultaten beschreven staan. De resultaten houdt u bij op het Word document KLIC testcases BMKL certificeringstool NTD en de mails bewaart u. Als u alle testen heeft uitgevoerd, stuurt u het Word document met de mails met testresultaten als bijlagen naar het Kadaster. Het Kadaster beoordeelt of uw organisatie voldoet aan de eisen om aan te sluiten op Klic-online. Download het Word-document KLIC testcases BMKL certificeringstool NTD Dit formulier dient tevens om de resultaten op bij te houden. 2.2 Inloggen in Mijn Kadaster U kunt inloggen via Mijn Kadaster of via de Kadaster.nl en te klikken op inloggen zakelijk rechtsboven in het scherm (De inlogcode en het wachtwoord hebt u ontvangen na uw registratie bij het Kadaster). Versie juni / 27

6 Als u ingelogd bent, ziet u aan de linkerkant van het scherm een aantal menu-items met Klic diensten. In het menu worden alleen diensten getoond die voor u van toepassing zijn. Selecteer in het menu Klic Netbeheerder Test Dienst. Let op: In de lijst met diensten komt Klic NTD webservice ook voor. Dit is een dienst binnen Mijn Kadaster die er voor zorgt dat beheerdersinformatie teruggestuurd kan worden ten behoeve van de NTD. Dit is echter geen rol voor een gebruiker, maar voor uw systeem die de beheerdersinformatie zal gaan verzenden. Meer informatie hierover kan u lezen in de Technische toelichting NTD. 2.3 Selecteren van de beheerder: alleen voor serviceproviders Serviceproviders krijgen na het selecteren van een dienst onderstaand scherm te zien. In het scherm zijn alle netbeheerders te zien die u voor de gekozen dienst geautoriseerd hebben. U moet hier een keuze maken voor u verder kunt gaan. Alle volgende stappen zullen vervolgens uitgevoerd worden namens de gekozen beheerder. M.b.v. een zoekopdracht op beheerder en/of relatienummer kunt u de lijst inperken. Selecteer vervolgens de betreffende beheerder. Versie juni / 27

7 2.4 Keuzescherm U komt nu eerst in het NTD keuzescherm. Selecteer NTD huidig: Opvoeren testmelding Versie juni / 27

8 U krijgt onderstaand scherm te zien. Toelichting velden: Extra: Door op Help te klikken binnen de NTD, wordt u doorverwezen naar deze documentatie. Relatienummer: Dit is het relatienummer van de netbeheerder waarvoor de NTD testen worden uitgevoerd. Naam: Naam van de netbeheerder waarvoor de NTD testen worden uitgevoerd. Endpoint: U dient hier een geldige URL op te geven (het adres van de webserver waarop u de graafberichten van het Kadaster wilt ontvangen). De URL moet beginnen met - hiervoor heeft u een PKI overheidscertificaat uit de G2 root nodig. Inlogcode: Uw inlognaam voor Mijn Kadaster. Naam: Naam zoals u bekend bent onder de genoemde inlogcode. adres: Het systeem toont het antwoordadres voor de test uit het standaard testbericht. Dit adres wordt gebruikt om de mail met het testresultaat naar u te verzenden. Dit adres is ingevuld. U kunt het niet wijzigen. Meldingsoort: Kies hier voor de soort melding waarmee u de test wilt uitvoeren: Graafmelding, Oriëntatieverzoek of Calamiteitenmelding. Antwoordadres Kadaster: Dit is het endpoint (de url) van het Kadaster waar een bericht met netbeheerdersinformatie naar teruggestuurd wordt. Dit adres is (ter informatie) ingevuld, u kunt het niet wijzigen. Beheerdervolgnummer: U dient hier uw beheerdervolgnummer in te stellen. U kunt zelf een volgnummer kiezen, het nummer moet groter dan 0 zijn en kleiner dan Het nummer wordt na elk test met 1 opgehoogd. Versie juni / 27

9 Gebiedspolygoon: Geef hier de graafpolygoon op (met gebruikmaking van de WKT standaard) waarmee u de test wilt uitvoeren. Let op: de polygoon kan per testcase verschillend zijn. U dient minimaal 4 en maximaal 40 XY-coördinaten op voeren. Alle coördinaten moeten worden gescheiden met een spatie. Het laatste coördinatenpaar dient identiek te zijn aan het eerste. U dient af te ronden op hele meters en hele getallen op te geven. WKT (Well-known text) is een opmaaktaal voor het weergeven van vector geometrie objecten op een kaart. Voorbeeld graafpolygoon: POLYGON (( , , , , )) Voor elke testcase kunt u een nieuwe graafpolygoon opvoeren. De applicatie zal de opgegeven coördinaten omzetten naar gml. Binnen gml verandert het datatype naar een double. De boundingbox (de rechthoek die de polygoon omvat) van een polygoon mag maximaal 500 x 500 meter zijn voor een Graafmelding en een Calamiteitenmelding. Voor een Oriëntatieverzoek is deze maximaal 2500 x 2500 meter. Verzonden testberichten: aantal graafberichten dat ter verzending is aangeboden. Ontvangen testberichten: Het aantal ontvangen beheerdersinformatieberichten dat succesvol is ontvangen en waarbij een corresponderend graafbericht kon worden gevonden. Het Kadaster gebruikt een PKI cliënt certificaat. Netbeheerder gebruikt een PKI server certificaat (https) Bekende foutmeldingen na invoeren beheerinstellingen Wanneer u de Gebiedspolygoon (WKT) of het beheerdervolgnummer niet juist heeft gevuld, volgen onderstaande foutmeldingen: Versie juni / 27

10 Een verkeerd endpoint zal in de onderstaande foutmelding resulteren: In het geval het endpoint geen secure connection ( betreft zal onderstaande foutmelding worden getoond: Versie juni / 27

11 Als alle velden goed zijn ingevuld, kunt u de instellingen opslaan. Selecteer vervolgens Verder Toevoegen adressen voor huisaansluitschetsen (HAS) Controleer het gegeven BAG-adres en pas deze, indien nodig, aan. Het is verplicht om aan te geven of u huisaansluitschetsen wenst te ontvangen. Versie juni / 27

12 Als u geen huisaansluiting wenst, kiest u voor Nee en Start test. Als u voor Ja kiest, wordt standaard het dichtstbijzijnd adres als huisaansluitadres meegenomen en getoond. Kiest u niet voor huisaansluitschetsen dan ziet u, nadat u een of meer testen heeft uitgevoerd, een overzicht van het aantal verzonden berichten: Kiest u wel voor huisaansluitschetsen dan ziet u het volgende scherm. U kunt meerdere adressen opgeven (maximaal 100 unieke adressen). Deze vindt u door één van de drie mogelijkheden te gebruiken; Kies uit alle adressen binnen het gebied; hier worden alle adressen getoond die binnen de polygoon vallen. Versie juni / 27

13 Geef een adres op; u maakt hierbij gebruik van een bestaande straatnamenlijsten. U kunt bij de huisnummerreeks aangeven of u de even of oneven huisnummers wilt aanvragen. Geef een postcode/huisnummer op. U kunt bij de huisnummerreeks aangeven of u de even of oneven huisnummers wilt aanvragen. Zodra u op Bekijken drukt, worden alle adressen binnen de polygoon getoond en verschijnt het volgende scherm: Vervolgens kunt u uit de totaallijst nog 100 adressen toevoegen. Versie juni / 27

14 Let op: er kunnen meer dan 100 adressen worden getoond van het graafgebied. Er kunnen voor maximaal 100 adressen HAS aangevraagd worden. (Let op: Niet maximaal 100 reeksen, maar maximaal 100 unieke adressen (incl. huisnummer en huisletter/ toevoeging bijvoorbeeld Aalbersestraat 2a). Versie juni / 27

15 Als het adres wel bestaat, maar er worden geen coördinaten gevonden, krijgt u een melding: Let op: 1 of meer adressen hebben geen RD-coördinaten, zie voor het adres. Als het adres buiten de polygoon valt, krijgt u een melding: Let op: 1 of meer adressen vallen buiten de graafpolygoon, zie voor het adres. Als u een reeks aanvraagt, worden de adressen los van elkaar getoond. Via de button Verwijderen kunt u adressen uit de lijst met aangevraagde adressen verwijderen: Versie juni / 27

16 Selecteer uit de lijst met aangevraagde adressen de adressen die u wilt verwijderen, klik op de button Verwijder selectie. U kunt de selectie ook ongedaan maken door op de button Alles deselecteren te klikken. U kunt de lijst met aangevraagde adressen in één keer ook verwijderen door op button Alles selecteren en vervolgens Verwijder selectie te klikken. Via de button Sluiten komt u weer terug bij de vorige stap. Start vervolgens de test Het testen In het Word document KLIC testcases BMKL certificeringstool NTD staat welke testen u uit moet voeren. U vindt daar tevens een toelichting op de testcases. Hieronder staat beschreven hoe u de testcases uitvoert. U maakt daarbij steeds de keuze, of u een testcase uitvoert voor een Graafmelding, Oriëntatieverzoek of Calamiteitenmelding. Een toelichting op de in te vullen velden vindt u onder de drie onderstaande plaatjes. Kies voor een test met een Graafmelding, de meldingssoort Graafmelding. Kies daarna Verder Versie juni / 27

17 Versie juni / 27

18 Kies voor een test met een Oriëntatieverzoek, de meldingssoort Oriëntatieverzoek. Kies daarna Verder Kies voor een test met een Calamiteitenmelding, de meldingssoort Calamiteit. Kies daarna Verder Versie juni / 27

19 Controleer het gegeven BAG-adres en pas deze, indien nodig, aan. Selecteer Ja of Nee voor het aanvragen van huisaansluitschetsen en start de test. Wanneer het bericht succesvol is verzonden, verschijnt onderstaande scherm Versie juni / 27

20 Uitleg velden: Datum/tijd aanvraag: Datum en tijd waarop de testmelding is verstuurd. Het Kadaster kan de datum en tijd gebruiken om eventueel testmeldingen op het systeem terug te vinden. Klic-meldnummer: Het meldnummer dat aangemaakt wordt ter simulatie van de productie omgeving. Ordernummer: Het ordernummer dat het testbericht heeft gekregen ter simulatie van de productie omgeving. Verzonden testberichten: Aantal graafberichten dat ter verzending is aangeboden. Ontvangen testberichten: Het aantal ontvangen beheerdersinformatieberichten dat succesvol is ontvangen en waarbij een corresponderend graafbericht kon worden gevonden Welke testen moet ik uitvoeren? Afhankelijk van het aantal thema s dat u beheert en of u al of niet reageert op Calamiteitenmeldingen (dat is een keus van de netbeheerder) moet u meer of minder testen uitvoeren. Alle testen zijn verplicht, maar we onderscheiden de volgende uitzonderingen: Als u ervoor kiest, om geen bijlage te sturen op Graafmeldingen, dan hoeft u testcase Graafmelding 4 niet uit voeren. Als de netbeheerder in de praktijk wel een (algemene) bijlage (.pdf) levert in beheerdersinformatieberichten, is het echter een verplicht testgeval. Als u ervoor kiest, om geen bijlage te sturen op Oriëntatieverzoeken, dan hoeft u testcase Oriëntatieverzoek 9 niet uit voeren. Als de netbeheerder in de praktijk wel een (algemene) bijlage (.pdf) levert in beheerdersinformatieberichten, is het echter een verplicht testgeval. Als u ervoor kiest, om geen bijlage te sturen op Calamiteitenmeldingen, dan hoeft u de testcase Calamiteitenmelding 13 niet uit te voeren. 2.5 U ontvangt feedback over de verzonden testberichten Op het hoofdscherm van de NTD ziet u hoeveel testberichten er verzonden en ontvangen zijn. Dit is de eerste vorm van feedback. Daarnaast zult u een aantal mails ontvangen waarin het verloop van het berichten beheer gerapporteerd wordt Bericht met netbeheerdersinformatie Nadat een testbericht naar het opgegeven endpoint (de url) van de netbeheerder is verzonden, dient de netbeheerder als antwoord een bericht met netbeheerdersinformatie samen te stellen conform de specificaties uit BMKL. Versie juni / 27

21 Daarna moet dit bericht verzonden worden naar het meegegeven antwoordadres uit het testbericht. Dit is het endpoint van het Kadaster waar de netbeheerdersinformatie kan worden ontvangen en gecontroleerd Feedback per testcase Aan het eind van elke testcase ontvangt u een mail met testresultaten. Deze mails zijn belangrijk, bewaar deze goed. Bij het verzoek tot certificering moeten deze worden meegestuurd. De inhoud van de mail hangt af van het testresultaat: Goedsituatie: Netbeheerder : WOZ-klant T.a.v. : KlictscNTD Telefoon : aaaaaaa@kadaster.nl Relatienummer : Meldnummer : 00G Ordernummer : Datum aanvraag : :37:31 Geachte heer, mevrouw, Het voor u bestemde graafbericht 00G met volgnummer 2013 is met succes naar u verzonden. Met vriendelijke groet, Kadaster Klantcontactcenter klic@kadaster.nl (0800) Foutsituatie: Netbeheerder : WOZ-klant T.a.v. : KlictscNTD Telefoon : aaaaaaa@kadaster.nl Relatienummer : Meldnummer : 00G Ordernummer : Datum aanvraag : :05:31 Geachte heer, mevrouw, Het aan u aangeboden graafbericht 00G met volgnummer 2013 is ondanks herhaalde pogingen niet door u in ontvangst genomen. De reden hiervoor is: Bericht is niet door u gepersisteerd (resultaatcode = BMKL001) Met vriendelijke groet, Versie juni / 27

22 Kadaster Klantcontactcenter (0800) Voorbeeld van een Beheerdersinformatie goedbericht: Netbeheerder : WOZ-klant T.a.v. : KlictscNTD Telefoon : aaaaaaa@kadaster.nl Relatienummer : Meldnummer : 00G Ordernummer : Datum aanvraag : :04:57 Geachte heer, mevrouw, Het bericht met beheerdersinformatie voor 00G met volgnummer is door ons met succes ontvangen en goedgekeurd. Met vriendelijke groet, Kadaster Klantcontactcenter klic@kadaster.nl (0800) Voorbeeld van een Beheerdersinformatie foutbericht: Netbeheerder : WOZ-klant T.a.v. : KlictscNTD Telefoon : aaaaaaa@kadaster.nl Relatienummer : Meldnummer : 00G Ordernummer : Datum aanvraag : :47:17 Geachte heer, mevrouw, Uw aangeleverd bericht met beheerdersinformatie voor graafbericht 00G en volgnummer is ontvangen, gepersisteerd en beantwoord met responsecode BMKL000 Er zijn fouten geconstateerd bij de controle van het beheerdersinformatie-bericht. De volgende meldingen zijn gedaan: Versie juni / 27

23 BIS0141: Naamgeving Maatvoering-bestand niet juist (MV_riool vrijverval_naam Netbeheerder_00G png) Het bericht kan in deze vorm niet door ons worden verwerkt. U wordt dringend verzocht passende maatregelen te nemen. Met vriendelijke groet, Kadaster Klantcontactcenter klic@kadaster.nl (0800) Er kunnen zich meerdere foutsituaties voor doen bij het versturen van beheerdersinformatie. Deze worden aangegeven door middel van een BIS foutcode gevolgd door een omschrijving van het probleem. Meer informatie over de BIS foutmeldingen kan u vinden in de Technische notitie BMKL. Wanneer het Kadaster een Graafbericht verstuurt naar de netbeheerder dan zal de BMKL Response volgens onderstaande lijst worden gecontroleerd. a. Het bericht moet voldoen aan de schemadefinitie ("BMKLResponse.xsd") b. ResultaatCode = BMKL000 (succes) of BMKL001 (persistentiefout) c. Relatienummer = relatienummer uit het verzonden graafbericht d. Ordernummer = ordernummer uit het verzonden graafbericht e. Klicnummer = Klicnummer uit het verzonden graafbericht f. DatumTijd Verzending: wordt niet op gecontroleerd De resolutie van de aan te leveren PNG-bestanden is afhankelijk van de grootte van het graafgebied. Zie onderstaande tabel: max. gebiedsgrootte (in meters) t/m 500 x 500 m t/m 1000 x 1000 m t/m 1500 x 1500 m t/m 2500 x 2500 m resolutie (in ppm = pixels per meter) 14 ppm 7 ppm 5 ppm 3 ppm Afhankelijk van de te hanteren resolutie (in ppm) wordt het png-formaat bepaald (totaal aantal pixels breed/hoog). Kijk voor meer informatie in de Technische notitie NTD op Versie juni / 27

24 2.6 Verzoek tot Certificering Als alle cases met succes zijn afgerond, stuurt u een verzoek tot certificering. Daarvoor vult u het formulier Verzoek tot Certificering geheel in. Stuur het formulier per naar klic@kadaster.nl, samen met de volgende bijlagen: Het Word-document KLIC testcases BMKL certificeringstool NTD. In dit formulier vult u de meldnummers, ordernummers en aanvraag datum van de uitgevoerde testcases in die testcases die voor u van toepassing zijn. Het beheerdersinformatiebericht van testcase 2 voor de Graafmeldingen. Alle succes rapportages van het Kadaster. Het Kadaster beoordeelt het verzoek en de testcases en koppelt het resultaat terug. Dit gebeurt op volgorde van binnenkomst. Indien het verzoek tot certificering niet compleet is, wordt deze per mail geretourneerd, Als de NTD met goed gevolg is doorlopen, ontvangt u daarvan een bevestiging per mail van het Kadaster. Uw organisatie is nu gereed om aan te sluiten op Klic-online. Daarvoor moet nog wel een apart verzoek worden ingediend. U dient hiervoor een aanvraagformulier op te sturen en deze is te vinden op Versie juni / 27

25 3 Scope In de NTD wordt vanuit het Kadaster een bericht naar de netbeheerder gestuurd (zie onderstaande figuur 1a en 1b). Nadat het bericht succesvol is verstuurd (en door u ontvangen), is het mogelijk om met uw eigen webservice de netbeheerdersinformatie naar het Kadaster te versturen (zie onderstaande figuur 2a en 2b). Bij beide berichten wordt een technische ontvangstbevestiging verstuurd (zie onderstaande figuur 1b en 2b). De testapplicatie is bedoeld om de verbinding tussen het Kadaster en de netbeheerder te testen. Versie juni / 27

26 3.1 Randvoorwaarden: Beschikken over PKI overheidscertificaat uit de G2 root. Gebruik maken van juiste XSD-schema's. De beheersinstelling (endpoint) moet altijd gedefinieerd worden. Invoer parameters (polygoon) dient conform BMKL 1.2 concept 3 (max. aantal punten is < 50, beginpunt moet ook eindpunt zijn). Een bericht sturen met de NTD mag alleen naar een url (endpoint) van de eigen organisatie. Het versturen van de beheerdersinformatie dient op basis van de url die wordt meegegeven in het graafbericht (Antwoordadres). Berichten die met behulp van de NTD worden verstuurd bevatten standaard voorgedefinieerde waarden, waaraan geen rechten kunnen worden ontleend. Het succesvol ontvangen van beheerdersinformatie wil niet zeggen dat het bericht een correcte inhoud heeft. Het bericht met de te leveren beheerdersinformatie dient zo minimaal mogelijk qua omvang te zijn. Het is niet de bedoeling om meerdere beheerdersinformatieberichten gelijktijdig of met korte tijdsintervallen aan te bieden. Er is geen functionele relatie tussen het verstuurde bericht met de NTD (graafbericht) en de geleverde beheerdersinformatie. Maximaal 1 sessie gelijktijdig gebruiken. De NTD is niet bedoeld voor functionele en performance testen. Beschikken over internetverbinding met voldoende snelheid/bandbreedte. Aangeboden en verstuurde berichten worden niet bewaard. Versie juni / 27

27 4 Bruikbare websites (BMKL testen en Technische documentatie ) Versie juni / 27