VA:Aansluitproces Leveranciers: verschil tussen versies
| Regel 93: | Regel 93: | ||
==3. De inhoud van een ondertekend bericht== |
==3. De inhoud van een ondertekend bericht== |
||
| − | Klik <span style="text-decoration:underline" class="mw-customtoggle-signedmeselements">hier</span> voor de lijst met elementen, welke |
+ | Klik <span style="text-decoration:underline" class="mw-customtoggle-signedmeselements">hier</span> voor de lijst met elementen, welke samen een ondertekend bericht vormen. |
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-signedmeselements"> |
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-signedmeselements"> |
||
| Regel 99: | Regel 99: | ||
{| class="wikitable" |
{| class="wikitable" |
||
|- |
|- |
||
| − | ! Width="100"| |
+ | ! Width="100"|Binary security token |
| |
| |
||
| − | + | Dit bevat de publieke sleutel van het certificaat waarmee het bericht is ondertekend. |
|
| − | * Voor VO/VAVO LASsen (berichtenstroom potentiële MBO-ganger) zal het de URL bevatten van de gemeente. |
||
| − | * Voor het MBO-koppelpunt (berichtenstroom MBO-aanmelding) zal het de URL bevatten van het VO-koppelpunt met de OIN van de VO/VAVO-instelling. |
||
<br> |
<br> |
||
|- |
|- |
||
| + | !Digest value |
||
| − | !From |
||
| + | |Op de Soapheaders en body wordt het sha256-algoritme toegepast om de verschillende velden te hashen. Canonilisatie wordt toegepast om de namespace eenduidig te gebruiken. |
||
| − | |Soapheader From bevat de URL van de verzender met het bijbehorende OIN. Dit kan default ook anonymous zijn. |
||
| − | * Voor VO/VAVO LASsen (berichtenstroom potentiële MBO-ganger) zal het de URL bevatten van het LAS-endpoint. |
||
| − | * Voor het MBO-koppelpunt (berichtenstroom MBO-aanmelding) zal het waarschijnlijk anonymous zijn met hierbij het OIN van de MBO-instelling. |
||
<br> |
<br> |
||
| + | '''Voorbeeld van Digest value'''<br> |
||
| − | |- |
||
| + | <pre> |
||
| − | !Action |
||
| + | <ds:Reference URI="#id-A819ECE6A7D2AEB814153916000571753"> |
||
| − | | |
||
| + | <ds:Transforms> |
||
| − | Hiermee wordt de operatie aangeduid. Deze moet overgenomen worden vanuit de WSDL.<br> |
||
| + | <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"> |
||
| − | Op dit moment zijn er 2 actions beschikbaar, welke van belang zijn voor berichtgeving naar en van het VO-koppelpunt:<br> |
||
| + | <ec:InclusiveNamespaces PrefixList="gen soapenv v1" xmlns:ec="http://www.w3.org/2001/10/xml-exc-c14n#"/> |
||
| − | http://vroegtijdigaanmelden.nl/v1_0/ontvangAanmeldbericht<br> |
||
| + | </ds:Transform> |
||
| − | http://vroegtijdigaanmelden.nl/v1_0/ontvangMBOGangerbericht |
||
| + | </ds:Transforms> |
||
| − | |- |
||
| + | <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/> |
||
| − | !RelatesTo |
||
| + | <ds:DigestValue>SoGuntlVcJU73MFDXjrcMmFDp29kG+D5zcY53HdXI7s=</ds:DigestValue> |
||
| − | | |
||
| + | </ds:Reference> |
||
| − | Dit veld bevat de messageId van het originele request. |
||
| + | </pre> |
||
| − | |- |
||
| − | !Timestamp |
||
| − | | |
||
| − | De timestamp bevat minimaal het veld Created. Hiermee wordt de datum en tijd aangeduid van berichtcreatie. |
||
| − | |||
| − | '''Let op''' bij validatie binnen het VO-koppelpunt wordt gekeken of het bericht niet verstreken is op basis van dit veld. Volgens de specificaties (PvE) mag de huidige datum niet meer dan 2 dagen later zijn dan de creation date. Optioneel kan nog een expiration date time worden meegestuurd. Deze expiration date time moet aangehouden worden als het bericht gevalideerd wordt. |
||
|} |
|} |
||
| − | * De SOAP Body<br><br>Deze bevat de daadwerkelijke inhoud van het bericht conform de wsdl en xsd van het aanmeld en mbogangerBericht. |
||
</div> |
</div> |
||
Versie van 8 nov 2018 13:27
Aansluitproces voor leveranciers
Deze pagina bevat informatie om als leverancier te kunnen communiceren met het VO-koppelpunt.
1. De opbouw van een verzoekbericht (request)
Een request dient ondertekend te zijn op basis van de Edukoppeling Transactiestandaard middels profiel 2w-be-s (2-weg best effort signed).
Meer informatie over de Edukoppeling Transactiestandaard kan gevonden worden op Edukoppeling.nl
Klik hier voor de lijst met elementen, welke deel uit maken van de ondertekening.
- De SOAP Headers:
| To |
Bevat de URL van het afleveradres met het bijbehorende OIN.
|
|---|---|
| From | Soapheader From bevat de URL van de verzender met het bijbehorende OIN. Dit kan default ook anonymous zijn.
|
| Action |
Hiermee wordt de operatie aangeduid. Deze moet overgenomen worden vanuit de WSDL. |
| MessageId |
Een random gegenereerd nummer, ter identificatie als er iets mis is gegaan met het berichtenverkeer binnen de keten. |
| Timestamp |
De timestamp bevat minimaal het veld Created. Hiermee wordt de datum en tijd aangeduid van berichtcreatie. Let op bij validatie binnen het VO-koppelpunt wordt gekeken of het bericht niet verstreken is op basis van dit veld. Volgens de specificaties (PvE) mag de huidige datum niet meer dan 2 dagen later zijn dan de creation date. Optioneel kan nog een expiration date time worden meegestuurd. Deze expiration date time moet aangehouden worden als het bericht gevalideerd wordt. |
- De SOAP Body
Deze bevat de daadwerkelijke inhoud van het bericht conform de wsdl en xsd van het aanmeld en mbogangerBericht.
2. De opbouw van een antwoordbericht (response)
Een response is ondertekend op basis van de Edukoppeling Transactiestandaard middels profiel 2w-be-s (2-weg best effort signed).
Meer informatie over de Edukoppeling Transactiestandaard kan gevonden worden op Edukoppeling.nl
Klik hier voor de lijst met elementen, welke deel uit maken van de ondertekening.
- De SOAP Headers:
| To |
Bevat de URL van het afleveradres met het bijbehorende OIN.
|
|---|---|
| From | Soapheader From bevat de URL van de verzender met het bijbehorende OIN. Dit kan default ook anonymous zijn.
|
| Action |
Hiermee wordt de operatie aangeduid. Deze moet overgenomen worden vanuit de WSDL. |
| RelatesTo |
Dit veld bevat de messageId van het originele request. |
| Timestamp |
De timestamp bevat minimaal het veld Created. Hiermee wordt de datum en tijd aangeduid van berichtcreatie. Let op bij validatie binnen het VO-koppelpunt wordt gekeken of het bericht niet verstreken is op basis van dit veld. Volgens de specificaties (PvE) mag de huidige datum niet meer dan 2 dagen later zijn dan de creation date. Optioneel kan nog een expiration date time worden meegestuurd. Deze expiration date time moet aangehouden worden als het bericht gevalideerd wordt. |
- De SOAP Body
Deze bevat de daadwerkelijke inhoud van het bericht conform de wsdl en xsd van het aanmeld en mbogangerBericht.
3. De inhoud van een ondertekend bericht
Klik hier voor de lijst met elementen, welke samen een ondertekend bericht vormen.
- De SOAP Headers:
| Binary security token |
Dit bevat de publieke sleutel van het certificaat waarmee het bericht is ondertekend.
|
|---|---|
| Digest value | Op de Soapheaders en body wordt het sha256-algoritme toegepast om de verschillende velden te hashen. Canonilisatie wordt toegepast om de namespace eenduidig te gebruiken.
<ds:Reference URI="#id-A819ECE6A7D2AEB814153916000571753"> <ds:Transforms> <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"> <ec:InclusiveNamespaces PrefixList="gen soapenv v1" xmlns:ec="http://www.w3.org/2001/10/xml-exc-c14n#"/> </ds:Transform> </ds:Transforms> <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/> <ds:DigestValue>SoGuntlVcJU73MFDXjrcMmFDp29kG+D5zcY53HdXI7s=</ds:DigestValue> </ds:Reference> |