Wat is Eduarte Connect

Eduarte Connect is het platform waarmee scholen en hun partners op een moderne, veilige en AVG-proof manier koppelen met Eduarte. Connect vervangt stap voor stap de oudere webservices en de vrije databasetoegang door gestandaardiseerde REST-API’s met heldere afspraken over beveiliging, eigenaarschap van data en gebruik.

Het doel van Connect is drieledig:

• Voor scholen: moderne koppelingen, grip op welke partij welke gegevens ontvangt (AVG), inzicht in het gebruik, en doorontwikkeling op basis van standaarden.
• Voor partners: een duidelijke overeenkomst en SLA, een eigen ontwikkelomgeving, support vanuit Eduarte, en zichtbaarheid richting scholen.

Voor wie & wat het oplevert

Connect bedient twee hoofddoelgroepen.

Scholen krijgen:

• AVG-inzage: inzicht in welke partner welke gegevens afneemt;
• regie via consent: koppelingen worden bewust toegestaan;
• inzicht in het daadwerkelijke gebruik van koppelingen;
• een “etalage” met beschikbare, standaard koppelingen.

Partners krijgen:

• een partnerovereenkomst en SLA;
• eenvoudige aansluiting en een eigen ontwikkelomgeving wanneer nodig;
• documentatie en developer-support;
• zichtbaarheid in de etalage richting scholen.

Soorten koppelingen

Binnen Connect onderscheiden we vier koppelvormen:

1. Standaard partnerkoppelingen — domeinspecifieke koppelingen met bekende partners, doorgaans tweerichtings (lezen én schrijven), bijvoorbeeld BPV, Document Management en Examens.
2. Generieke basisdata & ESB provisioning — basisgegevens (opleidingen, organisatie, deelnemers, verbintenissen, groepen, medewerkers) waarmee scholen hun eigen systemen voeden.
3. Legacy webservices — de oudere webservices, die in de komende jaren rustig aan worden uitgefaseerd.
4. Databasetoegang voor rapportage — directe gegevenstoegang uitsluitend ten behoeve van rapportage.

Naamgeving: O, E en I

De eerste letter van een connectorcode geeft het type aan:

• O — een externe standaard: de officiële specificatie wordt buiten Eduarte beheerd. Meestal is dat een onderwijsstandaard die sectorbreed geldt en op landelijk niveau wordt beheerd (OOAPI-gebaseerd, Engelstalig), zoals OKD en OKE. Het kan ook een bredere, internationale standaard zijn, zoals SCIM 2.0 voor identiteits- en accountprovisioning. In beide gevallen beschrijft deze documentatie de koppeling zoals geïmplementeerd in Eduarte Connect en verwijst zij voor de volledige standaard naar de officiële bron. Een internationale standaard houdt zijn eigen naam als connectorcode (SCIM) in plaats van een OKxx-code; daar gaat de regel over de eerste letter dus niet op.
• E — een Eduarte-specifieke koppeling, door Topicus Eduarte gedefinieerd voor het product Eduarte (Nederlandstalig, minder gestandaardiseerd maar specifieker). Dit is de hoofdmoot van Connect.
• I — interne koppelingen, uitsluitend voor Eduarte zelf; deze vallen buiten deze documentatie.

Overzicht connectoren

OKx is een aangekondigde koppeling en nog niet beschikbaar: er is nog geen technische specificatie en geen OpenAPI. Zie het productdocument voor wat er nu bekend is.

Naast de connectoren kent Connect twee aanvullende categorieën: de Eduarte Legacy Webservices (in uitfasering) en de Eduarte Reporting service (gegevenstoegang voor rapportage).

Aansluiten op Connect

Aansluiten verloopt op hoofdlijnen als volgt:

1. Aanvraag — een school of partner geeft aan welke koppeling(en) gewenst zijn.
2. Afspraken — toegang wordt vastgelegd; voor partners via een overeenkomst en SLA, voor scholen via consent op de betreffende koppeling.
3. Toegang & credentials — de aansluitende partij ontvangt OAuth2-clientgegevens en de bijbehorende scope(s).
4. Ontwikkelen & testen — er is een ontwikkel-/testomgeving beschikbaar om de integratie te bouwen en te beproeven voordat deze in productie gaat.
5. Support — vragen en meldingen lopen via Eduarte (connect@eduarte.nl).

Voor partners

Voor partners gelden enkele specifieke afspraken:

• Overeenkomst — er is een partnerovereenkomst met een SLA waarin beschikbaarheid, support en wederzijdse verantwoordelijkheden zijn vastgelegd. De partner betaalt per koppeling; de school wordt hiervoor niet belast.
• Beschikbaar stellen van een ontwikkelomgeving — Eduarte stelt waar nodig een developer-/testomgeving beschikbaar zodat de partner de koppeling kan bouwen en testen zonder productiegegevens.
• Support — partners krijgen documentatie en developer-support, en zijn zichtbaar in de etalage richting scholen.

Gemeenschappelijke principes

Alle Connect-koppelingen delen dezelfde technische uitgangspunten:

• REST & JSON als architectuur en formaat.
• Beveiliging via OAuth 2.0 (Client Credentials) over HTTPS, met scopes per koppeling.
• Vertrouwelijk alle data word alleen versleuteld verstuurd.
• Versionering volgens SemVer, met de major-versie in het pad.
• AVG & consent — gegevens worden alleen gedeeld waar dit is toegestaan, volgens het principe van dataminimalisatie.

De precieze invulling per koppeling staat in de bijbehorende technische specificatie.

Deze documentatie lezen

De Connect-documentatie bestaat per koppeling uit twee documenten:

• een productdocument (functioneel) — doel, domein, reikwijdte en functionele flows, bedoeld voor business- en projectrollen;
• een technische specificatie — beveiliging, conventies, foutafhandeling, throttling en beschikbaarheid, bedoeld voor developers.

De volledige, interactieve technische referentie (de gerenderde OpenAPI-specificaties) is de canonieke bron en staat op de documentatiesite. De PDF’s vatten samen en verwijzen daarheen voor de details per endpoint.

Begrippen & afkortingen

Afkortingen

Begrippen