Entree Federatie-koppeling laten maken
Entree Federatie is de dienst van Kennisnet waarmee leerlingen en leraren in het po, vo en mbo met één login toegang krijgen tot digitale leermiddelen en educatieve diensten. De school logt in via haar eigen elo of schoolaccount, en Entree geeft door wie er inlogt. Voor een aanbieder van lesmateriaal of een educatieve app betekent dat één koppeling in plaats van een koppeling per school. Appfront bouwt die koppeling: uw dienst aangesloten als service provider, met de juiste attributen en rollen, getest en klaar voor productie.
Wat is een koppeling met Entree Federatie?
Een Entree Federatie-koppeling sluit uw dienst aan op de federatie van Kennisnet. Een leerling of leraar start bij uw dienst, kiest zijn school, logt in bij de elo of het schoolaccount van die school, en komt terug met een set attributen. Standaard zijn dat een versleutelde gebruikers-id, de voornaam, de rol (student, employee, staff of affiliate), het BRIN-nummer en de naam van de instelling, en optioneel het ECK iD. Aanvullende attributen, zoals achternaam, e-mailadres, klas of groep, krijgt u alleen als de school daar via Mijn Entree Federatie uitdrukkelijk toestemming voor geeft.
Zonder koppeling beheert u per school accounts en wachtwoorden. Leerlingen vergeten hun wachtwoord, leraren maken klassen met de hand aan, en elke nieuwe school betekent een nieuwe lijst. Via Entree Federatie logt een gebruiker één keer in voor de hele dag, met het account dat de school al heeft. Onder meer Magister, SOMtoday, itslearning, Moodle-omgevingen en schoolomgevingen op Azure AD of ADFS zijn volgens Kennisnet al aangesloten als identity provider.
Wij bouwen maatwerk omdat elke dienst andere gegevens nodig heeft en anders is gebouwd. Welke attributen u echt nodig hebt, hoe u een gebruiker koppelt aan een school, klas of licentie, of u SAML of OpenID Connect gebruikt en of uw dienst meerdere klanten in één omgeving bedient, bepaalt hoe de koppeling werkt. Kennisnet publiceert de technische documentatie voor dienstaanbieders openlijk op de Developers-wiki, met metadata voor staging en productie en een Referentie Identity Provider om te testen. Daar bouwen we op.
Eén login
Het account van de school.
Minimaal
Alleen de nodige attributen.
Goed getest
Eerst staging, dan productie.
Hoe wij uw koppeling met Entree Federatie bouwen
We beginnen bij uw dienst: hoe gebruikers nu inloggen, welke gegevens u van hen nodig hebt, hoe u scholen en licenties beheert en op welke techniek uw dienst draait. Daarna bouwen we de koppeling op de stagingomgeving van Entree Federatie en testen we met de Referentie Identity Provider, met standaard- en aanvullende attributen en met verschillende rollen. Als dat klopt, meldt u de dienst aan voor productie en gaan de eerste scholen live. Daarna houden we de koppeling bij, onder meer bij certificaatvernieuwing en wijzigingen in de federatie.
Gebruikers, gegevens, techniek.
Testen met de referentie-IdP.
Aanmelden en eerste scholen.
Livegang, bewaking, en beheer bij wijzigingen.
Wat een koppeling met Entree Federatie concreet doet
De onderdelen hieronder komen in vrijwel elke koppeling met Entree Federatie terug. Welke u nodig hebt, hangt af van uw dienst en van de gegevens die u van scholen vraagt.
Inloggen
SAML of OpenID Connect.
Attributen
Standaard en aanvullend.
Rollen
Leerling, leraar, medewerker.
Klassen
Groepen uit de school.
ECK iD
Optioneel pseudoniem.
Metadata
Certificaten bijgehouden.
Voor wie wij een koppeling met Entree Federatie bouwen
De koppeling is bedoeld voor aanbieders die hun dienst beschikbaar willen maken voor scholen in het po, vo en mbo, zonder per school accounts te beheren. Hoe meer scholen u bedient, hoe meer het oplevert.
Uitgeverijen
Digitaal lesmateriaal.
Educatieve apps
Oefenen en toetsen.
Platforms
Meerdere klanten in één omgeving.
Nieuwe aanbieders
Vanaf de eerste school.
Technologie en koppelingen
Deze pagina gaat over Entree Federatie voor het po, vo en mbo. Voor het hoger onderwijs en onderzoek is er onze pagina over de SURFconext-integratie; hebt u gegevens uit de leerlingadministratie nodig, kijk dan naar onze pagina's over de Magister-koppeling en de Somtoday-koppeling, en voor berichtenverkeer tussen systemen in het onderwijs onze pagina over Edukoppeling. Onze werkwijze leest u op software laten maken.
Waarom Appfront voor uw koppeling met Entree Federatie?
Een leerling die op maandagochtend niet kan inloggen, een dienst die meer persoonsgegevens vraagt dan nodig is, of een koppeling die stopt bij de vernieuwing van een certificaat, kost een aanbieder het vertrouwen van scholen. Daar bouwen we op: alleen de attributen die u nodig hebt, goed getest op staging, en een koppeling die wordt bijgehouden als de federatie verandert.
Minimaal
Alleen nodige gegevens.
Getest
Eerst op staging.
Bijgehouden
Ook bij certificaatwissel.
Security en privacy bij een koppeling met Entree Federatie
De koppeling verwerkt persoonsgegevens van leerlingen en leraren, vaak minderjarigen, en die vallen onder de AVG en het Privacyconvenant onderwijs. Hij vraagt alleen de attributen die uw dienst nodig heeft, slaat niet meer op dan nodig is en legt elke aanmelding met tijd en resultaat vast.
De koppeling draait in een Europees datacenter, met versleutelde verbindingen. Sleutels en certificaten staan afgeschermd en zijn niet zichtbaar voor medewerkers. Na aanmelding sluit u als leverancier de gebruiksvoorwaarden van Kennisnet af; welke afspraken u daarnaast met scholen maakt, bekijken we met u.
Veelgestelde vragen over een koppeling met Entree Federatie
Vragen die uitgevers, aanbieders van leermiddelen en productmanagers in het onderwijs stellen voordat ze hiermee beginnen.
Een dienst van Kennisnet waarmee leerlingen en leraren in het po, vo en mbo met één login toegang krijgen tot digitale leermiddelen en educatieve diensten. De gebruiker logt in met zijn schoolaccount of een Entree-account, en Entree geeft door wie er inlogt.
SURFconext is de federatie van SURF voor het hoger onderwijs en onderzoek. Entree Federatie is er voor het po, vo en mbo. Een dienst die beide doelgroepen bedient, sluit op beide aan; de aanpak lijkt op elkaar, de attributen en afspraken verschillen.
Entree Federatie ondersteunt beide. OpenID Connect is volgens Kennisnet eenvoudiger te integreren, vooral in mobiele apps. SAML ligt voor de hand als uw dienst al een SAML-bibliotheek gebruikt, bijvoorbeeld SimpleSAMLphp of Shibboleth.
Standaard een versleutelde gebruikers-id, de voornaam, de rol, het BRIN-nummer en de naam van de school, en optioneel het ECK iD. Aanvullende attributen, zoals achternaam, e-mailadres of klas, krijgt u alleen als de school daar uitdrukkelijk toestemming voor geeft.
Kennisnet biedt een stagingomgeving en een Referentie Identity Provider, waarmee u het inloggen van een gebruiker nabootst en zelf de attributen kiest die terugkomen. Zo testen we rollen en aanvullende attributen voordat de eerste school live gaat.
De gebruiker krijgt een duidelijke melding in plaats van een technische fout, en de koppeling legt de aanmelding met de reden vast. Zo ziet u of het aan uw dienst, de school of de federatie ligt.
Voor aanbieders met veel scholen of een dienst met eigen regels voor licenties, klassen en rollen, en voor platforms die meerdere klanten in één omgeving bedienen. Gebruikt uw dienst al een standaardpakket met ingebouwde ondersteuning voor Entree, dan is configureren vaak genoeg.
Uw dienst aansluiten op Entree Federatie?
Vertel ons hoe gebruikers nu inloggen en welke gegevens u van scholen nodig hebt. We laten zien hoe een koppeling met Entree Federatie dat regelt.