Let op: deze informatie was correct op 2 november 2023. Teamtailor is niet verantwoordelijk voor eventuele wijzigingen binnen Microsoft. Voor vragen die buiten de reikwijdte van dit artikel vallen, neem je rechtstreeks contact op met de support van Microsoft.
SSO instellen op één account
Om SSO in Teamtailor in te stellen, heb je Company Admin-toegang nodig. De eerste stap is om naar je Instellingen → Beveiliging → Single Sign-on (SSO) te gaan. Volg daarna de onderstaande stappen:
Ga naar jouw Entra Portal, en onder Entra-diensten vind je de optie "Enterprise-applicaties".
Maak een nieuwe applicatie, kies vervolgens "Maak je eigen applicatie aan", geef het een passende naam, laat de standaardinstelling voor niet-galerij aangevinkt staan en klik op "Aanmaken".
Zodra je nieuwe applicatie is gemaakt, klik je op "Single sign-on instellen", kies je voor SAML en zie je het volgende scherm:
Jouw Identifier (Entity ID) en jouw Reply URL (Assertion Consumer Service URL) zijn de enige verplichte velden en zijn te vinden in jouw Teamtailor-instellingen. In Entra, klik op "Bewerken" in de rechterbovenhoek van deze stap, voor elk veld voeg je de relevante URL's toe die je in jouw Teamtailor-instellingen vindt, en klik dan op Opslaan.
Vervolgens moet je de App Federation Metadata URL toevoegen, die je vindt onder Stap 3 SAML-certificaten in Entra. Kopieer deze waarde en plak deze in Teamtailor onder de titel "IdP Metadata xml URL."
In Teamtailor, klik op "Parse metadata". Dit rondt de setup aan Teamtailor-kant af, dus nu is het tijd om te testen of alles werkt zoals het hoort.
Om dit te testen, moet je eerst de gebruiker aan jouw Entra-instellingen toevoegen. Klik aan de linkerkant boven Single Sign-on op "Gebruikers en groepen", dan "Voeg gebruiker/groep toe". Voor het testen raden we aan één gebruiker toe te voegen in plaats van een groep. Klik daarom onder Gebruikers op "Geen geselecteerd", voeg het e-mailadres toe dat je voor de test gebruikt, selecteer vervolgens en wijs toe.
Om te testen of het werkt, ga je naar jouw carrièresite en scroll je naar beneden waar je "SSO" in de footer zult zien staan.
Wanneer je op SSO klikt, zou je moeten worden doorverwezen naar de pagina waar je jouw inloggegevens kunt invoeren. Eenmaal voltooid, word je geleid naar de homepage van jouw Teamtailor-dashboard. Als je een nieuwe gebruiker bent, is dit een Standaardgebruiker, en als je al een gebruiker bent, is dit op het niveau waarbij je eerder bent toegevoegd.
Om de instelling te voltooien, kun je zelf meer gebruikers en groepen toevoegen, klik daarna in Teamtailor op "Handhaaf SSO", en je gebruikers kunnen dan voortaan alleen nog met SSO inloggen. Je kunt ook 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
Houd er rekening mee dat deze sectie alleen van toepassing is op bedrijven die meer dan één Teamtailor-account hebben en die dezelfde SSO-instelling over al hun accounts willen gebruiken.
Bij het instellen van een groepsoplossing moet je ervoor zorgen dat je alle bovenstaande stappen doorloopt en dat dit in Teamtailor is ingesteld op het "hoofdaccount".
In Teamtailor, standaard, als een nieuwe gebruiker zich voor de eerste keer aanmeldt zonder eerder aan een bestaand account te zijn toegevoegd, wordt hij automatisch toegevoegd aan het hoofdaccount. Om dit te voorkomen, moet je ons een extra claim sturen, die 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 bedrijfsaccount in jouw Entra-portaal, klik dan op Single sign-on. Van hieruit is het de tweede box die je moet bewerken:
Klik op Bewerken, dan "Voeg nieuwe claim toe". Je moet dan een naam toevoegen, die van alles kan zijn, zoals "land" of "bedrijf", of je kunt een patroon volgen dat vergelijkbaar is met de andere claims en dit iets als "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/country" noemen.
Zodra je de naam hebt toegevoegd, moet je de bron kiezen. Kies Attribuut, en kies dan een relevant attribuut uit de dropdownlijst. Als je "bedrijf" als jouw claim hebt gekozen, dan zou dit attribuut hoogstwaarschijnlijk user.companyname zijn. Het is belangrijk om ervoor te zorgen dat je een attribuut kiest dat is ingevuld voor jouw bestaande gebruikers. Het maakt niet uit welk attribuut je kiest, het moet gewoon een attribuut zijn dat je veilig kunt gebruiken om gebruikers tussen de Teamtailor-accounts te onderscheiden waarbij ze zich moeten aansluiten.
Klik op "Opslaan", en dan zie je jouw lijst van extra claims:
De volgende stap is om Teamtailor te laten weten wat de naam is van de claim die je hebt aangemaakt, samen met de mogelijke waarden die als identificator voor jouw Teamtailor-account zullen worden gebruikt, evenals eventuele auto-join domeinen die aan die accounts zijn gekoppeld. Dit kan er ongeveer zo uitzien:
claim = 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 jouw gebruiker dan is ingelogd op het juiste account.
Het is belangrijk om hierop te wijzen dat dit alleen voor nieuwe gebruikers geldt. 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 alleen automatisch aan één account toegevoegd, maar als ze toegang nodig hebben tot meer dan één, moeten ze handmatig worden toegevoegd in het tabblad Werknemers van de andere accounts.
Veelvoorkomende foutmeldingen
Dit betekent dat je in jouw SSO Entra-instellingen deze gebruiker niet hebt toegevoegd aan de instellingen voor Gebruikers en Groepen. Om dit op te lossen, volg dan stap 7 van het bovenstaande artikel.
2. Je hebt het Entity ID verkeerd toegevoegd. Controleer dit nogmaals in jouw Teamtailor-instellingen en zorg ervoor dat het perfect overeenkomt met wat je in jouw Entra AD hebt.
3. Deze fout, weergegeven in jouw Teamtailor SSO-instellingen, betekent meestal dat jouw SAML Handtekeningcertificaat is verlopen of ongeldig is. Om een nieuwe te maken, ga je naar jouw Entra AD-instellingen, vind de Enterprise-app die je hebt aangemaakt, en klik dan op Single Sign-on. Van hieruit is het Stap 3 SAML-certificaten die je moet bewerken. Klik op Bewerken, dan + Nieuw Certificaat, klik dan op Opslaan. Standaard zal dit dan 3 jaar extra aan je certificaat toevoegen en het probleem verhelpen.
🤖 Dit artikel is vertaald met behulp van AI. Laat het ons weten als iets niet klopt.