OSR:Hoofdpagina: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
Geen bewerkingssamenvatting
kGeen bewerkingssamenvatting
 
(126 tussenliggende versies door 3 gebruikers niet weergegeven)
Regel 1: Regel 1:
__NOTOC__
__NOTOC__
=Programma van Eisen/Ontwerp van OSO'18 Versie 1.0 20180404=
De Overstap Service Onderwijs (OSO) is een dienst die het veilig en betrouwbaar overdragen van digitale overstap dossiers faciliteert. OSO bestaat enerzijds uit een technisch deel, waarbij de centrale component van OSO, het Traffic Center, de toegang regelt van schoolsystemen tot OSO. Het tweede deel is een set afspraken over de inhoud en structuur van de dossiers, de functionaliteit, techniek en beveiliging van de koppelvlakken en de omgang met de gegevens door leveranciers en scholen.


Deze website fungeert als "Programma van Eisen" en als "ontwerpspecificatie" voor partijen die willen aansluiten op OSO. De informatie op deze site is daardoor voornamelijk technisch van aard. Voor scholen en eindgebruikers is actuele en relevante informatie beschikbaar op de volgende website: [http://www.overstapserviceonderwijs.nl/ Overstapservice Onderwijs]. Daarnaast zijn nog twee websites van belang:
<h2>Over het OSR</h2>
*De via OSO verstuurde dossiers volgen de afspraken en definities van de [https://www.edustandaard.nl/standaarden/afspraken/afspraak/oso-gegevensset/ EduStandaard OSO gegevensset]. De ontwikkeling van de gegevensset is nauw gelinkt met die van OSO, maar staat formeel los van de dienst OSO.
{|
*De [[KVS:Hoofdpagina|Kennisnet Validatie Service (KVS)]] maakt formeel geen onderdeel uit van OSO, maar wordt binnen OSO wel toegepast.
|- style="vertical-align:top"
| Het [https://www.kennisnet.nl/diensten/onderwijs-service-register/ Onderwijs Serviceregister (OSR)] vervult de rol van “telefoonboek” voor de onderwijsketen. <br>
In het OSR worden de relatie tussen scholen, leveranciers en diensten vastgelegd. Hiermee biedt het OSR een standaardoplossing omtrent routerings- en autorisatievraagstukken. <br>
<br>
<h2>De OSR API</h2><br>
Voor partijen die geautomatiseerd gebruik willen maken van het register is een REST API beschikbaar.
Hiermee kan OSR eenvoudig worden geïntegreerd in de uitwisseling van berichten tussen systemen.<br>
De volgende functionaliteiten worden door de OSR API ondersteund:<br>
<br>
[[OSR:API/V2/Opvragen_informatie_over_onderwijsinstelling|1.Basisinformatie over onderwijsinstellingen opvragen]]<br>
De gebruiker kan informatie over scholen en besturen in OSR opvragen. Deze informatie is gebaseerd op de instellingsgegevens van [https://duo.nl/zakelijk/voortgezet-onderwijs/instellingsgegevens/rio/ RIO].<br>
Filteren kan op naamgegevens en gestandaardiseerde identificatienummers (OIN, BGE-code, OIE code).<br>
<br>
[[OSR:API/V2/Opvragen_informatie_over_dienst|2. Informatie over een dienst of dienstversie opvragen]]<br>
OSR bevat informatie over diverse diensten en ketensamenwerkingen. Met de OSR API kan de gebruiker namen, omschrijvingen en onderliggende versies opvragen.<br>
<br>
[[OSR:API/V2/Valideren_mandaat|3. Het mandaat van een systeem valideren]]<br>
In OSR registreren scholen en schoolbesturen mandaten voor de leveranciers die namens hun privacygevoelige gegevens mogen verwerken.<br>
Systemen kunnen met de OSR API opvragen of zij (of een systeem dat met hun wil uitwisselen) een geldig mandaat van de onderwijsinstelling hebben ontvangen.<br>
<br>


[[OSR:API/V2/Opvragen_endpoints|4. Endpoints toevoegen, bewerken, verwijderen en opvragen]]<br>
Systemen registreren via de OSR API per school op welke endpoints (URL) zij gegevens willen ontvangen voor het het berichtenverkeer voor een bepaalde dienst.<br>
Hierbij wordt een routeringskenmerk meegegeven en het datumbereik waarbinnen het endpoint geldig is.<br>
Systemen vragen deze endpoints van elkaar op en bepalen op deze manier waar berichten heen moeten worden gestuurd.<br>
<br>
<br>


In de Overstapservice werken leveranciers van schoolsystemen samen om de overdracht van leerlinginformatie tussen scholen in het PO en VO te faciliteren en optimaliseren.
{{Info|
* Op deze pagina is een overzicht van aangesloten scholen te vinden: [http://www.overstapserviceonderwijs.nl/gebruik-oso/overzicht-scholen-met-oso/]
* Voor het bevragen van de OSR API heeft u een PKIoverheidcertificaat nodig. Op [https://www.logius.nl/domeinen/toegang/pkioverheid/wat-een-pkioverheidcertificaat deze] pagina van Logius vindt u meer informatie.
*Op deze [[https://www.overstapserviceonderwijs.nl/overzicht-aangesloten-administratiesystemen/ pagina]] is een overzicht van aangesloten systemen te vinden.
* Om informatie via de OSR API te kunnen bewerken kunt u [https://www.kennisnet.nl/contact/ contact] opnemen met Kennisnet voor ondersteuning bij uw implementatie.
* Onlangs is OSR API versie 3 uitgebracht om mandateren op bestuursniveau mogelijk te maken. Lees [[OSR:API/V2/API_V2_naar_V3_wijzigingen|hier]] de vernieuwingen ten opzichte van de vorige versie.
}}


{{Info|Voor inhoudelijke vragen kunt u bij voorkeur contact opnemen via de OSO techlijst ([mailto:info@tech.oso-od.nl info@tech.oso-od.nl]] lidmaatschap vereist) of via [mailto:servicedesk@oso-od.nl servicedesk@oso-od.nl]}}
| style="padding-left:4em" |
=== OSR kwalificatie ===
[[:File:Kwalificatie test plan OSR.pdf|Kwalificatie testplan OSR 2.2]]


{| cellspacing="10" cellpadding="5" border="0" width="90%"
=== Hotlinks ===
|- valign="top"
[https://osr.kennisnet.nl/api/v3/documentation API-documentatie]<br/>
| style="width:60%" |  
[[OSR:omgevingen|OSR Omgevingen]]<br/>
[[OSR:dienst-versies|OSR Dienstversies]]


=== OSO specificatie ===
=== Security ===
[[OSO:Releases/2018-01|Wijzigingen in OSO'18''']]<br>


Kennisnet standaarden rondom<br>[https://developers.wiki.kennisnet.nl/index.php?title=Standaarden:Beveiligd_Gegevenstransport beveiligd gegevenstransport].


=== Ondersteuning ===


[[OSO:2018/Algemene_Eisen|Algemene eisen]]<br>
[[OSR:Begrippenlijst|Begrippenlijst]]<br>
[[OSO:2018/Inhoudelijke_Eisen|Inhoudelijke eisen]]<br>
[[OSR:Veelgestelde_vragen|Veelgestelde vragen]]
[[OSO:2018/Specifieke_Eisen|Functionele eisen]]<br>
[[OSO:2018/beveiliging|Beveiligingseisen]]<br>
<br>
[[OSO:2018/PDF-viewer | PDF-viewer]]
<br>
[[OSO:2018/Architectuur|Architectuur]]<br>
[[OSO:2018/FAQ|Veelgestelde vragen]]<br>
 
| style="width:40%" |
 
=== Hotlinks ===
* [[OSO:2018/Omgevingen|Omgevingen + WSDL]]
 
=== OSO'18 Test ===
*[[OSO:2018/Testplanning_leveranciers|Testplanning]]
*[[OSO:2018/Testplannen|Testplannen]]
*[[OSO:2018/Leverancier/Testschool|Testschool]]
 
=== Externe informatiebronnen ===
* [https://www.edustandaard.nl/standaarden/afspraken/afspraak/oso-gegevensset/2017.1/ EduStandaard OSO (dossier standaard)]
*[[KVS:Hoofdpagina|Kennisnet Validatie Service]]
* [[OSO:2017/Woordenlijst|Woordenlijst]]


=== Communicatie ===
[[Category:OSR]]
{{ComItem|Homepage|Overstap Service Onderwijs site|http://www.overstapserviceonderwijs.nl/}}
{{ComItem|Rss|Atom Feed wijzigingen OSO wiki|{{Rsslink}}}}
|}

Huidige versie van 1 jul 2025 14:34


Over het OSR

Het Onderwijs Serviceregister (OSR) vervult de rol van “telefoonboek” voor de onderwijsketen.

In het OSR worden de relatie tussen scholen, leveranciers en diensten vastgelegd. Hiermee biedt het OSR een standaardoplossing omtrent routerings- en autorisatievraagstukken.

De OSR API


Voor partijen die geautomatiseerd gebruik willen maken van het register is een REST API beschikbaar. Hiermee kan OSR eenvoudig worden geïntegreerd in de uitwisseling van berichten tussen systemen.
De volgende functionaliteiten worden door de OSR API ondersteund:

1.Basisinformatie over onderwijsinstellingen opvragen
De gebruiker kan informatie over scholen en besturen in OSR opvragen. Deze informatie is gebaseerd op de instellingsgegevens van RIO.
Filteren kan op naamgegevens en gestandaardiseerde identificatienummers (OIN, BGE-code, OIE code).

2. Informatie over een dienst of dienstversie opvragen
OSR bevat informatie over diverse diensten en ketensamenwerkingen. Met de OSR API kan de gebruiker namen, omschrijvingen en onderliggende versies opvragen.

3. Het mandaat van een systeem valideren
In OSR registreren scholen en schoolbesturen mandaten voor de leveranciers die namens hun privacygevoelige gegevens mogen verwerken.
Systemen kunnen met de OSR API opvragen of zij (of een systeem dat met hun wil uitwisselen) een geldig mandaat van de onderwijsinstelling hebben ontvangen.

4. Endpoints toevoegen, bewerken, verwijderen en opvragen
Systemen registreren via de OSR API per school op welke endpoints (URL) zij gegevens willen ontvangen voor het het berichtenverkeer voor een bepaalde dienst.
Hierbij wordt een routeringskenmerk meegegeven en het datumbereik waarbinnen het endpoint geldig is.
Systemen vragen deze endpoints van elkaar op en bepalen op deze manier waar berichten heen moeten worden gestuurd.


Info.gif
  • Voor het bevragen van de OSR API heeft u een PKIoverheidcertificaat nodig. Op deze pagina van Logius vindt u meer informatie.
  • Om informatie via de OSR API te kunnen bewerken kunt u contact opnemen met Kennisnet voor ondersteuning bij uw implementatie.
  • Onlangs is OSR API versie 3 uitgebracht om mandateren op bestuursniveau mogelijk te maken. Lees hier de vernieuwingen ten opzichte van de vorige versie.

OSR kwalificatie

Kwalificatie testplan OSR 2.2

Hotlinks

API-documentatie
OSR Omgevingen
OSR Dienstversies

Security

Kennisnet standaarden rondom
beveiligd gegevenstransport.

Ondersteuning

Begrippenlijst
Veelgestelde vragen