KNF:Azure AD Premium - Identity Provider

Uit Kennisnet Developers Documentatie
Versie door Holierhoek01 (overleg | bijdragen) op 10 jul 2020 om 09:00 (Stap 1: Configuratie van de koppeling)
Ga naar: navigatie, zoeken

Entree Federatie-symbol.png Entree Federatie: Azure AD Premium - Identity Provider

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:

  1. U heeft een werkende Azure AD Premium omgeving
  2. U heeft ervaring met het beheren van een Azure AD Premium omgeving
  3. 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.gif 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.

  1. Ga naar https://admin.microsoft.com/
  2. Klik op 'Show All' en vervolgens 'Azure active Directory'
  1. Klik op 'Enterprise applications'
  2. Klik op '+ New application'
  3. Kies Non-Gallery Application
  4. Geef als naam op Entree Federatie staging of productie
  5. Kies na creëren 'Set up single sign on'
  6. Kies SAML
  7. Edit 'Basic SAML Configuration
  8. Vul bij Identifier in :
  9. Reply URL:
  10. Sign on URL:
  11. 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.

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 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.

  1. Open de tab ‘Attributes’.
  2. Azure AD heeft de volgende attributen gedefinieerd:
    AzureADIdP07.png

  3. Pas de attributen aan zodat ze gelijk zijn aan het onderstaande scherm.
    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.
      AzureADIdP08.png

Een volledig overzicht van alle attributen is hier te vinden 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.

Session tokens

Azure AD levert session tokens met een onbeperkte levensduur, in tegenstelling tot AD FS, waarbij de session tokens na 8 uren verlopen. Dit kan tot inlogproblemen leiden bij aangesloten diensten die een eigen session timeout kennen.

Met behulp van onderstaande documentatie van Microsoft is het mogelijk de waarden MaxAgeSessionSingleFactor en MaxAgeSessionMultiFactor in te stellen op 8 uren. https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-configurable-token-lifetimes

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.

  1. Ga naar de Kennisnet referentie Service Provider.
    Staging: https://referentie-s.entree.kennisnet.nl/referentiesp
    Productie: https://referentie.entree.kennisnet.nl/referentiesp
  2. Je wordt nu doorgestuurd naar het WAYF (Where Are You From) scherm van Entree Federatie.
  3. Zoek de school waarmee je wilt inloggen.
    Wayf01.PNG

  4. Selecteer de school en klik op ‘Verder’. Je wordt nu doorgestuurd naar de Azure AD omgeving die bij de school hoort.
  5. Log in op de Azure AD omgeving.
  6. Hierna wordt je teruggestuurd naar de referentie Service Provider en krijg je een overzicht van de attributen die zijn ontvangen.
    Refsp.png

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