SID:Leveranciers proberen: verschil tussen versies
(22 tussenliggende versies door 3 gebruikers niet weergegeven) | |||
Regel 1: | Regel 1: | ||
+ | __TOC__ |
||
− | De eerste stap in het aansluitproces is het ontwikkelen en testen van de koppeling (proberen) met behulp van de sandbox-omgeving van de Nummervoorziening. |
+ | De eerste stap in het aansluitproces is het ontwikkelen en testen van de koppeling ('''proberen''') met behulp van de sandbox-omgeving van de Nummervoorziening. |
[[File:Dia2.PNG|400px|left]]<br clear="all"> |
[[File:Dia2.PNG|400px|left]]<br clear="all"> |
||
<br/> |
<br/> |
||
⚫ | |||
− | De leverancier maakt een testcertificaat en krijgt hier toegang mee. De WSDL en de referentie implementaties helpen bij het ontwikkelen van de client. |
||
+ | Toegang tot de sandbox-omgeving kan verkregen worden door dit [https://www.kennisnet.nl/nummervoorziening/aanmelden-leveranciers/aanmeldformulier-leveranciers/ formulier] in te vullen. Indien je al een OSO test-certificaat hebt dan kan je de gegevens hieruit gebruiken voor het invullen van het formulier. |
||
+ | == Stap 2: Certificaat maken of hergebruiken == |
||
− | # De leverancier maakt of hergebruikt een test-certificaat. |
||
⚫ | |||
⚫ | |||
− | # Toegang wordt verleend. |
||
− | # De leverancier ontwikkelt zijn client software en zorgt dat deze werkt. |
||
+ | == Stap 3: Ontwikkelen en testen van de client software. == |
||
− | == Certificaat == |
||
+ | Je kan nu de client software ontwikkelen en testen met behulp van de sandbox-omgeving van de Nummervoorziening. Voor het ontwikkelen kan je gebruik maken van de [[SID:Wsdl|Wsdl]] en eventueel één van onze referentie implementaties: |
||
⚫ | Voor de |
||
⚫ | |||
⚫ | |||
− | == Sandbox == |
||
⚫ | |||
⚫ | |||
− | + | # Er wordt gebruik gemaakt van self-signed test certificaten (leveranciers kunnen ook aan deze omgeving koppelen met PKI Overheid certificaten, maar de Nummervoorziening valideert dit niet en stuurt een self-signed certificaat in zijn reply) |
|
− | * Het gegenereerde ECK ID is geen ‘echt’ ECK ID maar een pilot variant, te herkennen aan dat het begint met '''<nowiki>https://id.school/pilot</nowiki>'''. |
||
− | + | # Het gegenereerde ECK iD is geen ‘echt’ ECK iD maar een pilot variant, te herkennen aan dat het begint met '''<nowiki>https://ketenid.nl/pilot</nowiki>'''. |
|
+ | # De url van de sandbox-omgeving is {{SID:URL_sandboxomgeving}} |
||
− | |||
− | {{Info|Een verzoek voor toegang tot de sandbox omgeving kan door het [https://docs.google.com/forms/d/15A0I9mQMXwJ7bn7wOnInX6lX5YC6EHENMCxjx-ek7qk/viewform formulier] in te vullen.}} |
||
− | |||
− | == Ontwikkelingshulp == |
||
− | * De wsdl: [[SID:Wsdl|Wsdl]] |
||
⚫ | |||
⚫ | |||
[[Category:Nummervoorziening]] |
[[Category:Nummervoorziening]] |
Huidige versie van 21 okt 2019 om 09:56
De eerste stap in het aansluitproces is het ontwikkelen en testen van de koppeling (proberen) met behulp van de sandbox-omgeving van de Nummervoorziening.
Stap 1: Verzoek voor toegang tot de sandbox-omgeving
Toegang tot de sandbox-omgeving kan verkregen worden door dit formulier in te vullen. Indien je al een OSO test-certificaat hebt dan kan je de gegevens hieruit gebruiken voor het invullen van het formulier.
Stap 2: Certificaat maken of hergebruiken
Voor de sandbox-omgeving maken we gebruik van test-certificaten van Kennisnet. Dit zijn dezelfde certificaten als voor de test-omgeving van OSO. Als de leverancier al beschikt over een OSO test-certificaat, kan dat ook voor toegang tot de sandbox-omgeving van de Nummervoorziening worden gebruikt.
Stap 3: Ontwikkelen en testen van de client software.
Je kan nu de client software ontwikkelen en testen met behulp van de sandbox-omgeving van de Nummervoorziening. Voor het ontwikkelen kan je gebruik maken van de Wsdl en eventueel één van onze referentie implementaties:
- Referentie implementatie en documentatie voor een .Net / C# omgeving: Referentie implementatie .Net
- Referentie implementatie en documentatie voor een Java omgeving: Referentie implementatie Java
Let op: de sandbox-omgeving verschilt op drie punten van de productieomgeving:
- Er wordt gebruik gemaakt van self-signed test certificaten (leveranciers kunnen ook aan deze omgeving koppelen met PKI Overheid certificaten, maar de Nummervoorziening valideert dit niet en stuurt een self-signed certificaat in zijn reply)
- Het gegenereerde ECK iD is geen ‘echt’ ECK iD maar een pilot variant, te herkennen aan dat het begint met https://ketenid.nl/pilot.
- De url van de sandbox-omgeving is https://service-s.ketenid.nl/eck/ws/201703/