Gebruik SCIM om gebruikers automatisch vanuit je Identity Provider aan Teamtailor toe te voegen. We hebben het getest en ondersteunen momenteel provisioning vanuit Microsoft Entra ID en Okta, al kunnen andere SCIM-apps mogelijk ook werken.
Standaardvelden
In onderstaande tabel zie je welke attributen worden ondersteund en hoe ze aan Teamtailor-gebruikers worden gekoppeld. Momenteel kunnen alleen User-objecten worden toegevoegd, "Groups" worden niet ondersteund.
Let op: in de onderstaande tabel is het de "Customappsso Attribute" die naar Teamtailor wordt gestuurd.
Customappsso Attribuut | Entra ID attribuut | Teamtailor Gebruiker attribuut |
userName | userPrincipalName | E-mail voor inloggen |
externalId | mailNickname | external_id (intern attribuut gebruikt in API en SSO-aanmeldingen als name-id) |
emails[type eq "work"].value | Weergave e-mail | |
phoneNumbers[type eq "work"].value | telephoneNumber | Telefoonnummer |
titel | jobTitle | Titel |
displayName | formatted | Voor- en achternaam |
name.givenName | givenName (optioneel) | Eerste deel van de naam als er geen displayName wordt gebruikt |
name.familyName | surname (optioneel) | Laatste deel van de naam als er geen displayName wordt gebruikt |
actief | Switch([IsSoftDeleted], "False", "True", "True", "False") | false zet de functie op "no_access" true zet de functie op "user" als deze eerder "no_access" was |
Aangepaste velden
Naast de standaardvelden kan Teamtailor ook werken met de volgende aangepaste velden om meer details over je gebruikers te provisionen. Je moet hiervoor contact opnemen met Teamtailor Support of je Customer Success Manager om deze in te stellen.
Voor deze velden moet je ons de naam van het Customappsso-attribuut doorgeven, de bijbehorende waarden en aan welk Teamtailor-veld uit de volgende lijst dit wordt gekoppeld:
Afdelings-ID
Omschrijving
Divisie-ID
Extern ID
E-mailadres verbergen
Telefoonnummer verbergen
Instagram-profiel
Uitnodigingse-mailadres
Taalcode
Locatie-ID
Naam
Ander profiel
Telefoonnummer
Rol
Handtekening
Tijdnotatie
Tijdzone
Titel
Zichtbaar
X-profiel
Gebruikers verwijderen en uitschrijven
Wanneer een medewerker jouw bedrijf verlaat, heb je twee opties:
De gebruiker in jouw systeem krijgt de "active" waarde op "false" gezet. In dat geval wordt de toegang van de gebruiker binnen Teamtailor aangepast naar Geen toegang. Dit betekent dat ze als gebruiker in je Teamtailor-systeem blijven bestaan (zodat eerdere activiteiten aan die naam gekoppeld blijven), maar geen toegang meer hebben tot Teamtailor.
Als de gebruiker volledig uit jouw systeem wordt verwijderd, stuurt dit een "DELETE"-verzoek via de SCIM API naar Teamtailor en wordt de gebruiker ook uit je Teamtailor-account verwijderd. Let op: alle activiteiten van deze gebruiker worden dan gemarkeerd als "Deleted user".
SCIM instellen in Microsoft Entra ID
Volg de Microsoft-documentatie om de SCIM-applicatie en gebruikersmapping in te stellen, zie: https://learn.microsoft.com/en-us/entra/identity/app-provisioning/how-provisioning-works
Afhankelijk van welke regio voor gegevensverwerking en opslag jouw account gebruikt, is de Tenant URL als volgt:
Noord-Amerika: https://api.na.teamtailor.com/scim/v2/
Azië-Pacific: https://api.au.teamtailor.com/scim/v2/
De Secret key is een API-sleutel die je hoofdcontactpersoon bij Teamtailor moet genereren.
De applicaties moeten worden ingesteld als een "non-gallery" SCIM-applicatie.
SCIM instellen in Okta
Voor Okta heb je twee opties:
Gebruik één enkele app voor zowel SSO als SCIM
Download een aparte SCIM-app binnen Okta om de apps gescheiden te houden.
Enkele app
Volg de Okta-documentatie hier - https://help.okta.com/en-us/content/topics/apps/apps_app_integration_wizard_scim.htm - let op dat je eerst de SAML 2.0-applicatie moet aanmaken.
Voeg de volgende instellingen toe:
De basis-URL van de SCIM-connector hangt af van welke regio voor gegevensverwerking en opslag jouw account gebruikt:
Noord-Amerika: https://api.na.teamtailor.com/scim/v2/
Azië-Pacific: https://api.au.teamtailor.com/scim/v2/
Het unieke ID-veld voor gebruikers is e-mail.
De authenticatiemethode is HTTP-header.
De HTTP-header Authorization is een SCIM API-sleutel die door Teamtailor wordt verstrekt. Neem hiervoor contact op met Teamtailor.
Je kunt dan de Provisioning naar App-instellingen configureren, inclusief welke gebeurtenissen je wilt opnemen.
Aparte SCIM-app
We adviseren de "SCIM 2.0 Test App (OAuth Bearer Token)" van Okta te downloaden. Je hebt dan de volgende opties om SCIM in te schakelen zonder verplicht SAML in te stellen:
Gebruik de SWA-connector, voer een standaard Teamtailor-URL in en schakel SCIM in.
Gebruik de speciale SCIM-app uit de OIN.
(Minder netjes) Gebruik de SAML-connector, maar vul dummygegevens in bij de SAML-instellingen.
🤖 Dit artikel is vertaald met behulp van AI. Laat het ons weten als iets niet klopt.