Wat is SSO?

Met Single sign-on (SSO) kunnen jouw gebruikers inloggen in de online academy door middel van een extern account.

In dit artikel bespreken we wat je moet instellen om deze integratie met Microsoft te activeren.

Om van SSO gebruik te kunnen maken, moeten de gebruikers al toegevoegd zijn aan de online academy. SSO zorgt er niet standaard voor dat er gebruikersaccounts aangemaakt worden. Deze optie kan wel aangezet worden in de SSO integratie in Rakoo. In het stappenplan voor het inrichten van de integratie in Rakoo leggen we dit verder uit.

Lees hier meer over het toevoegen van gebruikers aan jouw online academy.

Hoe stel ik SSO in?

We zullen hier uitleg geven over hoe je SSO moet instellen. Raadpleeg de support van Microsoft voor de exacte instellingen. We hebben eerst de gegevens nodig van Microsoft. Na het invullen van deze gegevens in Rakoo, verschijnen de gegevens die bij Microsoft ingevuld kunnen worden.

Stappenplan voor het aanmaken gegevens in Microsoft

Om SSO via Microsoft in te stellen, volg je de volgende stappen. Dit supportartikel van Microsoft helpt je hierbij.

Klik bij 'Basic SAML Configuration' op 'Set up Single Sign-On with SAML'.
Vul in de 'Basic SAML Configuration' de 'Identifier (Entity ID)' en 'Reply URL (Assertion Consumer Service URL)' in.
Vul vervolgens de volgende gegevens in:
Identifier
urn:com:rakoo:saml2-adapter
Reply URL
Deze haal je uit de integratie in Rakoo, onder 'Gegevens voor de andere partij'. Dit krijg je te zien zodra je de integratie hebt opgeslagen.
Stel de attributes goed in. Dit is afhankelijk van hoe de gegevens in Rakoo zijn ingesteld: de waarde die via Azure wordt doorgegeven moet overeenkomen met hoe het in Rakoo staat ingesteld.
Unique User Identifier = user.userprinciplename of user.mail
Vervolgens heb je data nodig vanuit Microsoft om de integratie in te stellen in jouw online academy.
- App Federation Metadata Url
  Dit kan er als volgt uitzien (voorbeeld): https://login.microsoftonline.com/e2126f63-8dda-44b5-9b94-77742ad125fe/fe derationmetadata/2007-06/federationmetadata.xml?appid=fac70d5b-b5f6-4de 7-9210-42c981a9da7a
  Deze url kan voor jouw situatie afwijken. Het is van belang dat je in de url het volgende gedeelte meegeeft: appid=fac70d5b-b5f6-4de7-9210-42c981a9da7a
- Microsoft Entra ID identifier (EntityID)
  Dit kan er als volgt uitzien: https://sts.windows.net/e2126f63-8dda-44b5-9b94-77742ad125fe/

In de applicatie in Entra geef je aan wat de unieke identifier is, UserPrincipalName of Email. Deze moet overeenkomen met het e-mailadres van de gebruiker in Rakoo.

Stappenplan voor het aanmaken van de integratie in de online academy

Alleen SSO

Ga via het menu links in beeld naar 'Integraties'.
Kies bij 'Single sign-on' voor 'Microsoft (SAML)'.
Klik op 'Toevoegen'.
Vul het 'EntityId' en de 'MetadataUrl' hier in. Deze gegevens verkrijg je uit de SAML configuratie die je ingericht hebt in Azure.
Klik op 'Wijziging opslaan'. De Entity ID en Reply URL worden na het opslaan van de wijzigingen onderaan de pagina gegeneerd. Deze gegevens zijn over te nemen in Azure.
Zet, indien gewenst, de schuifjes onder 'Status integratie' aan:
- Bij 'Geactiveerd' kun je aangeven of de integratie geactiveerd is of niet.
- Met 'Inloggen met 'knop'' kun je aangeven of er ook een knop op het inlogscherm geplaatst moet worden. Staat deze optie uit? Dan kan men enkel via een externe manier inloggen via SSO (bijvoorbeeld een intranet).
Standaard zal de knop 'Inloggen met Microsoft' getoond worden op de inlogpagina. Via 'Icoon bij inloggen' kan de tekst en het bijbehorende icoon aangepast worden.
Sla de wijzigingen op om de integratie te activeren.

SSO inclusief account aanmaken

In de SSO integratie is ook in te stellen dat gebruikers automatisch aangemaakt worden in Rakoo als ze voor het eerst via SSO inloggen en hun account nog niet bestaat.

Volg hiervoor eerst alle bovenstaande stappen. Zet vervolgens in de integratie in Rakoo het vinkje 'Gebruiker aanmaken als deze nog niet bestaat in Rakoo' aan.

Vul de externe JSON mapping in. Dit geeft aan met welke velden uit Entra (rechts) de velden in Rakoo gevuld worden. De Entra-velden waarmee voor 'department' en 'company' gevuld moeten worden, moet je zelf nog aanvullen in onderstaande mapping.

Via de SSO-applicatie in Azure kun je deze claims zelf instellen. Dit doe je via 'Single sign-on' > 'Attributes & Claims' bewerken > 'Add new claim'.

Als er een bedrijf of afdeling wordt meegestuurd die nog niet bestaat in Rakoo, dan wordt deze automatisch aangemaakt.

{
	"corporateId": "http://schemas.microsoft.com/identity/claims/objectidentifier",
	"department": "vul zelf in",
	"company": "vul zelf in",
	"companyPath": null,
	"firstName": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname",
	"lastName": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname"
}

Let op!

Gebruikers die via SSO worden aangemaakt worden niet via SSO geüpdatet. Als dit wel gewenst is, zul je dit via een andere weg moeten regelen. Handmatig of via een koppeling met Microsoft Entra of je HR-software.

Kom je er niet helemaal uit? Neem dan contact op met support.

SSO Microsoft (SAML)