OSR:Hoofdpagina: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
 
(86 tussenliggende versies door 3 gebruikers niet weergegeven)
Regel 1: Regel 1:
 
__NOTOC__
 
__NOTOC__
De voorziening Onderwijs Serviceregister (OSR) zal de rol van “telefoonboek” voor de onderwijsketen vervullen. <br>
 
In het OSR worden de relatie tussen scholen, leveranciers en diensten vastgelegd. Hiermee zal het OSR een standaardoplossing bieden omtrent routerings- en autorisatievraagstukken. <br>
 
Het register kan door iedereen met een PKI-overheidscertificaat worden geraadpleegd.<br><br>
 
   
  +
{|
De volgende services worden door het OSR aangeboden: <br>
 
  +
|- style="vertical-align:top"
 
| 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>
[[OSR:2019/Opvragen_onderwijsinstelling|Opvragen onderwijsinstelling]]<br>
 
  +
  +
[[OSR:API/V2/Opvragen_informatie_over_onderwijsinstelling|1. Als API-gebruiker wil ik informatie over een onderwijsinstelling opvragen]]<br>
 
Ophalen van schoolinformatie en bijbehorende bestuursinformatie. Hier kan specifiek gezocht worden naar een school.<br>
 
Ophalen van schoolinformatie en bijbehorende bestuursinformatie. Hier kan specifiek gezocht worden naar een school.<br>
   
  +
[[OSR:API/V2/Opvragen_informatie_over_dienst|2. Als API-gebruiker wil ik informatie over een dienst of dienstversie opvragen]]<br>
[[OSR:2019/Opvragen_mandaten|Opvragen mandaten]]<br>
 
  +
Ophalen van informatie over een dienst of dienstversie. Hier kan specifiek gezocht worden op een (deel van) de dienstnaam.<br>
Voordat een leverancier een endpoint kan aanmaken voor de dienst en onderwijsinstelling, is het nodig om te verifiëren of de onderwijsinstelling een mandaat heeft aangemaakt voor de leverancier.<br>
 
   
  +
[[OSR:API/V2/Valideren_mandaat|3. Als API-gebruiker wil ik het mandaat van een systeem valideren]]<br>
[[OSR:2019/Opvragen_endpoints|Opvragen endpoints]]<br>
 
  +
Verifiëren of de onderwijsinstelling een mandaat heeft afgegeven aan een systeem.<br>
Iedereen met een PKI-overheidscertificaat kan de endpoints ophalen van een onderwijsinstelling/adminstratiekenmerk voor een bepaalde dienstversie.<br>
 
Het endpoint omvat informatie zoals het afleveradres(technische url) van de gekoppelde leverancier, ingangsdatum, einddatum etc.. <br>
 
   
  +
[[OSR:API/V2/Opvragen_endpoints|4. Als API-gebruiker wil ik een endpoint opvragen]]<br>
[[OSR:2019/toevoegen_wijzigen_endpoints|Toevoegen/wijzigen endpoints]]<br>
 
De leverancier is gemandateerd voor de dienst door de onderwijsinstelling. Met een token kan een endpoint worden aangemaakt, danwel gewijzigd.<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>
<br><br>
 
  +
Endpoints aanmaken en wijzigen door een gemandateerd systeem.<br> 
De volgende services zijn nog niet beschikbaar, maar de verwachting is dat deze binnenkort worden toegevoegd:
 
 
| style="padding-left:4em" |
 
 
  +
=== OSR kwalificatie ===
 
 
  +
[[:File:Kwalificatie test plan OSR.pdf|Kwalificatie test plan OSR 2.2]]
<br>
 
Opvragen diensten
 
<br>
 
Opvragen dienstversies 
 
<br>
 
Opvragen leveranciers 
 
<br>
 
   
 
=== Hotlinks ===
  +
[https://osr.kennisnet.nl/api/v2/documentation API documentatie]<br/>
  +
[[OSR:omgevingen|OSR Omgevingen]]<br/>
  +
[[OSR:dienst-versies|OSR Dienst versies]]
   
  +
== Security ==
   
  +
Kennisnet standaarden rondom<br>[https://developers.wiki.kennisnet.nl/index.php?title=Standaarden:Beveiligd_Gegevenstransport beveiligd gegevenstransport].
{| cellspacing="10" cellpadding="5" border="0" width="90%"
 
|- valign="top"
 
| style="width:60%" |
 
 
=== OSO specificatie ===
 
[[OSO:Releases/2018-01|Wijzigingen in OSO'18''']]<br>
 
 
 
 
[[OSO:2018/Algemene_Eisen|Algemene eisen]]<br>
 
[[OSO:2018/Inhoudelijke_Eisen|Inhoudelijke eisen]]<br>
 
[[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 ===
 
{{ComItem|Homepage|api documentatie|https://osr-sb.kennisnet.nl/api/v1/doc}}
 
{{ComItem|Homepage|jwt.io|https://jwt.io/}}
 
   
=== OSO'18 Test ===
+
=== Ondersteuning ===
*[[OSO:2018/Testplanning_leveranciers|Testplanning]]
 
*[[OSO:2018/Testplannen|Testplannen]]
 
*[[OSO:2018/Leverancier/Testschool|Testschool]]
 
   
  +
[[OSR:Begrippenlijst|Begrippenlijst]]<br>
=== Externe informatiebronnen ===
 
 
[[OSR:Veelgestelde_vragen|Veelgestelde vragen]]
* [https://www.edustandaard.nl/standaarden/afspraken/afspraak/oso-gegevensset/2017.1/ EduStandaard OSO (dossier standaard)]
 
*[[KVS:Hoofdpagina|Kennisnet Validatie Service]]
 
* [[OSO:2017/Woordenlijst|Woordenlijst]]
 
   
  +
[[Category:OSR]]
=== Communicatie ===
 
{{ComItem|Homepage|Overstap Service Onderwijs site|http://www.overstapserviceonderwijs.nl/}}
 
{{ComItem|Rss|Atom Feed wijzigingen OSO wiki|{{Rsslink}}}}
 
|}
 

Huidige versie van 8 feb 2023 om 10:18


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.
 

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