OSR:Hoofdpagina: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
Geen bewerkingssamenvatting
kGeen bewerkingssamenvatting
 
(113 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:
{|
*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.
|- style="vertical-align:top"
*De [[KVS:Hoofdpagina|Kennisnet Validatie Service (KVS)]] maakt formeel geen onderdeel uit van OSO, maar wordt binnen OSO wel toegepast.
| De voorziening 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>
Het register kan door iedereen met een PKI-overheidscertificaat/ODOC certificaat worden geraadpleegd.<br><br>


De volgende generieke user stories worden door de OSR API ondersteund:<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.
[[OSR:API/V2/Opvragen_informatie_over_onderwijsinstelling|1. Als API-gebruiker wil ik informatie over een onderwijsinstelling opvragen]]<br>
* Op deze pagina is een overzicht van aangesloten scholen te vinden: [http://www.overstapserviceonderwijs.nl/gebruik-oso/overzicht-scholen-met-oso/]
Ophalen van schoolinformatie en bijbehorende bestuursinformatie. Hier kan specifiek gezocht worden naar een school.<br>
*Op deze [[https://www.overstapserviceonderwijs.nl/overzicht-aangesloten-administratiesystemen/ pagina]] is een overzicht van aangesloten systemen te vinden.


{{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]}}
[[OSR:API/V2/Opvragen_informatie_over_dienst|2. Als API-gebruiker wil ik informatie over een dienst of dienstversie opvragen]]<br>
Ophalen van informatie over een dienst of dienstversie. Hier kan specifiek gezocht worden op een (deel van) de dienstnaam.<br>


{| cellspacing="10" cellpadding="5" border="0" width="90%"
[[OSR:API/V2/Valideren_mandaat|3. Als API-gebruiker wil ik het mandaat van een systeem valideren]]<br>
|- valign="top"
Verifiëren of de onderwijsinstelling een mandaat heeft afgegeven aan een systeem.<br>
| style="width:60%" |


=== OSO specificatie ===
[[OSR:API/V2/Opvragen_endpoints|4. Als API-gebruiker wil ik een endpoint opvragen]]<br>
[[OSO:Releases/2018-01|Wijzigingen in OSO'18''']]<br>
Ophalen van endpoints van een onderwijsinstelling of routeringskenmerk voor een bepaalde dienstversie.<br>


[[OSR:API/V2/toevoegen_en_wijzigen_van_endpoints|5. Als API-gebruiker wil ik een endpoint toevoegen of wijzigen]]<br>
Endpoints aanmaken en wijzigen door een gemandateerd systeem.<br> 


{{Info|
Momenteel werken we aan een nieuwe versie van de API om ook mandateren op bestuursniveau mogelijk te maken.<br>
Bekijk [[OSR:API/V2/API_V2_naar_V3_wijzigingen|hier]] de veranderingen ten opzichte van de huidige versie.
}}


[[OSO:2018/Algemene_Eisen|Algemene eisen]]<br>
| style="padding-left:4em" |
[[OSO:2018/Inhoudelijke_Eisen|Inhoudelijke eisen]]<br>
=== OSR kwalificatie ===
[[OSO:2018/Specifieke_Eisen|Functionele eisen]]<br>
[[:File:Kwalificatie test plan OSR.pdf|Kwalificatie test plan OSR 2.2]]
[[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 ===
[https://osr.kennisnet.nl/api/v2/documentation API documentatie]<br/>
[[OSR:omgevingen|OSR Omgevingen]]<br/>
[[OSR:dienst-versies|OSR Dienst versies]]


=== Hotlinks ===
=== Security ===
* [[OSO:2018/Omgevingen|Omgevingen + WSDL]]
 
Kennisnet standaarden rondom<br>[https://developers.wiki.kennisnet.nl/index.php?title=Standaarden:Beveiligd_Gegevenstransport beveiligd gegevenstransport].


=== OSO'18 Test ===
=== Ondersteuning ===
*[[OSO:2018/Testplanning_leveranciers|Testplanning]]
*[[OSO:2018/Testplannen|Testplannen]]
*[[OSO:2018/Leverancier/Testschool|Testschool]]


=== Externe informatiebronnen ===
[[OSR:Begrippenlijst|Begrippenlijst]]<br>
* [https://www.edustandaard.nl/standaarden/afspraken/afspraak/oso-gegevensset/2017.1/ EduStandaard OSO (dossier standaard)]
[[OSR:Veelgestelde_vragen|Veelgestelde vragen]]
*[[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 20 mrt 2025 om 16:46


De voorziening 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.
Het register kan door iedereen met een PKI-overheidscertificaat/ODOC certificaat worden geraadpleegd.

De volgende generieke user stories worden door de OSR API ondersteund:

1. Als API-gebruiker wil ik informatie over een onderwijsinstelling opvragen
Ophalen van schoolinformatie en bijbehorende bestuursinformatie. Hier kan specifiek gezocht worden naar een school.

2. Als API-gebruiker wil ik informatie over een dienst of dienstversie opvragen
Ophalen van informatie over een dienst of dienstversie. Hier kan specifiek gezocht worden op een (deel van) de dienstnaam.

3. Als API-gebruiker wil ik het mandaat van een systeem valideren
Verifiëren of de onderwijsinstelling een mandaat heeft afgegeven aan een systeem.

4. Als API-gebruiker wil ik een endpoint opvragen
Ophalen van endpoints van een onderwijsinstelling of routeringskenmerk voor een bepaalde dienstversie.

5. Als API-gebruiker wil ik een endpoint toevoegen of wijzigen
Endpoints aanmaken en wijzigen door een gemandateerd systeem.
 

Info.gif

Momenteel werken we aan een nieuwe versie van de API om ook mandateren op bestuursniveau mogelijk te maken.
Bekijk hier de veranderingen ten opzichte van de huidige versie.

OSR kwalificatie

Kwalificatie test plan OSR 2.2

Hotlinks

API documentatie
OSR Omgevingen
OSR Dienst versies

Security

Kennisnet standaarden rondom
beveiligd gegevenstransport.

Ondersteuning

Begrippenlijst
Veelgestelde vragen

Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=OSR:Hoofdpagina&oldid=13095"