Naar de hoofdinhoud

SAML SSO instellen

Koppel je identity provider aan Tomba, zodat je team met SSO kan inloggen.

Geschreven door Tomba.io Team

Koppel je identity provider aan Tomba, zodat je team kan inloggen met hun bedrijfslogin. Een identity provider is de dienst waarmee je bedrijf logins beheert, zoals Okta, Microsoft Entra ID of Google Workspace.

Voordat je begint

  • Een Tomba Enterprise-abonnement.

  • De rol Owner of Admin in je workspace.

  • Beheerderstoegang tot je identity provider. Heb je die niet, vraag het dan aan je IT-afdeling.

💡 Tip: Gebruik je Google Workspace? Volg dan in plaats hiervan SSO instellen met Google Workspace.

Tomba toevoegen aan je identity provider

  1. Kopieer onder Service provider details de Entity ID (Audience URI) en de ACS URL (Reply URL).

  2. Maak in de beheeromgeving van je identity provider een nieuwe aangepaste SAML-app aan.

  3. Plak beide waarden in de app.

  4. Zet het Name ID-formaat op Email. Zo herkent Tomba je gebruikers.

  5. Sla de app op.

De metadata uploaden naar Tomba

Je identity provider geeft je een XML-bestand met metadata voor de nieuwe app. Dit kleine bestand vertelt Tomba dat het de logins daarvan kan vertrouwen. Download het bestand en doe daarna het volgende:

  1. Klik op Settings > SAML SSO op Configure SAML SSO.

  2. Kies Upload file en voeg het bestand toe, of kies Paste XML en plak de inhoud ervan.

  3. Controleer het voorbeeld, met daarin de Entity ID, SSO URL en Certificates.

  4. Klik op Save and enable SSO.

Wil je het later wijzigen, klik dan op Replace metadata en daarna op Update metadata.

Je e-maildomein verifiëren

Doe dit voordat je gaat testen. Tomba gebruikt het domein van je e-mailadres om je SSO-login te vinden, dus niemand komt daar terecht totdat het domein is geverifieerd. Volg de stappen in Je domein verifiëren voor SSO.

De login testen

  1. Open een privévenster in je browser.

  2. Ga naar de inlogpagina van Tomba en klik op Sign in with SSO.

  3. Vul je Work email in en klik op Continue.

  4. Klik op Continue with SSO.

  5. Log in bij je identity provider. Daarna ben je ingelogd bij Tomba.

Kiezen hoe je team inlogt

Kies onder Sign-in method voor All methods, SSO preferred of Only SAML SSO. Wat elke optie doet, lees je in Inlogmethoden voor SSO.

Veelgestelde vragen

Waarom zie ik "SSO not configured"?

Tomba kan je e-mailadres niet koppelen aan een SSO-configuratie. Controleer of je domein als geverifieerd wordt weergegeven onder Verified domains, en of je een adres op dat domein gebruikt.

Waarom mislukt het inloggen bij mijn identity provider?

Controleer deze drie dingen in je identity provider:

  • De Entity ID en ACS URL komen precies overeen met wat Tomba toont.

  • Het Name ID-formaat is Email.

  • De SAML-app staat aan voor jouw gebruiker.

Hebben nieuwe leden een uitnodiging nodig?

Niet als Just-in-time provisioning aanstaat. Tomba maakt een account aan zodra iemand voor het eerst met SSO inlogt, en geeft diegene de Default role die op dezelfde pagina staat.

Gerelateerde artikelen

Was dit een antwoord op uw vraag?