KNF:Single Sign On query

Nederlands

English

Inleiding

De Single Sign On-query kan worden gebruikt door Service Provider om te detecteren of een gebruiker reeds een lopende SSO sessie via Entree Federatie heeft.

Om te authentiseren, moet de gebruiker op de website op de knop "Inloggen" klikken, waardoor het authenticatieproces via Entree Federatie start. Als de gebruiker echter al een geldige Single Sign On-sessie met Entree Federatie heeft, zal het inloggen onmiddellijk zonder gebruikersinteractie (bijv. het invoeren van een gebruikersnaam en wachtwoord) gebeuren. Het klikken op de knop "Inloggen" is dus overbodig en daarom minder gebruiksvriendelijk.

Om dit scenario te voorkomen, kan de Service Provider een detectiemechanisme implementeren dat automatisch gebruikers met een geldige SSO-sessie herkent. Dit kan worden bereikt met de Single Sign On-query.

Let op:
Om misbruik van deze functionaliteit te voorkomen dient het domein opgenomen te worden in de whitelist van Entree Federatie. Neem daarom contact op met Kennisnet als je gebruik wilt maken van SSO query.

Zodra de vraag aan de Entree Federatie gesteld wordt, kunnen er drie antwoorden worden geven op de SSOQuery:

false

De gebruiker heeft geen SSO sessie en is voor zover bekend bij de Entree Federatie nergens ingelogd. Het is dus onbekend of de gebruiker wel of niet kan inloggen via Entree Federatie.

true

De gebruiker heeft een SSO sessie en kan inloggen zonder gebruikersinteractie

remote

De gebruiker heeft geen SSO sessie, maar er is wel een SSO notificatie cookie gevonden. De gebruiker is al ingelogd bij zijn eigen Identity Provider en kan hoogstwaarschijnlijk inloggen zonder gebruikersinteractie

Implementatie

De query bestaat uit een HTTP GET request met twee parameters:

• response_url: deze parameter moet in de URL worden URL encoded/UTF-8
• format: deze optionele parameter kan gebruikt worden om het antwoord in json format te ontvangen

De volgende urls kunnen worden gebruikt:

SSO Query endpoint:

Productie: https://ssoquery.entree.kennisnet.nl/sso/ssoquery?response_url=<URL>
Staging: https://ssoquery.entree-s.kennisnet.nl/sso/ssoquery?response_url=<URL>

Voorbeeld

De Service Provider stelt de vraag

https://ssoquery.entree.kennisnet.nl/sso/ssoquery?response_url=https%3A%2F%2Ftestapplicatie.kennisnet.nl

Entree Federatie redirect naar de opgegeven response URL

https://testapplicatie.kennisnet.nl?result=true