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 Okta 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 met Okta in?

We zullen hier uitleg geven over hoe je SSO moet instellen. Raadpleeg de support van Okta voor de exacte instellingen.

Stappenplan voor het aanmaken van gegevens in Okta

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

Vraag onze Metadata URL op via http://saml2.rakoo.com/saml/metadata
In onze metadata vind je onze entityID. Deze moet ingevuld worden bij de Audience URI in de Okta SAML-integratie.
Stel de attributes goed in, zodat ze overeenkomen met Rakoo:
- firstname = user.firstname
- lastname = user.lastname
- email = user.email
Vervolgens heb je data nodig vanuit Okta om de integratie in te stellen in jouw online academy. Je vindt deze metadata bij de 'sign on'-tab bij de SAML-integratie in Okta.
- Identity Provider Single sign-on URL
  Dit kan er als volgt uitzien (voorbeeld): https://klantnaam.okta-emea.com/app/iyk5twfdkaYFwYiP29b7/sso/saml/metadata
- Audience URL
  Dit kan er als volgt uitzien (voorbeeld): http://www.okta.com/iyk5twfdkaYFwYiP29b7
- Optioneel: certificaat dat we aan de koppeling kunnen toevoegen
  X.509 Certificate

Stappenplan voor het aanmaken van de integratie in jouw online academy

Alleen SSO

Ga via het menu links in beeld naar 'Integraties'.
Kies bij 'Single sign-on' voor 'Okta (SAML)'.
Klik op 'Toevoegen'.
Vul de gegevens die verkregen zijn vanuit Okta, hier in.
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 Okta' 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 Google (rechts) de velden in Rakoo gevuld worden. Raadpleeg de knowledge base van Google voor het instellen van de juiste claims. Kom je er niet uit? Neem dan contact op met support.

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

{
	"corporateId": "vul zelf in",
	"department": "vul zelf in",
	"company": "vul zelf in",
	"companyPath": null,
	"firstName": "vul zelf in",
	"lastName": "vul zelf in"
}

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 Okta (SAML)