OSO:Releases/2016-08

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen

Het Programma van Eisen/Ontwerp van OSO'16 is op de wiki te vinden: OSO '16 Voornaamste wijzigingen zijn de nieuwe PKI infrastructuur en het Notificatie mechanisme.


Hieronder volgen de wijzingen in OSO'16 (ten opzichte van OSO'15):

Netwerk/infra/beveiliging

  • PKI Infrastructuur ('SAAS certificaat') In OSO'16 wordt de overstap gemaakt van 'Aanleverpunt certificaten' naar 'SAAS certificaten'. Dit betekent een grote aanpassing aan de manier waarop de beveiliging is geregeld binnen OSO. Het is daarom niet mogelijk hier kort aan te geven welke wijzigingen hiervoor nodig zijn.
  • Aanvullende eis aan logging De logging van systemen moet voldoende informatie bevatten om vast te kunnen stellen welke 'account' de opdracht gaf een dossier op te halen of een dossier beschikbaar stelde.

Functioneel

De functionele aanpassingen zoals voorgesteld in het memo van 2015112:

  1. Notificatie mechanisme Dit is een nieuwe functionaliteit die zowel Bron- als Doel- systemen raakt. Doelsystemen moeten nu altijd een URL registreren bij het Aanleverpunten waarnaar de Notificatie gestuurd kan worden.
  2. Gebruiken van timestamp (dossierVerzameldatum) bij het opvragen van een Dossier aanvraag; dit heeft impact op Opvragen van een Dossier én Samenstellen van een Dossier. Bestaande Bronsytemen moeten deze parameter kunnen verwerken, Doelsystemen kunnen er voor kiezen deze mogelijkheid beschikbaar te maken aan hun eindgebruikers.
  3. Tonen van binnengekomen gegevens en bijlagen: Doelsystemen moeten de inhoud van het ontvangen Dossier tonen aan Eindgebruikers.
  4. Optie om specifiek AP te bevragen ('Optioneel ondersteunen Speciaal Onderwijs'): Deze functionaliteit maakt het mogelijk voor doelsystemen om uitwisselingen t.b.v. Specaal Onderwijs te ondersteunen. Dit is een optionele uitbreiding, het staat Leveranciers vrij om dit in te bouwen. Er is geen impact voor bronsystemen.
  5. Aanpassing adressering In OSO'16 krijgen worden in alle berichten altijd vier adresvelden (BronBRIN, BronAPindex, DoelBRIN, DoelAPindex) gebruikt. Voor aangesloten systemen betekent dit dat de aanroepen naar het TC en onderling zullen wijzigen (volgorde van velden en extra velden). Functioneel is er geen wijziging.


Aanvullende aanpassingen:

  • AP-index naar 3 digits. De mogelijkheid bestaat dat we uit de huidige index van twee digits groeien als BRINs erg veel aanleverpunten hebben. Alle systemen worden hierdoor (licht) geraakt.
  • AP verificatie met sleutel*
  • Aanpassing zoeksleutel. Het certificaat dat gebruikt wordt bij het genereren van de zoeksleutel wordt vervangen met een nieuw in OSO'16 dat wordt uitgegeven door Kennisnet.
  • Controle op geldige Dossierversie/nieuwe foutmelding: Bronsystemen moeten als een Dossier wordt opgevraagd, controleren of dit de geldige versie heeft van de Dossierstandaard. Als dit niet het geval is, moet een nieuwe foutmelding worden teruggegeven naar het Bronsysteem én moet dit getoond worden aan de Eindgebruiker van het Bronsysteem in het overzicht van binnengekomen Dossier verzoeken.

* Onder voorbehoud: Nog te bespreken tijdens Technisch Overleg 20160216