Brontekst bekijken van KNF:Azure AD Premium - Identity Provider

__TOC__
Deze handleiding bevat een stappenplan om een '''Azure AD Premium''' omgeving in te zetten als Identity Provider en aan Entree Federatie te koppelen.

'''Let op:''' Deze handleiding is niet geschikt voor de Gratis en Basic edities van Azure AD

Om aan de hand van deze handleiding een koppeling te kunnen realiseren moet aan de volgende voorwaarden worden voldaan:
#U heeft een werkende Azure AD Premium omgeving
#U heeft ervaring met het beheren van een Azure AD Premium omgeving
#U heeft zich als Identity Provider bij Entree Federatie aangemeld. U kunt zich aanmelden door het invullen van het formulier op: https://www.kennisnet.nl/entree-federatie/aanmelden/

{{Warn|Recent is de Azure AD omgeving gewijzigd, voor een handleiding verwijzen wij je naar de documentatie van Microsoft: https://docs.microsoft.com/en-us/azure/active-directory/active-directory-saas-custom-apps#adding-an-unlisted-application}}

==Stap 1: Configuratie van de koppeling==
Voor het maken van een koppeling moet een app geconfigureerd worden die via het SAML protocol de communicatie tussen Azure AD en Entree Federatie verzorgt. Een dergelijke app kan '''alleen''' met een Azure AD Premium omgeving geconfigureerd worden.

# Log in via https://portal.office.com.
# Open de Azure omgeving en ga naar ‘Admin center’
# Klik op ‘Azure Active directory’ en selecteerde directory die je wilt gebruiken.
# Klik op ‘App registrations’ en klik bovenaan het scherm op ‘New application registration’ om een nieuwe app aan te maken.<br/>[[Bestand:AzureADIdP01.png|border|600px]]<br/><br/>
# Vul in het veld ‘Name’ vervolgens ‘Entree Federatie’ in. Selecteer onder ‘Application type’ de optie ‘Web app / API’. <br/>[[Bestand:AzureADIdP03.png|border|600px]]<br/><br/>
# In het volgende veld wordt het endpoint van Entree Federatie geconfigureerd. <br/>'''Let op:''' De endpoints zijn verschillend voor de staging en de productie omgeving van Entree Federatie.
# Vul bij ‘Sign-on URL’ één van de volgende URL’s in:<br/>'''Staging:''' https://aselect-s.entree.kennisnet.nl/openaselect/profiles/saml/sp/sso/web<br/>'''Productie:''' https://aselect.entree.kennisnet.nl/openaselect/profiles/saml/sp/sso/web
# Klik vervolgens op ‘Create’.
#* Vul bij ‘Identifier’ één van de volgende waarden in:<br/>'''Staging:''' https://aselect-s.entree.kennisnet.nl<br/>'''Productie:''' https://aselect.entree.kennisnet.nl
#* Klik vervolgens op het pijltje onderaan om naar het volgende scherm te gaan.<br/>[[Bestand:AzureADIdP05.png|border|600px]]<br/><br/>
# De app is nu geconfigureerd om met Entree Federatie te communiceren. Echter Kennisnet moet ook Entree Federatie configureren om met de Azure AD omgeving te communiceren. Hiervoor is een metadata bestand nodig die de koppelingsgegevens van de de Azure AD omgeving beschrijft.
#* Klik op ‘Download Metadata (XML)’ en verstuur dit bestand naar Kennisnet.
#* Zet een vinkje bij ‘Confirm that you have configured single sign-on as described above. Checking this will enable the current certificate to start working for this application.’
#* Klik op het pijltje om naar het volgende scherm te gaan.<br/>[[Bestand:AzureADIdP06.png|border|600px]]<br/><br/>
# Klik op het vinkje ‘Complete’

De koppeling is nu geconfigureerd, in het volgende deel worden de attributen die worden doorgegeven gedefinieerd.

==Stap 2: Attributen definiëren==
Entree Federatie maakt onderscheid tussen '''‘standaard attributen’''' en '''‘aanvullende attributen’'''. De standaard attributen dienen altijd te worden doorgegeven door de Azure AD applicatie. Een overzicht van de attributen is te vinden op [[KNF:Attributen_overzicht_voor_Identity_Providers|Attributen overzicht]].

Sommige diensten die zijn aangesloten op Entree Federatie vragen naast de standaard attributen ook nog één of meerdere aanvullende attributen. In deze handleiding gaan we alleen uit van de standaard attributen, maar houd er rekening mee dat er meer attributen gedefinieerd moeten worden.

# Open de tab ‘Attributes’.
# Azure AD heeft de volgende attributen gedefinieerd:<br/>[[Bestand:AzureADIdP07.png|border|600px]]<br/><br/>
# Pas de attributen aan zodat ze gelijk zijn aan het onderstaande scherm.<br/>'''Let op:''' Er zijn twee waarden die moeten worden aangepast aan de eigen specifieke situatie.
#* '''nlEduPersonHomeOrganizationId:''' in het voorbeeld heeft dit veld de vaste waarde ‘SKNS’. Dit moet het BRIN nummer zijn van de school waarvoor de koppeling wordt gemaakt.
#* '''nlEduPersonHomeOrganization:''' in het voorbeeld heeft dit veld de vaste waarde ‘Kennisnet kantoor’. Dit moet de naam van de school zijn van de school waarvoor de koppeling wordt gemaakt.<br/>[[Bestand:AzureADIdP08.png|border|600px]]<br/><br/>

Een volledig overzicht van alle attributen is hier te vinden [[KNF:Attributen_overzicht_voor_Identity_Providers|Attributen overzicht]].

De app is nu geconfigureerd en de attributen zijn gedefinieerd. Nadat Kennisnet de koppeling heeft geconfigureerd op basis van het metadata XML bestand kan de koppeling getest worden.

==Stap 3: Testen==
Om de koppeling te testen kan gebruik gemaakt worden van de referentie Service Provider van Kennisnet. Na een succesvolle authenticatie via de Azure AD worden de aan de referentie SP doorgegeven attributen getoond.

# Ga naar de Kennisnet referentie Service Provider.<br/>'''Staging:''' https://referentie-s.entree.kennisnet.nl/referentiesp<br/>'''Productie:''' https://referentie.entree.kennisnet.nl/referentiesp
# Je wordt nu doorgestuurd naar het WAYF ('''W'''here '''A'''re '''Y'''ou '''F'''rom) scherm van Entree Federatie.
# Zoek de school waarmee je wilt inloggen.<br/>[[Bestand:Wayf01.PNG|border|400px]]<br/><br/>
# Selecteer de school en klik op ‘Verder’. Je wordt nu doorgestuurd naar de Azure AD omgeving die bij de school hoort.
# Log in op de Azure AD omgeving.
# Hierna wordt je teruggestuurd naar de referentie Service Provider en krijg je een overzicht van de attributen die zijn ontvangen.<br/>[[Bestand:refsp.png|border|600px]]<br/><br/>

Mocht er in dit scenario iets fout gaan neem dan contact op met Kennisnet.