Houd er rekening mee dat deze informatie correct was op 13 november 2023, en dat Teamtailor niet verantwoordelijk is voor wijzigingen die Google sindsdien heeft doorgevoerd. Alle vragen die buiten deze uitleg vallen, kun je rechtstreeks aan het supportteam van Google richten.
SSO instellen op een enkel account
Ga in Teamtailor naar Instellingen → Beveiliging → Single Sign-on (SSO) om SSO in te stellen. Let op: deze handeling moet uitgevoerd worden door iemand met Bedrijfsbeheerder toegang. Volg dan onderstaande stappen:
Ga naar je Google Admin-console, klik onder Apps op Web- en mobiele apps, klik dan op App toevoegen en vervolgens op Aangepaste SAML-app toevoegen.
Geef op de nieuwe pagina een geschikte naam, een beschrijving en een icoon als je dat wilt, en klik vervolgens op "Doorgaan".
Op de volgende pagina heb je twee opties. Wij raden aan om "Metadata downloaden" te klikken en het XML-bestand in je Downloads op te slaan, klik vervolgens op Doorgaan.
Vervolgens moet je de gegevens van de serviceprovider verstrekken. Dit zijn de ACS-URL en Entity ID die worden verstrekt in je Teamtailor SSO-instellingen:
In Google kun je de Start-URL negeren, maar zorg ervoor dat je bij het veld Name ID "Persistent" selecteert als het Name ID-formaat, klik dan op Doorgaan.
In Teamtailor kun je het XML-bestand dat je in Stap 3 hebt gedownload uploaden in het veld waar staat "Upload IdP-metadata bestand". Selecteer je XML-bestand, klik op de knop Gegevens parseren, en beëindig uiteindelijk de setup.
Ga terug naar Google, waar je ook op "Voltooi" kunt klikken, en dan zie je je nieuwe Teamtailor SSO verschijnen onder je Apps in de instellingen voor Web- en mobiele apps.
Om het te testen, moet je eerst toegang geven aan de gebruikers in je organisatie. Dit kan voor of na het voltooien van de setup worden gedaan. Om deze instelling te bewerken, klik je op je nieuwe App, vervolgens op Gebruikers toegang, schakel de instelling in op "AAN voor iedereen" en klik op Opslaan.
Klik dan op dezelfde plek waar je eerder op Gebruikers toegang hebt geklikt, op "Test SAML Login". Dit leidt je vervolgens naar Teamtailor om in te loggen en te controleren of het goed werkt. Als je een nieuwe gebruiker bent, zul je dit als een Standaardgebruiker zien, en als je een bestaande gebruiker bent, zie je dit op het niveau waarop je eerder was toegevoegd.
Om de setup te voltooien, kun je meer gebruikers en groepen aan jouw kant toevoegen, ga dan in Teamtailor naar "Forceer SSO", dan kunnen je gebruikers alleen nog inloggen met SSO vanaf nu. Je kunt ook ons ondersteuningsteam of CSM vragen om auto-join domeinen voor je toe te voegen, zodat je team kan inloggen via https://tt.teamtailor.com/en/login/sso in plaats daarvan.
SSO instellen op een groepsaccount
Deze uitleg is alleen van toepassing op bedrijven met meer dan één Teamtailor-account die dezelfde SSO-instelling voor al hun accounts willen gebruiken.
Bij het instellen van een groepsoplossing moet je alle bovenstaande stappen doorlopen, en dit instellen op het 'hoofdaccount' in Teamtailor.
Standaard worden nieuwe gebruikers in Teamtailor die zich voor het eerst aanmelden zonder eerder aan een account te zijn toegevoegd, automatisch toegevoegd aan het hoofdaccount. Wil je dit voorkomen, dan moet je ons een extra attribuut sturen waarmee wij kunnen bepalen aan welk account de nieuwe gebruiker toegevoegd moet worden.
Om een nieuwe claim toe te voegen, klik je op je nieuwe app, daarna op "Configureer SAML-attribuuttoewijzing" en vervolgens op Add Mapping. Je krijgt dan twee velden om in te vullen:
"Google Directory-attributen" is de lijst met attributen van je gebruikers binnen Google Admin, en is het attribuut dat je gebruikt om aan Teamtailor te laten zien aan welk account de nieuwe gebruiker moet worden toegevoegd. Dit kan van alles zijn, maar meestal is het Land, Organisatie of Afdeling.
"App-attributen" is een tekstvak waar je de naam van de claim kunt invullen die je naar Teamtailor stuurt. Ook dit kan eigenlijk elke naam zijn. Het belangrijkste is dat je aan Teamtailor doorgeeft welke naam je bij het App-attribuut hebt gekozen, want daarmee onderscheidt Teamtailor je gebruikers.
Als laatste stap laat je Teamtailor weten wat de naam van het App-attribuut is, welke waarden gebruikt worden als identifier voor je Teamtailor-account, en welke domeinen automatisch toegang hebben tot die accounts. Dat ziet er bijvoorbeeld zo uit:
attribuut = country
Teamtailor-account A: waarde = TeamtailorA, domein = @teamtailora.com
Teamtailor-account B: waarde = TeamtailorB, domein = @teamtailorb.com
Je kunt dit testen door dezelfde stappen als voor een enkel account te volgen, maar zorg ervoor dat je gebruiker dan in het juiste account is ingelogd.
Belangrijk om te weten: dit geldt alleen voor nieuwe gebruikers. Bestaande gebruikers loggen automatisch in op de accounts waarvoor ze al zijn ingesteld.
Het gebruik van Groeps-SSO betekent dus niet dat alle gebruikers ook toegang hebben tot alle andere accounts. Nieuwe gebruikers worden automatisch maar aan één account toegevoegd. Hebben ze toegang tot meerdere accounts nodig, dan moeten ze handmatig worden toegevoegd via het tabblad Medewerkers van die andere accounts.
Veelvoorkomende foutmeldingen
Dit betekent dat je in je Google-instellingen deze gebruikersgroep niet hebt toegevoegd onder "Gebruikers toegang". Om dit op te lossen, volg je stap 8 van het bovenstaande artikel.
2. Dit betekent dat je de verkeerde ACS-URL of Entity ID-URL hebt in jouw Google-account. Controleer je Teamtailor-account zodat deze overeenkomt.
🤖 Dit artikel is vertaald met behulp van AI. Laat het ons weten als iets niet klopt.