KNF:SSO notificatie middels een iframe: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
Regel 1: Regel 1:
  +
Het SSO notificatie cookie kan geplaats worden door call vanuit een iframe naar Entree Federatie uit te voeren, nadat de gebruiker is ingelogd in de ELO of schoolportaal.<br>
== Implementatie door middel van een iframe: ==
 
Voor het implementeren van een SSO notificatie kan het onderstaande script gebruikt worden.
 
   
 
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:
'''Daarnaast moet de Elo URL worden geregistreerd bij Kennisnet, zodat deze kan worden toegevoegd aan de white list, geef deze daarom door aan Kennisnet!!'''
 
  +
# '''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 [https://support.kennisnet.org/Tickets/Submit Kennisnet].
  +
# '''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 punt 2) toegevoegd worden aan de whitelist van Entree Federatie. Neem hiervoor contact op met [https://support.kennisnet.org/Tickets/Submit Kennisnet].
   
 
<syntaxhighlight lang="php">
 
<syntaxhighlight lang="php">
Regel 40: Regel 43:
 
</syntaxhighlight>
 
</syntaxhighlight>
   
<!--
 
LET OP: Verouderde documentatie
 
 
===Webpart===
 
 
 
* Webpart: http://www.kennisnet.nl/fileadmin/contentelementen/kennisnet/Kennisnet_federatie/Plug-ins/Entree.SSO.1.0.3.wsp
 
 
De webpart is voor SharePoint 2007, voor andere versies kan het script gebruikt worden en geplaatst in een hidden webpart.
 
   
  +
==Foutmeldingen==
In dit script moet de Elo Id en de Elo URL aangepast worden.
 
  +
Als de ingestelde identifier van de IdP niet bekend is binnen Entree Federatie zal de call resulteren in een 400 HTTP status code.
* Elo Id (Entity Id) : de unieke identifier van de koppeling (kan opgevraagd worden bij Kennisnet).
 
  +
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.
* Elo URL: https://*.domeinnaam.nl (dit moet de locatie/domein zijn waar het script staat).
 
-->
 

Versie van 15 jun 2018 10:47

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

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 punt 2) 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 = 'https://';

   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.