KNF:SSO notificatie middels een iframe

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken

Entree Federatie-symbol.png Entree Federatie: SSO notificatie middels een iframe

Het SSO notificatie cookie kan geplaatst worden door, nadat de gebruiker is ingelogd in de ELO of schoolportaal, een call vanuit een iframe naar Entree Federatie uit te voeren.

Voor de implementatie van de SSO notificatie functionaliteit kan het onderstaande script gebruikt worden. In dit script moet de waarde van twee variabelen worden aangepast:

  1. eloid: De unieke identifier waarmee de Identity Provider bekend is binnen Entree Federatie. Dit is het entityId uit de metadata van de Identity Provider. Eventueel kan de identifier ook worden opgevraagd bij Kennisnet.
  2. elourl: De URL van de ELO of schoolportaal waar de call vandaan komt. Dit wordt in de Entree Federatie applicatie gebruikt voor verificatie.

LET OP: Voordat de SSO notificatie wordt geïmplementeerd moet de URL van de ELO of schoolportaal waarvandaan de call wordt uitgevoerd (zie Foutmeldingen) toegevoegd worden aan de whitelist van Entree Federatie. Neem hiervoor contact op met Kennisnet.

<div id="ssonot"></div>

<script type="text/javascript" charset="utf-8">

   var eloid = '';       //EntityId
   var elourl = '';      //ELO URL

   function createCookie(name, value)
   {
      document.cookie = name+"="+value+"; path=/";
   }

   function readCookie(name)
   {
      var nameEQ = name + "=";
      var ca = document.cookie.split(';');
      for(var i=0;i < ca.length;i++) 
      {
         var c = ca[i];
         while (c.charAt(0)==' ')
            c = c.substring(1,c.length);
         if (c.indexOf(nameEQ) == 0)
            return c.substring(nameEQ.length,c.length);
      }
      return null;
   }

   if (readCookie('entreePrelogin') != 'true')
   {
      createCookie('entreePrelogin', 'true');
      document.getElementById('ssonot').innerHTML = '<iframe src="https://aselect.entree.kennisnet.nl/openaselect/profiles/entree?id='+eloid+'&url='+encodeURIComponent(elourl)+'">';
   }
</script>

Foutmeldingen

Als de ingestelde identifier van de IdP niet bekend is binnen Entree Federatie zal de call resulteren in een 400 HTTP status code.
Wanneer de URL waarvandaan de call gedaan wordt niet aan de whitelist van Entree Federatie is toegevoegd zal de call ook een 400 HTTP status code opleveren.
Neem in deze gevallen contact op met Kennisnet.