OSO:Releases/2016-08

Uit Kennisnet Developers Documentatie
< OSO:Releases
Versie door Moolenaar01 (overleg | bijdragen) op 27 mei 2016 om 09:47 (Functioneel)
Ga naar: navigatie, zoeken

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. De Aanleverpunt-sleutel (APsleutel) biedt een mogelijkheid de invoer van de gebruiker te controleren.*
  • Aanpassing zoeksleutel. Het certificaat dat gebruikt wordt bij het genereren van de zoeksleutel zou worden vervangen met een nieuw in OSO'16 dat wordt uitgegeven door Kennisnet. NB: Er is besloten om dit certificaat NIET te vervangen.
  • Controle op geldige dossierversie/nieuwe foutmelding: Bronsystemen moeten als een dossier bij hen wordt opgevraagd, controleren of hun dossier de geldige versie heeft van de dossierstandaard. Als dit niet het geval is, moet een nieuwe foutmelding worden teruggegeven aan het doelsysteem én moet het bronsysteem de foutmelding tonen aan de eindgebruiker van het bronsysteem in het overzicht van binnengekomen Dossier verzoeken.

* Onder voorbehoud: Nog te bespreken tijdens Technisch Overleg 20160216