KNF:Service provider koppeling testen: verschil tussen versies

Huidige versie van 28 okt 2019 om 11:01

Om tijdens de implementatie van een koppeling met Entree Federatie te testen, kan gebruik gemaakt worden van de Referentie Identity Provider. Met behulp van deze applicatie wordt het inloggen van een gebruiker via bijvoorbeeld een Elektronische Leeromgeving gesimuleerd.

Stap 1: Start authenticatie

Ga in een verse browser naar de pagina van je applicatie waar ingelogd kan worden via Entree Federatie en start hier het authenticatie proces.

Stap 2: Selectie Identity Provider

Je wordt nu geredirect naar het WAYF-scherm (Where Are You From) van Entree Federatie.

Typ in de zoekbox 'referentie'.

Selecteer vervolgens 'Referentie Omgeving' en klik op 'Verder'.

Stap 3: Referentie Identity Provider

Je wordt nu geredirect naar de Referentie Identity Provider van Entree Federatie. Je ziet hier een lijst met attributen die zullen worden teruggestuurd naar je applicatie. De attributen zijn onderverdeeld in een set Standaard attributen en Aanvullende attributen (hier vind je een overzicht van de attributen).

Standaard attributen worden altijd door Entree Federatie aan de Service Provider doorgegeven.
Aanvullende attributen worden alleen aan de Service Provider doorgegeven indien de school ervoor expliciet toestemming heeft gegeven via een ondertekende Attribute Release Policy.

Indien gewenst kan je de attributen aanpassen.
Let op: Om aanvullende attributen te kunnen gebruiken via de Referentie Identity Provider moet dit geconfigureerd worden. Neem hiervoor contact op met Kennisnet.

Stap 4: Versturen attributen

Nadat je de attributen eventueel hebt aangepast klik je op 'Direct verder naar dienstaanbieder' bovenaan de pagina of 'Verder naar dienstaanbieder' onderaan de pagina. Het authenticatie bericht met daarin de attributen wordt nu naar je applicatie verstuurd. Deze kan nu op basis van de attributen de gebruiker identificeren en autoriseren.

Vanuit de Referentie omgeving testen

Ga in een verse browser naar de Referentie applicatie van Entree Federatie:

Voor de Entree Federatie productie omgeving: https://referentie.entree.kennisnet.nl/referentie
Voor de Entree Federatie staging omgeving: https://referentie-s.entree.kennisnet.nl/referentie

@@ Regel 3: / Regel 3: @@
 __TOC__
-Tijdens de implementatie van een koppeling met Entree Federatie te testen kan gebruik gemaakt worden van de Referentie Identity Provider.
+Om tijdens de implementatie van een koppeling met Entree Federatie te testen, kan gebruik gemaakt worden van de Referentie Identity Provider. Met behulp van deze applicatie wordt het inloggen van een gebruiker via bijvoorbeeld een Elektronische Leeromgeving gesimuleerd.
 ==Stap 1: Start authenticatie==
-Ga in een verse browser naar de pagina van je applicatie waar de ingelogd kan worden via Entree Federatie. Start hier het authenticatie proces.
+Ga in een verse browser naar de pagina van je applicatie waar ingelogd kan worden via Entree Federatie en start hier het authenticatie proces.
 ==Stap 2: Selectie Identity Provider==
 Je wordt nu geredirect naar het WAYF-scherm ('''W'''here '''A'''re '''Y'''ou '''F'''rom) van Entree Federatie.
-Kies nu op 'Log in met je schoolaccount'.
 [[File:Wayf01.PNG|400px|left]]<br clear="all">
+<br/>
-In het uitklapscherm zie je een lijst met scholen (en de daarbij behorende Identity Providers)
+Typ in de zoekbox 'referentie'.
-[[File:Wayf02.png|600px|left]]<br clear="all">
+[[File:Wayf_referentie_01.PNG|400px|left]]<br clear="all">
-Typ in de zoekbox 'referentie' en selecteer vervolgens de eerste 'Referentie KO' en klik op 'Verder'
+<br/>
+Selecteer vervolgens 'Referentie Omgeving' en klik op 'Verder'.
+[[File:Wayf_referentie_02.PNG|400px|left]]<br clear="all">
+<br/>
-==Step 2: Referentie Identity Provider==
+==Stap 3: Referentie Identity Provider==
+Je wordt nu geredirect naar de '''Referentie Identity Provider''' van Entree Federatie. Je ziet hier een lijst met attributen die zullen worden teruggestuurd naar je applicatie.
+De attributen zijn onderverdeeld in een set '''Standaard attributen''' en '''Aanvullende attributen''' ([[KNF:Attributen_overzicht_voor_Service_Providers|hier vind je een overzicht van de attributen]]).
+* Standaard attributen worden altijd door Entree Federatie aan de Service Provider doorgegeven.
+* Aanvullende attributen worden alleen aan de Service Provider doorgegeven indien de school ervoor expliciet toestemming heeft gegeven via een ondertekende [https://support.kennisnet.org/Knowledgebase/Article/View/511 Attribute Release Policy].
+[[File:Referentie_Identity_Provider_01.PNG|600px|left]]<br clear="all">
+<br/>
+Indien gewenst kan je de attributen aanpassen.
+<br/>
+'''Let op:''' Om aanvullende attributen te kunnen gebruiken via de Referentie Identity Provider moet dit geconfigureerd worden. Neem hiervoor contact op met [https://support.kennisnet.org/Tickets/Submit Kennisnet].
+==Stap 4: Versturen attributen==
+Nadat je de attributen eventueel hebt aangepast klik je op 'Direct verder naar dienstaanbieder' bovenaan de pagina of 'Verder naar dienstaanbieder' onderaan de pagina.
+Het authenticatie bericht met daarin de attributen wordt nu naar je applicatie verstuurd. Deze kan nu op basis van de attributen de gebruiker identificeren en autoriseren.
+==Vanuit de Referentie omgeving testen==
+Ga in een verse browser naar de Referentie applicatie van Entree Federatie:
+* Voor de Entree Federatie productie omgeving: https://referentie.entree.kennisnet.nl/referentie
+* Voor de Entree Federatie staging omgeving: https://referentie-s.entree.kennisnet.nl/referentie
-- Je komt nu op onze referentie ELO omgeving, deze is om te simuleren hoe een gebruiker inlogt op zijn of haar ELO
-- Je ziet een formulier met een aantal ingevulde attributen die naar de applicatie van Basisacademie worden gestuurd. Je kan deze eventueel aanpassen, maar ook laten zoals ze zijn.
-- Als je nu op 'Naar dienst' klikt ga je terug naar Basisacademie en worden deze attributen meegezonden.
-- De applicatie van Basisacademie kan deze attributen nu gebruiken om de gebruiker te identificeren en toegang te verlenen.