SID:Leveranciers proberen: verschil tussen versies
Naar navigatie springen
Naar zoeken springen
k (→Certificaat) |
|||
| (31 tussenliggende versies door 4 gebruikers niet weergegeven) | |||
| Regel 1: | Regel 1: | ||
| + | __TOC__ |
||
| − | [[File:Dia2.PNG|right|Proberen|150x150px|]] |
||
| + | 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 koppeling met de Nummervoorziening wordt ontwikkeld en getest tegen de kwalificatieomgeving. De leverancier maakt een testcertificaat en krijgt hier toegang mee. De WSDL en de referentie implementaties helpen bij het ontwikkelen van de client. |
||
| + | [[File:Dia2.PNG|400px|left]]<br clear="all"> |
||
| + | <br/> |
||
| + | == Stap 1: Verzoek voor toegang tot de sandbox-omgeving == |
||
| − | # De leverancier maakt of hergebruikt een test-certificaat. |
||
| + | 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. |
||
| − | # Een contactpersoon van de leverancier verzoekt toegang tot de sandbox omgeving. |
||
| − | # Toegang wordt verleend. |
||
| − | # De leverancier ontwikkelt zijn client software en zorgt dat deze werkt. |
||
| − | == Certificaat == |
+ | == 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. |
||
| − | Het testcertificaat waarmee de leverancier de TLS verbinding naar de sandbox maakt moet in elk geval bevatten: ‘serialNumber=[20-cijferig getal]’ als onderdeel van het attribuut ‘Onderwerp’ (Subject) in het certificaat<ref>Dit is analoog aan het OIN in het PKI Overheid certificaat dat in de kwalificatie- en productieomgevingen gebruikt zal worden. Het testcertificaat hoeft niet hetzelfde OIN als het PKI Overheid certificaat te bevatten.</ref>. |
||
| − | Het 20-cijferig getal wordt gebruikt om de autorisatie op te verlenen. De Nummervoorziening gebruikt dit getal voor de autorisatie van de leverancier. De leverancier geeft dit getal daarom door bij de aanvraag voor aansluiting op de sandbox omgeving. |
||
| + | == Stap 3: Ontwikkelen en testen van de client software. == |
||
| − | {{Warn|Deze code is nog niet gevalideerd; pas toe met beleid}} |
||
| + | 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: |
||
| ⚫ | |||
| ⚫ | |||
| − | De leverancier maakt een testcertificaat bijvoorbeeld met de openssl toolkit: |
||
| ⚫ | |||
| − | {{UserCmd|openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout [privkey].key -subj <nowiki>/serialNumber=[OIN]/C=NL/O=[Organisatie]/CN=[domeinnaam of eigen naam]</nowiki> -out [certificate].crt}} |
||
| ⚫ | |||
| ⚫ | |||
| + | # De url van de sandbox-omgeving is {{SID:URL_sandboxomgeving}} |
||
| + | [[Category:Nummervoorziening]] |
||
| − | {{Info|Vervang hierbij de delen tussen ''[ ]'' door toepasselijke invulling van organisatie, common name en de naam van de bestanden (certificaat en private sleutel).}} |
||
| − | |||
| − | Dit levert een bestand [certificate].crt op, dat de privé sleutel en de publieke sleutel bevat. Het is gebruikelijk om dit certificaat in de ''trust store'' van het gebruikte ontwikkelplatform onder te brengen. Op Windows worden certificaten meestal in een PKCS#12 codering gebruikt. De conversie gaat als volgt: |
||
| − | |||
| − | {{UserCmd|openssl pkcs12 -export -out [naam certificaat].pfx -inkey [privkey].key -in [certificate].crt}} |
||
| − | |||
| − | |||
| − | <references/> |
||
| − | |||
| − | == Sandbox == |
||
| ⚫ | |||
| − | |||
| ⚫ | |||
| ⚫ | |||
| − | * De url van de service is https://service-s.id.school/ws/eck/201509/ in plaats van https://service.id.school/ws/eck/201509/ |
||
| − | |||
| − | {{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]] |
||
| ⚫ | |||
| ⚫ | |||
| − | |||
| − | |||
| − | [[Categorie:SchoolID]] |
||
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/