Naar de hoofdinhoud

Hoe je SSO instelt met Okta

Gebruik je Okta-account om SSO in te stellen voor zowel individuele als groepaccounts.

Houd er rekening mee dat deze informatie correct was op 14 november 2023, en Teamtailor is niet verantwoordelijk voor eventuele wijzigingen binnen Okta. Vragen die buiten de reikwijdte van dit artikel vallen, kun je rechtstreeks aan het supportteam van Okta stellen.

SSO instellen voor een enkel account

Om SSO in Teamtailor in te stellen, ga je naar Instellingen > Beveiliging > Single Sign-on (SSO). Let op: dit moet worden voltooid door een gebruiker met toegang als bedrijfsbeheerder. Volg dan de onderstaande stappen:

  1. Ga naar jouw Okta Admin-portaal, dan naar Toepassingen, dan naar App-integratie maken en selecteer uiteindelijk SAML 2.0.

  2. Geef op de nieuwe pagina een geschikte naam, een logo als je wilt, laat de zichtbaarheid van de app niet aangevinkt en klik dan op "Volgende".

  3. Onder de kop Configureer SAML moet je de Single Sign-On URL en Audience URI (SP Entity ID) toevoegen. Deze twee URL's vind je in jouw Teamtailor-instellingen en moeten in de relevante velden worden gekopieerd en geplakt.

    Teamtailor

  4. Zorg ervoor dat het Name ID-formaat Persistent is en dat de Applicatienaam het E-mailadres is. Scroll dan naar beneden en klik op Volgende. De volgende pagina is een feedbackpagina die je kunt invullen als je dat wilt, en klik dan op "Voltooien".

  5. Op Okta zal de volgende pagina die wordt geladen het "Inloggen"-gedeelte van jouw nieuwe integratie zijn, en hier vind je jouw Metadata-URL. Kopieer deze URL en plak deze vervolgens op Teamtailor in het veld dat IdP Metadata XML URL heet, klik dan op Parse Metadata en vervolgens op Setup Voltooien.

  6. Terug in Okta moet je vervolgens een gebruiker toewijzen om jouw nieuwe applicatie te testen. Om dit te doen klik je op Directory, dan op Mensen, dan de gebruiker die je wilt testen, dan Toewijzen Applicaties, klik naast jouw nieuwe applicatie op Toewijzen en dan Opslaan.

  7. Om te testen of het werkt, ga je naar jouw carrièresite, scroll naar beneden waar je "SSO" in de footer ziet staan.

  8. Bij het klikken op SSO moet je worden doorverwezen naar de pagina waar je jouw Okta-inloggegevens kunt invoeren. Zodra dit is voltooid, wordt je naar de homepage van jouw Teamtailor-dashboard geleid. Als je een nieuwe gebruiker bent, zal dit als een standaard gebruiker zijn, en als je een bestaande gebruiker bent, zal dit zijn op het niveau waarop je eerder was toegevoegd.

  9. Om de setup te voltooien, kun je meer gebruikers en groepen aan jouw kant toevoegen en klik in Teamtailor op "Handhaaf SSO", zodat jouw gebruikers voortaan alleen met SSO kunnen inloggen. Je kunt ook aan ons ondersteuningsteam of CSM vragen om auto-join domeinen voor jou toe te voegen, zodat jouw team kan inloggen via https://tt.teamtailor.com/en/login/sso in plaats daarvan.

SSO instellen op een groepsaccount

Let op dat dit gedeelte alleen van toepassing is op bedrijven die meer dan één Teamtailor-account hebben en dezelfde SSO-installatie over al hun accounts willen gebruiken.

Bij het instellen van een groepsoplossing moet je ervoor zorgen dat je alle bovenstaande stappen voltooit, zorg ervoor dat dit op Teamtailor is ingesteld op het "ouder" account.

In Teamtailor, als standaard worden nieuwe gebruikers die voor het eerst inloggen zonder eerder aan een bestaand account te zijn toegevoegd, automatisch aan het ouderaccount toegevoegd. Om dit te voorkomen moet je ons een extra attribuut sturen dat we kunnen gebruiken om te identificeren aan welk account de nieuwe gebruiker moet worden toegevoegd.

Om een nieuwe claim toe te voegen, zoek je jouw nieuwe app, ga dan naar het tabblad Algemeen, scroll naar beneden naar SAML-instellingen en klik op Bewerken in de hoek van dat venster. Sla de stap Configureer SAML over, scroll vervolgens naar beneden naar de Attributenverklaringen (optioneel) sectie. Het "Naam"-veld is het veld dat je aan Teamtailor moet geven en kan van alles worden genoemd. Het "Waarde"-veld moet een bestaande waarde op jouw gebruikersprofielen hebben, bijv. user.title. Een volledige lijst is beschikbaar in de sectie Profielbewerker van jouw Directory.

De laatste stap is Teamtailor te laten weten welke naam aan het attribuut dat je hebt aangemaakt is gekoppeld, naast de mogelijke waarden die als identificatie voor jouw Teamtailor-account zouden worden gebruikt, evenals eventuele auto-join domeinen die aan die accounts zijn gekoppeld. Dit kan er ongeveer zo uitzien:

Attribuut naam = land

Teamtailor-account A: waarde = TeamtailorA, domein = @teamtailora.com

Teamtailor-account B: waarde = TeamtailorB, domein = @teamtailorb.com

Om dit te testen, kun je dezelfde stappen volgen als eerder voor een enkel account, maar zorg ervoor dat je gebruiker dan inlogt op het juiste account.

Het is belangrijk om hier op te merken dat dit alleen voor nieuwe gebruikers is. Bestaande gebruikers loggen automatisch in op de accounts waar ze al zijn ingesteld.

Bovendien betekent het gebruik van Groeps-SSO niet dat alle gebruikers dan toegang hebben tot de andere accounts. Nieuwe gebruikers worden automatisch aan slechts één account toegevoegd, maar als ze toegang tot meer dan één nodig hebben, moeten ze handmatig worden toegevoegd in het tabblad Medewerkers van de andere accounts.

Veelvoorkomende foutmeldingen

  1. Dit betekent dat je in jouw Okta People-instellingen jouw applicatie aan deze gebruiker niet hebt toegevoegd. Volg hiervoor stap 6 van het bovenstaande artikel.

  2. Dit betekent meestal dat je jouw Single sign-on URL en Audience URI (SP Entity ID) verkeerd hebt ingevoerd. Zorg ervoor dat je deze informatie correct hebt ingevoerd vanuit Teamtailor.

  3. Deze fout, weergegeven in jouw Teamtailor SSO-instellingen, betekent meestal dat jouw Okta-certificaat is verlopen. Om een nieuwe te genereren, vind je je nieuwe app, ga je naar het submenu Aanmelden en scroll je helemaal naar beneden, waar je SAML Signing Certificates ziet. Hier hoef je alleen maar een nieuw certificaat te genereren.

🤖 Dit artikel is vertaald met behulp van AI. Laat het ons weten als iets niet klopt.

Was dit een antwoord op uw vraag?