Gebruikershandleiding Digikoppeling Compliance Voorziening (Portaal) Versie 1.0 Datum 18-10-2016 Status Concept
Colofon Logius Servicecentrum: Postbus 96810 2509 JE Den Haag t. 0900 555 4555 (10 ct p/m) e. servicecentrum@logius.nl Documentbeheer Datum Versie Auteur Opmerkingen 13/06/2016 0.1 Logius Eerste concept versie 18/10/2016 1.0 Logius Eerste definitieve versie Pagina 2 van 21
Inhoud 1 Inleiding... 4 1.1 Doel en doelgroep... 4 1.2 Scope... 4 1.3 Opbouw Digikoppeling documentatie... 4 1.4 Over Digikoppeling... 4 1.5 Gerelateerde documenten... 4 2 Over Digikoppeling Portaal... 5 3 Digikoppeling Portaal functionaliteit en componenten... 6 3.1 Overzicht... 6 3.1.1 Registreren... 7 3.1.2 Inloggen... 8 3.1.3 Verlopen wachtwoord... 8 3.1.4 Instellingen... 8 3.1.5 Compliance testen met Portaal als provider (WUS/WSRM)... 12 3.1.6 Compliance testen met Portaal als requester (WUS/WSRM). 14 3.1.7 Compliance testen ebms... 16 3.1.8 Anonieme rapportages... 17 3.1.9 Mijn rapportage... 17 4 Onder Digikoppeling Portaal motorkap:... 19 4.1 Use cases WUS/WSRM... 19 4.2 Use case WUS/WSRM als provider... 19 4.3 Use case WUS/WSRM als requester... 20 4.4 Use cases ebms... 21 5 Documentatie (gerelateerd aan deze gebruikers handleiding): Fout! Bladwijzer niet gedefinieerd. 5.1 Bronnen:... Fout! Bladwijzer niet gedefinieerd. 5.2 Verder raadplegen:... Fout! Bladwijzer niet gedefinieerd. Pagina 3 van 21
1 Inleiding 1.1 Doel en doelgroep Dit document beschrijft hoe organisaties de Digikoppeling Compliancevoorzieningen kunnen gebruiken. Het document is bestemd voor (zie ook onderstaande tabel): Ontwikkelaars die een ebms of WUS service voor het Digikoppeling domein gerealiseerd hebben; Ontwikkelaars die moeten controleren of de logische laag van de webservice of webservice cliënt implementatie voldoet aan de koppelvlakstandaarden, zoals die door Digikoppeling zijn gesteld. Afkorting Rol Taak Doelgroep? [MT] Management Bevoegdheid om namens organisatie Nee (strategische) besluiten te nemen. [PL] Projectleiding Verzorgen van de aansturing van projecten. Nee [A&D] Analyseren & ontwerpen (design) Analyseren en ontwerpen van oplossingsrichtingen. Het verbinden van Business aan de IT. Nee [OT&B] Ontwikkelen, testen en beheer Ontwikkelt, bouwt en configureert de techniek conform specificaties. Zorgen voor beheer na ingebruikname. Ja 1.2 Scope Digikoppeling Portaal 1.0 richt zich op het testen van compliancy ten opzichte van de Digikoppeling standaard versie 3.0. 1.3 Opbouw Digikoppeling documentatie Dit document is een handleiding voor het gebruik van Compliancevoorzieningen WUS en ebms. 1.4 Over Digikoppeling Een algemene toelichting over Digikoppeling staat in het document Wat is Digikoppeling en zit in de Digikoppeling documentatie. Begrippen worden zoveel mogelijk in dit document uitgelegd. Maar een overzicht van begrippen en afkortingen staat in het document Digikoppeling_3.0_Architectuur_vx.x.pdf 1. 1.5 Gerelateerde documenten Meer informatie Zie document in de aansluitkit Doelgroep URL naar Compliancevoorziening WUS https://www.wus.cv.osb.overheid.nl/ictuocvwus-war/home.html [OT&B] Algemene toelichting over Digikoppeling Wat is Digikoppeling_vx.x.pdf [PL] [A&D] [OT&B] Digikoppeling 2.0 Koppelvlakstandaard WUS. Digikoppeling_2.0_Koppelvlakstandaard_WUS _vx.x.pdf [A&D] [OT&B] Digikoppeling 3.0 Koppelvlakstandaard WUS. Digikoppeling_3.0_Koppelvlakstandaard_WUS _vx.x.pdf Digikoppeling 2.0 Koppelvlakstandaard Grote Berichten. Digikoppeling_2.0_Koppelvlakstandaard_GB _vx.x.pdf Digikoppeling 2.0 Best practices WUS Digikoppeling_2.0_Best_Practices_WUS [OT&B] _vx.x.pdf Digikoppeling 2.0 Best practices Grote Berichten Digikoppeling_2.0_Best_Practices_GB _vx.x.pdf Met vx.x wordt de laatst gepubliceerde versie op de Logius website bedoeld. 1 Met vx.x wordt de laatst gepubliceerde versie op de Logius website bedoeld. Pagina 4 van 21
2 Over Digikoppeling Portaal Overheidorganisaties die aansluiten op Digikoppeling willen bepalen of hun service(client)-implementaties aan de Digikoppeling standaard voldoen. De Digikoppeling Compliancevoorziening (Portaal) is een web applicatie met een Digikoppeling adapter die de logistieke laag van deze implementaties valideert op basis van de koppelvlakstandaarden. Het resultaat van de validaties en inzage in de uitgewisselde berichten wordt in de webapplicatie getoond. De gebruiker is doorgaans een ICT leverancier die namens een overheidsorganisatie opereert. Digikoppeling bestaat uit een tweetal protocollen, namelijk: - ebms - WUS/WSRM waarbij RM voor Reliable Messaging staat. Er zijn in totaal 6 WUS/WSRM profielen: - Digikoppeling 2W-BE - Digikoppeling 2W-BE-S - Digikoppeling 2W-BE-SE - Digikoppeling 2W-R - Digikoppeling 2W-R-S - Digikoppeling 2W-R-SE De eerste drie profielen van WUS zijn bedoeld voor het uitvoeren van bevragingen (BE). Deze profielen gebruiken een synchroon patroon. De laatste drie profielen zijn bedoeld voor meldingen (R). Bij bevragingen zijn directe antwoorden vereist, bij meldingen zijn betrouwbaarheid belangrijker dan een snelle reactie. Bij meldingen / Reliable Profielen word gebruik gemaakt van een asynchroon patroon. BE staat voor Best Effort. S staat voor Signing. SE staat voor Signing en Encrypted. ebms werkt qua protocol vergelijkbaar met WSRM; het antwoord moet goed dus betrouwbaar zijn maar het hoeft niet onmiddellijk te worden geleverd. Pagina 5 van 21
3 Digikoppeling Portaal functionaliteit en componenten 3.1 Overzicht Er zijn onderstaande functies te onderkennen (in een logische scenario volgorde): 1. Registreren. 2. Inloggen. 3. Wachtwoord resetten. 4. Instellingen beheren. 5. Compliance testen met Portaal als provider (WUS/WSRM) 6. Compliance testen met Portaal als requester(wus/wsrm) 7. Compliance testen ebms. 8. Anonieme rapportages inzien. 9. Mijn rapportages inzien. Op de HOME pagina van het Digikopeling Compliancevoorziening (Portaal) worden de hoofdfuncties opgenomen. Deze functies zijn middels tabbladen in de groene balk bovenaan aan te roepen. Deze balk wordt op elke pagina op een uniforme wijze getoond. Pagina 6 van 21
3.1.1 Registreren Om als gebruiker berichten te kunnen versturen van/naar het Portaal en om specifieke, eigen rapportages te kunnen bekijken moet men zich registreren op basis van het OIN, gebruikersnaam, wachtwoord, en emailadres. De gebruikersnaam heeft de formaat naam@emailadres. Bij een succesvolle registratie krijg je onderstaande bevestiging: Pagina 7 van 21
3.1.2 Inloggen Inloggen middels gebruikersnaam en wachtwoord. Bij foutief inloggen wordt onderstaand scherm getoond: 3.1.3 Verlopen wachtwoord Wanneer het wachtwoord verloopt, kun je hem zelf resetten. 3.1.4 Instellingen Na het registreren, maar voordat je gaat testen, kun je een aantal instellingen invullen. Een aantal instellingen zijn verplicht voor bepaalde doelen. Een CPA is bijvoorbeeld verplicht voor ebms uitwisselingen. Pagina 8 van 21
Je krijgt een inlogscherm. Na een geslaagde inlogsessie krijg je het onderstaande scherm te zien om organisatie gegevens in te vullen in een profiel (dat uiteraard op een later moment aan te passen is): Na een succesvolle profiel invulling of wijziging krijg je onderstaande bevestiging: Pagina 9 van 21
Vervolgens kun je de endpoints van je organisatie toevoegen: Vervolgens kun je certificaten uploaden en beheren: Certificaat valideren: Pagina 10 van 21
Vervolgens kun je eventueel t.b.v. ebms uitwisselingen CPA s uploaden en beheren: Pagina 11 van 21
3.1.5 Compliance testen met Portaal als provider (WUS/WSRM) In dit geval stuurt de Complinace Voorziening berichten uit aan de door de gebruiker opgegeven service. Tabblad Compliance testen: Stap 1: selecteer in het menu links het onderwerp WUS testen Stap 2: vul het formulier in en klik op de button verstuur Een scenario is een combinatie van een profiel en een operatie: ping De service controleert het vraag bericht ping. touppercase De service controleert het vraag bericht touppercase. bindata De service controleert het vraag bericht bindata. Dit bericht is speciaal bedoeld voor het valideren van het toepassen van MTOM/XOP. Dit Pagina 12 van 21
bericht bevat dan ook binaire data. Standaard wordt als binaire data het Digikoppeling logo in response meegestuurd. grootbericht bindata-mtom Kies een scenario. De namen bevatten afkortingen van zowel de profiel alsmede de operatie. Stap 3: Stap 4: Pagina 13 van 21
3.1.6 Compliance testen met Portaal als requester (WUS/WSRM) Stap 1 (WUS en WSRM testen): Stap 2: Een scenario is een combinatie van een profiel en een operatie: ping De service controleert het vraag bericht ping. touppercase De service controleert het vraag bericht touppercase. bindata De service controleert het vraag bericht bindata. Dit bericht is speciaal bedoeld voor het valideren van het toepassen van MTOM/XOP. Dit bericht bevat dan ook binaire data. Standaard wordt als binaire data het Digikoppeling logo in response meegestuurd. grootbericht bindata-mtom Kies een scenario. De namen bevatten afkortingen van zowel de profiel alsmede de operatie. Pagina 14 van 21
Stap 3: Verstuur het bericht. Stap 4: Bevestiging dat het bericht is verstuurd. Pagina 15 van 21
3.1.7 Compliance testen ebms De eerste eenvoudige test is Ping. Hiermee kan aangetoond worden dat beide adapters met elkaar communiceren. Het versturen van ebms bericht: Pagina 16 van 21
3.1.8 Anonieme rapportages De anonieme rapportages zijn publiek dus voor iedere gebruiker zichtbaar. WUS rapportages: 3.1.9 Mijn rapportage Mijn rapportages zijn alleen zichtbaar voor de gebruiker die ingelogd is. Mijn WUS rapportage: Pagina 17 van 21
Mijn ebms rapportage: Pagina 18 van 21
4 Onder Digikoppeling Portaal motorkap: 4.1 Use casess WUS/WSRM 4.2 Compliancevoorziening WUS/WSRM als provider In deze tekening moet/kun je DART lezen als jouw Digikoppeling adapter Pagina 19 van 21
4.3 Compliancevoorziening WUS/WSRM als requester In deze tekening moet/kun je DART lezen als jouw Digikoppeling adapter Pagina 20 van 21
4.4 Use cases ebms Pagina 21 van 21