📄 Account-instellingen / SSO

Account-instellingen / SSO instellen

Laatst bijgewerkt: 20-07-2026

Met single sign-on (SSO) laat je je gebruikers inloggen op Spreash® via de identiteitsprovider die je organisatie al gebruikt, zoals Microsoft Entra ID, Google Workspace of Okta. Je beheert accounts en toegang dan op één plek, en je gebruikers hoeven geen apart Spreash®-wachtwoord meer te onthouden. Spreash® ondersteunt vier SSO-typen; per account is er één actieve SSO-configuratie tegelijk.

💡

Deze handleiding is bedoeld voor de accountbeheerder van je organisatie. Voor sommige stappen heb je daarnaast beheerdersrechten nodig bij je eigen identiteitsprovider.

Op deze pagina leer je:

  • Welk SSO-type het beste bij jouw organisatie past
  • Hoe je Microsoft Entra ID, Google, Algemene OpenID Connect of SAML instelt
  • Wat de accountopties doen en hoe je voorkomt dat je jezelf buitensluit
  • Hoe je groepen automatisch laat synchroniseren vanuit je identiteitsprovider
  • Hoe inloggen er voor je gebruikers uitziet
  • Hoe je veelvoorkomende foutmeldingen oplost
💡

De SSO-instellingen vind je in Account-instellingen, op de kaart Single sign-on (SSO). Ze zijn alleen zichtbaar voor gebruikers in een groep met accountbeheerdersrechten. Zet de pagina bovenaan op Bewerken om iets te kunnen wijzigen; in de Bekijken-weergave zijn de instellingen alleen-lezen.

Kernconcepten

Voordat je aan de slag gaat, is het handig om de volgende begrippen te kennen.

  • Identiteitsprovider (IdP) — het systeem waar je gebruikers al bekend zijn en waar het inloggen daadwerkelijk gebeurt, bijvoorbeeld Microsoft Entra ID, Google Workspace of Okta.
  • Beheerde provider — een SSO-type waarbij Spreash® de applicatieregistratie levert en onderhoudt. Je maakt zelf geen app aan en beheert geen client-secret. Geldt voor Microsoft en Google.
  • Eigen applicatie — een SSO-type waarbij jij de applicatie registreert bij je provider. Geldt voor Algemene OpenID Connect en SAML.
  • Claim — een gegeven dat je identiteitsprovider bij het inloggen meestuurt, bijvoorbeeld het e-mailadres of de groepen van de gebruiker.
  • Discovery-URL — het adres waarop een OpenID Connect-provider zijn instellingen publiceert, meestal eindigend op /.well-known/openid-configuration.
  • Redirect-URI — het adres waar je provider de gebruiker na het inloggen naartoe stuurt. Dit moet exact overeenkomen met wat je bij je provider registreert.

Welke provider kies ik?

Spreash® ondersteunt vier SSO-typen. Je kunt één actieve SSO-configuratie per account tegelijk hebben.

SSO-typeRegistreer je zelf een app?Kies dit wanneer
Microsoft Entra ID (OIDC)Nee — Spreash® levert de appJe Microsoft 365 / Entra ID gebruikt en de snelste installatie wilt
GoogleNee — Spreash® levert de appJe Google Workspace gebruikt en de snelste installatie wilt
Algemene OpenID ConnectJa — je maakt hem zelfJe een andere provider gebruikt (Okta, Keycloak, Auth0, Ping), of je je eigen Microsoft- of Google-app wilt gebruiken
SAMLJa — je maakt hem zelfJe provider alleen SAML biedt, of je beveiligingsbeleid dit vereist
  • Beheerde providers (Microsoft en Google) zijn de eenvoudige route. Spreash® bezit en onderhoudt de applicatieregistratie, dus je maakt nooit een app aan, je beheert nooit een client-secret en je plakt nergens een redirect-URL. Je kiest de provider, geeft aan welke e-maildomeinen (en bij Microsoft: welke tenant) van jou zijn, en zet het aan.
  • Je eigen app meenemen. Heb je een eigen toestemmingsscherm nodig, extra API-scopes, controle over welke groepen worden meegestuurd, of gebruik je een provider die Spreash® niet beheert? Kies dan Algemene OpenID Connect. Dat werkt ook met Microsoft en Google — beide publiceren een standaard OpenID Connect discovery-document — dus "beheerd of je eigen app" is een vrije keuze en geen beperking van je provider.

Voordat je begint

Je hebt nodig:

  • Accountbeheerdersrechten in Spreash®. De SSO-instellingen zijn alleen zichtbaar voor gebruikers in een groep met accountbeheerdersrechten. Zie je de sectie niet, vraag dan een andere beheerder om je die rechten te geven.
  • Beheerdersrechten bij je identiteitsprovider, als je je eigen applicatie registreert (Algemene OpenID Connect of SAML). Voor de beheerde opties van Microsoft en Google is dit niet nodig, met één uitzondering die in de Microsoft-sectie staat.
  • Je Spreash®-adres. In deze handleiding staat https://<jouw-spreash-host> voor het adres waarop je Spreash® bereikt, bijvoorbeeld https://app.spreash.com. Gebruik exact de host die je browser toont — identiteitsproviders vergelijken deze URL's teken voor teken.

De instellingen openen:

  1. Ga naar Account-instellingen in Spreash®.
  2. Zoek de kaart Single sign-on (SSO).
  3. Schakel de pagina bovenaan naar Bewerken om iets te kunnen wijzigen.

Er verandert niets totdat je Single sign-on ingeschakeld aanvinkt en op Opslaan klikt. Tot dat moment kun je vrij configureren zonder dat het invloed heeft op hoe iemand inlogt.

⚠️

Lees eerst de sectie Accountopties voordat je SSO inschakelt. Twee instellingen daar — Accounts zonder SSO toestaan en Toegestane e-maildomeinen — bepalen of je nog terug naar binnen komt als de SSO-configuratie niet blijkt te kloppen.

Microsoft Entra ID (beheerd door Spreash®)

Spreash® levert de Microsoft-applicatie, dus de installatie is kort. Je geeft alleen aan welke Microsoft-tenant van jou is.

Je tenant-ID opzoeken

  1. Log in op het Microsoft Entra-beheercentrum (entra.microsoft.com).
  2. Ga naar Identity → Overview.
  3. Kopieer de Tenant ID (soms getoond als Directory (tenant) ID). Die ziet eruit als c7f8e2a1-4b3d-4e5f-9a0b-1c2d3e4f5a6b.

Instellen in Spreash®

  1. Zet in Account-instellingen → Single sign-on (SSO) de Provider op Microsoft Entra ID (OIDC).
  2. Plak je tenant-ID in het veld Tenant ID. Hiermee wordt het inloggen naar jouw directory gestuurd en worden gebruikers uit andere Microsoft-tenants geweerd.
  3. Vul Toegestane e-maildomeinen in (zie Accountopties).
  4. Bepaal of je Accounts zonder SSO toestaan aan laat staan.
  5. Vink Single sign-on ingeschakeld aan en klik op Opslaan.

Eenmalige toestemming van je Microsoft-beheerder

De eerste keer dat iemand uit jouw tenant inlogt, vraagt Microsoft aan een Global Administrator van je tenant om toestemming te geven voor de Spreash®-applicatie. Dat is normaal bij elke multi-tenant Microsoft-app. Zolang die toestemming niet is gegeven, zien gebruikers een foutmelding van Microsoft en niet van Spreash®.

Wil je dat liever vooraf regelen dan dat de eerste gebruiker tegen het scherm aanloopt, dan kan je Microsoft-beheerder de toestemming vooraf geven vanuit het Entra-beheercentrum. Zie Microsoft — Beheerderstoestemming verlenen voor de hele tenant (learn.microsoft.com).

Groepssynchronisatie met de beheerde Microsoft-app

Groepssynchronisatie werkt met Microsoft, met één belangrijk detail: de beheerde app stuurt de directory-rollen van elke gebruiker mee, niet je eigen beveiligingsgroepen. Elke toewijzingsregel koppelt dus een directory-rol-ID aan een Spreash®-groep.

Een directory-rol-ID opzoeken: ga in het Entra-beheercentrum naar Identity → Roles & admins → Roles & admins, open de rol en kopieer de Object ID (soms getoond als Role ID).

Voor Microsoft hoef je geen claimnaam in te typen — Spreash® vult die in en vergrendelt het veld, omdat Entra deze claim altijd groups noemt.

Heb je juist je eigen beveiligingsgroepen nodig in plaats van directory-rollen? Stuur ze dan mee vanuit een app die je zelf beheert, via Algemene OpenID Connect met de discovery-URL https://login.microsoftonline.com/<jouw-tenant-id>/v2.0/.well-known/openid-configuration. In je eigen registratie bepaal je via Token configuration precies welke groepen worden meegestuurd.

Google (beheerd door Spreash®)

Dit is de kortste installatie van allemaal. Spreash® levert de Google-applicatie, en Google-logins worden puur op e-maildomein aan je account gekoppeld.

  1. Zet in Account-instellingen → Single sign-on (SSO) de Provider op Google.
  2. Vul Toegestane e-maildomeinen in met je Google Workspace-domeinen, bijvoorbeeld acme.com, eu.acme.com. Dit is het enige dat Google-aanmeldingen aan jouw account koppelt, dus het moet kloppen.
  3. Bepaal of je Accounts zonder SSO toestaan aan laat staan.
  4. Vink Single sign-on ingeschakeld aan en klik op Opslaan.

Meer is er niet: in de Google Admin-console hoef je niets te configureren.

Twee dingen om te weten over de beheerde Google-optie:

  • Het is OAuth/OpenID Connect-inloggen, geen SAML. Er is geen ACS-URL en geen aangepaste SAML-app. Heb je specifiek Google Workspace als SAML-identiteitsprovider nodig, gebruik dan de SAML-sectie.
  • Groepssynchronisatie is niet beschikbaar. De inlogtokens van Google bevatten geen enkele groepsinformatie, dus Spreash® verbergt de optie voor Google. Beheer groepen binnen Spreash®, of gebruik Algemene OpenID Connect met een aangepaste claim in Google Workspace op je eigen app.

Wil je je eigen Google-app (met een eigen toestemmingsscherm of extra scopes)? Gebruik dan Algemene OpenID Connect met de discovery-URL https://accounts.google.com/.well-known/openid-configuration.

Algemene OpenID Connect (je eigen applicatie)

Gebruik dit voor elke provider die de OpenID Connect-standaard volgt — Okta, Keycloak, Auth0, Ping, ADFS — of om je eigen Microsoft- of Google-applicatie te gebruiken in plaats van die van Spreash®.

Stap 1: Registreer een applicatie bij je provider

  1. Maak in de beheerconsole van je provider een nieuwe web- of confidential-applicatie aan: een applicatie met een client-secret. Maak géén public, native of single-page-app-client aan; die hebben geen secret en kan Spreash® niet gebruiken.
  2. Zet de redirect-URI van de applicatie (je provider noemt dit mogelijk callback URL, sign-in redirect URI of reply URL) exact op: https://<jouw-spreash-host>/sso/oidc/spreash/login/callback/ — inclusief de afsluitende schuine streep. De meeste providers weigeren een aanmelding waarvan de redirect-URI ook maar één teken afwijkt van de geregistreerde.
  3. Zorg dat de app de scopes openid, email en profile kan uitgeven, en dat hij het e-mailadres van de gebruiker meestuurt. Zonder e-mailadres van de provider kan Spreash® niemand inloggen.
  4. Kopieer de client-ID en het client-secret die de provider genereert. De meeste providers tonen het secret maar één keer.
  5. Zoek de discovery-URL van de provider op: het OpenID Connect-metadata-eindpunt, gebruikelijk <issuer>/.well-known/openid-configuration. Deze moet bereikbaar zijn via HTTPS. Zie de OpenID Connect Discovery-specificatie (openid.net).

Documentatie van de providers voor de meest voorkomende gevallen:

Stap 2: Vul de waarden in Spreash® in

  1. Zet in Account-instellingen → Single sign-on (SSO) de Provider op Algemene OpenID Connect.
  2. Neem de waarden over:
Waarde van je providerVeld in Spreash®
<issuer>/.well-known/openid-configurationOpenID Connect discovery-URL
Client-IDClient-ID
Client-secretClient-secret
(laat op openid email profile staan tenzij je meer nodig hebt)Scopes
  1. Vul Toegestane e-maildomeinen in (zie Accountopties).
  2. Vink Single sign-on ingeschakeld aan en klik op Opslaan.

Goed om te weten:

  • De discovery-URL moet met https:// beginnen. Spreash® weigert gewone HTTP.
  • Je client-secret wordt versleuteld opgeslagen en getoond als een afgeschermd veld, zodat het niet meeleesbaar is terwijl je werkt.
  • Scopes zijn gescheiden door spaties. Voeg alleen scopes toe die je applicatie echt nodig heeft; extra scopes betekenen meestal een langer toestemmingsscherm voor je gebruikers.

Groepssynchronisatie met Algemene OpenID Connect

Stel je applicatie zo in dat de groepen of rollen van de gebruiker als claim in het ID-token worden meegestuurd, en vul die claimnaam in bij Groepsclaimnaam in Spreash®. De naam is wat je provider gebruikt; gangbare waarden zijn groups of roles.

SAML 2.0 (je eigen applicatie)

Gebruik SAML wanneer je identiteitsprovider dit biedt in plaats van (of bij voorkeur boven) OpenID Connect. Elke SAML-identiteitsprovider — Okta, OneLogin, ADFS, Google Workspace, Entra ID — levert dezelfde drie waarden en vraagt je om dezelfde twee Spreash®-URL's.

Stap 1: Maak een SAML-applicatie bij je provider

  1. Maak een nieuwe aangepaste SAML-applicatie aan. Zie Google Workspace (support.google.com), Okta (help.okta.com) of Entra ID (learn.microsoft.com).
  2. Geef de provider de volgende service provider-gegevens:
Provider vraagt omWaarde
ACS-URL (ook reply URL, consumer URL)https://<jouw-spreash-host>/sso/saml/spreash/acs/
Entity ID (ook audience, SP entity ID)https://<jouw-spreash-host>/sso/saml/spreash/metadata/
Single logout-URL (optioneel)https://<jouw-spreash-host>/sso/saml/spreash/sls/
  1. Zet het Name ID-formaat op e-mail, en de Name ID op het primaire e-mailadres van de gebruiker.
  2. Voeg attribuuttoewijzingen toe zodat de provider minimaal het e-mailadres meestuurt, en bij voorkeur ook de naam, zodat Spreash® de gebruiker correct kan aanmaken.
  3. Haal van de detailpagina van de provider de drie waarden op die Spreash® nodig heeft: de SSO-URL, de Entity ID en het ondertekeningscertificaat (PEM). Veel providers bieden ook één metadata-URL met alle drie erin.
  4. Zet de applicatie aan en wijs hem toe aan de gebruikers of organisatie-eenheden die toegang moeten krijgen. Aangepaste SAML-apps staan standaard voor iedereen uit — een veelvoorkomende reden waarom een nieuwe installatie niets lijkt te doen.

Stap 2: Vul de waarden in Spreash® in

  1. Zet in Account-instellingen → Single sign-on (SSO) de Provider op SAML.
  2. Neem de waarden over:
Waarde van je providerVeld in Spreash®
SSO-URL / sign-on-URLIdP SSO-URL
Entity ID / issuerIdP entity ID
Ondertekeningscertificaat (PEM)IdP X.509-certificaat
(alternatief) metadata-URLIdP metadata-URL
  1. Vul Toegestane e-maildomeinen in (zie Accountopties).
  2. Vink Single sign-on ingeschakeld aan en klik op Opslaan.

De IdP SSO-URL en de IdP metadata-URL moeten met https:// beginnen. Groepssynchronisatie werkt met SAML: vul bij Groepsclaimnaam de naam in van het attribuut waarin de groepen van de gebruiker worden meegestuurd.

Accountopties

Deze opties gelden voor elke provider en staan naast de providerinstellingen.

Single sign-on ingeschakeld

De hoofdschakelaar. Zolang deze uit staat, wordt de rest van de configuratie wel bewaard maar volledig genegeerd — iedereen logt gewoon in met een wachtwoord. Configureer eerst, controleer, en schakel daarna pas in.

Accounts zonder SSO toestaan

Bepaalt of inloggen met een wachtwoord naast SSO blijft bestaan.

  • Aan (standaard) — hybride modus. Gebruikers kunnen inloggen met SSO óf met een Spreash®-wachtwoord. Dit is de veilige instelling tijdens het testen, en de juiste instelling als je gebruikers hebt die niet in je identiteitsprovider staan, zoals externe medewerkers of serviceaccounts.
  • Uit — alleen SSO. Iedereen moet via je identiteitsprovider inloggen. Bestaande Spreash®-wachtwoorden werken niet meer.

⚠️

Laat deze instelling aan staan tijdens het inrichten. Zet hem pas uit als je hebt vastgesteld dat een echte gebruiker van begin tot eind via SSO kan inloggen. Als SSO verkeerd is geconfigureerd en inloggen met een wachtwoord uit staat, heb je je account buitengesloten en is hulp van Spreash® nodig om er weer in te komen.

Toegestane e-maildomeinen

Een lijst met de e-maildomeinen van je organisatie, gescheiden door komma's, bijvoorbeeld: acme.com, eu.acme.com

Dit is verplicht zodra je een provider selecteert, en het is wat een SSO-identiteit aan jouw account koppelt. Een gebruiker met een e-maildomein dat niet in deze lijst staat, wordt geweigerd — ook als het inloggen bij de identiteitsprovider zelf is gelukt.

Details die het weten waard zijn:

  • Subdomeinen tellen automatisch mee. Als je acme.com opgeeft, wordt gebruiker@eu.acme.com ook toegelaten. Je hoeft een subdomein alleen apart te vermelden als je het hoofddomein niet bezit.
  • Vul alleen kale domeinen in — geen @, geen spaties, en elke vermelding moet een punt bevatten. acme.com is goed; @acme.com en gebruiker@acme.com niet.
  • Spreash® laat je jezelf niet buitensluiten. Schakel je SSO in met een domeinlijst waar je eigen e-mailadres niet in valt, dan wordt het opslaan geweigerd met een uitleg in plaats van doorgevoerd.

In de hybride modus doet de domeinlijst nog iets nuttigs: een gebruiker met een domein dat er niet in staat, gaat meteen naar het wachtwoordscherm in plaats van via een SSO-poging die toch nooit kan slagen.

Groepssynchronisatie

Standaard beheer je groepslidmaatschap binnen Spreash® en regelt SSO alleen het inloggen. Zet Gebruikersgroepen synchroniseren vanuit SSO-claims aan om de groepen van elke gebruiker bij elke aanmelding door je identiteitsprovider te laten bepalen.

Niet beschikbaar voor Google: de inlogtokens bevatten geen groepsinformatie, dus de optie wordt verborgen.

Instellen

Omdat de toewijzingstabel pas verschijnt zodra de synchronisatie aan staat, kost dit twee keer opslaan:

  1. Vink Gebruikersgroepen synchroniseren vanuit SSO-claims aan.
  2. Vul de Groepsclaimnaam in: de naam van de claim die je provider gebruikt.

    • Microsoft Entra ID: wordt automatisch ingevuld en vergrendeld (altijd groups).
    • Algemene OpenID Connect / SAML: typ de claim- of attribuutnaam die je provider meestuurt, vaak groups of roles.
  3. Kies een Synchronisatiemodus (zie hieronder).
  4. Klik op Opslaan. Er verschijnt nu een kaart Groepssynchronisatie (SSO).
  5. Klik in die kaart op Toewijzing toevoegen en voeg per groep een regel toe: links de claimwaarde die je provider meestuurt, rechts de Spreash®-groep die daaraan gekoppeld moet worden. Sla de tabel op.

De claimwaarde moet exact overeenkomen met wat je provider meestuurt — vaak is dat een technische ID en geen leesbare naam. Bij Microsoft Entra is het de object-ID van de directory-rol. Raadpleeg de documentatie van je provider, of log één keer in en bekijk wat er is meegestuurd als je het niet zeker weet.

Synchronisatiemodi voor groepen

ModusVoegt gekoppelde groepen toeVerwijdert niet-gekoppelde groepenGebruik dit wanneer
Vervangen (IdP is leidend)JaJa — allemaalJe identiteitsprovider de enige bron van waarheid is voor toegang
Aanvullend (nooit groepen verwijderen)JaNeeJe wilt dat SSO toegang geeft maar nooit afneemt
Alleen beheerd (groepen buiten de SSO-sync behouden)JaAlleen groepen met een toewijzingJe directory-gestuurde groepen combineert met groepen die je handmatig toekent

Alleen beheerd is meestal de juiste keuze bij een gemengde inrichting: een groep zonder toewijzingsregel wordt volledig met rust gelaten, dus groepen die je handmatig in Spreash® toekent overleven elke aanmelding, terwijl de groepen die je wél hebt gekoppeld netjes de directory volgen.

⚠️

Lees dit voordat je synchronisatie in de modus Vervangen inschakelt. Groepssynchronisatie draait ook bij je eigen volgende aanmelding. In de modus Vervangen wordt elke groep die niet door een claim wordt gedekt verwijderd — inclusief je beheerdersgroep. Zorgt geen enkele toewijzing ervoor dat je weer in een beheerdersgroep terechtkomt, dan verlies je die rechten op het moment dat je opnieuw inlogt, en kun je deze instellingen niet meer bereiken om het terug te draaien.

Zorg dus dat minstens één toewijzing je eigen gebruiker in een beheerdersgroep plaatst. Weet je niet zeker wat je provider precies meestuurt, begin dan in de modus Aanvullend: die verwijdert nooit iets, zodat je rustig kunt bekijken wat er binnenkomt, je toewijzingen kunt bijstellen, en daarna kunt overschakelen naar Vervangen of Alleen beheerd.

Hoe inloggen eruitziet voor je gebruikers

Het inloggen in twee stappen

Inloggen op Spreash® begint altijd op dezelfde manier, of SSO nu is ingesteld of niet:

  1. De gebruiker vult de accountidentificatie en zijn e-mailadres in.
  2. Spreash® stuurt hem vervolgens door naar je identiteitsprovider, of toont het wachtwoordscherm.

Er is geen aparte SSO-URL die je moet uitdelen, en geen "Inloggen met…"-knop om te zoeken. Je gebruikers blijven dezelfde inlogpagina gebruiken; het doorsturen gebeurt automatisch.

Welke kant een gebruiker op gaat in de hybride modus (Accounts zonder SSO toestaan aan):

  • E-maildomein staat niet in de toegestane lijst → wachtwoordscherm.
  • Nog geen Spreash®-gebruiker, of geen bruikbaar wachtwoord (bijvoorbeeld aangemaakt via SSO) → identiteitsprovider.
  • Actieve gebruiker met een Spreash®-wachtwoord → wachtwoordscherm.

Staat Accounts zonder SSO toestaan uit, dan gaat iedereen naar de identiteitsprovider. De enige uitzondering zijn superusers van Spreash®, die wachtwoordtoegang houden zodat een account altijd te herstellen is.

De overdracht bij het inloggen is maar kort geldig. Laat een gebruiker de pagina enkele minuten openstaan, dan verschijnt "De inlogsessie is verlopen. Probeer het opnieuw" en begint hij simpelweg opnieuw.

De eerste aanmelding maakt de gebruiker aan

Je hoeft gebruikers niet vooraf in Spreash® aan te maken. De eerste keer dat iemand succesvol via je identiteitsprovider inlogt, maakt Spreash® de gebruiker automatisch aan met het e-mailadres en de naam die je provider meestuurt. Die gebruiker begint zonder groepen, dus een beheerder bepaalt nog steeds wat hij mag zien — tenzij groepssynchronisatie aan staat, want dan worden zijn groepen al bij de allereerste aanmelding ingesteld.

Gebruikers die zo zijn aangemaakt hebben geen Spreash®-wachtwoord. Zet je Accounts zonder SSO toestaan later weer aan, dan kunnen zij nog steeds geen wachtwoord gebruiken totdat er één is ingesteld.

Bestaande gebruikers

Een bestaande Spreash®-gebruiker wordt gekoppeld op e-mailadres, dus er wordt niets gedupliceerd en er gaat niets verloren: groepen, instellingen en historie blijven precies zoals ze waren. Ze komen alleen voortaan binnen via je identiteitsprovider in plaats van via het wachtwoordscherm.

Wachtwoorden en tweefactorauthenticatie

Logt een gebruiker in via SSO, dan is je identiteitsprovider verantwoordelijk voor de authenticatie. Spreash® vraagt dan niet om een tweede factor, en wachtwoord- en 2FA-selfservice zijn voor die sessie uitgeschakeld. Regel multifactorauthenticatie in je identiteitsprovider — daar geldt het namelijk voor al je applicaties, niet alleen voor Spreash®.

Iemand deactiveren

  • Microsoft Entra ID en SAML kunnen aan Spreash® doorgeven dat een gebruiker is uitgeschakeld, mits je provider is ingesteld om een accountEnabled-claim mee te sturen. Staat die op uitgeschakeld, dan weigert Spreash® de aanmelding en zet de gebruiker ook in Spreash® op inactief.
  • Google en Algemene OpenID Connect sturen hiervoor geen standaardsignaal mee. Spreash® vertrouwt dan op het weigeren van de aanmelding door je provider, plus op wat je zelf in Spreash® instelt. Een gebruiker die je in Spreash® deactiveert blijft geblokkeerd, ongeacht wat de provider zegt.

Een gebruiker deactiveren in je directory stopt het inloggen sowieso, omdat de aanmelding je provider dan niet eens voorbijkomt. De claim is alleen van belang om de registratie in Spreash® gelijk te houden.

Problemen oplossen

Meldingen die je gebruikers kunnen zien

MeldingWat het betekentWat je doet
"Je e-maildomein is niet toegestaan voor single sign-on bij deze organisatie."De provider stuurde een e-mailadres mee waarvan het domein niet in Toegestane e-maildomeinen staat.Voeg het domein toe aan de lijst. Controleer op een domein dat je wel bezit maar bent vergeten, bijvoorbeeld een landendomein.
"Je identiteitsprovider heeft geen e-mailadres meegestuurd."Het inloggen slaagde, maar er kwam geen e-mailclaim mee.Voeg een e-mailclaim of attribuuttoewijzing toe aan je applicatie. Zonder e-mailadres kan Spreash® niemand inloggen.
"Je identiteitsprovider geeft aan dat je e-mailadres niet is geverifieerd."De provider stuurde expliciet email_verified: false mee.Verifieer het adres bij de provider.
"Dit e-mailadres hoort al bij een gebruiker in een andere organisatie."Het e-mailadres is al in gebruik door een actieve gebruiker in een ander Spreash®-account.Neem contact op met Spreash®-support; hetzelfde adres kan niet in twee organisaties actief zijn.
"Je account is uitgeschakeld door je identiteitsprovider."Je provider stuurde accountEnabled: false mee.Schakel de gebruiker weer in binnen je directory.
"Je account is gedeactiveerd. Neem contact op met je beheerder om weer toegang te krijgen."De gebruiker is in Spreash® gedeactiveerd.Activeer hem weer in Spreash®.
"Single sign-on is geannuleerd." / "Je identiteitsprovider heeft het inlogverzoek geweigerd."De gebruiker annuleerde bij de provider, of de provider weigerde.Controleer bij een weigering of de gebruiker aan de applicatie is toegewezen en of de toestemming is gegeven.
"We konden single sign-on niet voltooien. Probeer het opnieuw."Een algemene fout in de uitwisseling met de provider.Meestal een niet-overeenkomende redirect-URI of een verlopen client-secret. Zie hieronder.
"De inlogsessie is verlopen. Probeer het opnieuw."De gebruiker deed te lang over de twee inlogstappen.Onschuldig — opnieuw beginnen.
"Single sign-on is niet geconfigureerd voor dit account." (getoond als pagina-niet-gevonden)SSO staat niet aan, of er is geen provider geselecteerd.Controleer of Single sign-on ingeschakeld is aangevinkt en opgeslagen.

Veelvoorkomende installatieproblemen

"We konden single sign-on niet voltooien" bij elke poging, met je eigen applicatie:

  • Redirect-URI komt niet overeen. De URI die je bij je provider hebt geregistreerd moet exact overeenkomen met die van Spreash®, inclusief https://, de exacte host en de afsluitende schuine streep. Vergelijk ze teken voor teken.
  • Verlopen client-secret. De meeste providers laten secrets na 6 tot 24 maanden verlopen. Genereer een nieuwe en plak die in Client-secret. Dit is de meest voorkomende oorzaak van een SSO-koppeling die een jaar werkte en dan ineens stopt.
  • Verkeerde discovery-URL. Open hem in een browser: je hoort JSON terug te krijgen, geen foutpagina of inlogscherm.

Veelvoorkomende situaties

  • Er gebeurt niets; gebruikers worden niet doorgestuurd naar de provider. 
  • Controleer of Single sign-on ingeschakeld is aangevinkt en opgeslagen. Denk er in de hybride modus aan dat een gebruiker met een actief Spreash®-wachtwoord bewust naar het wachtwoordscherm wordt gestuurd. Wil je de SSO-route testen, gebruik dan een gebruiker zonder Spreash®-wachtwoord.
  • Microsoft: een toestemmingsscherm waar de gebruiker niet voorbijkomt. 
  • Een Global Administrator van je tenant moet eenmalig toestemming geven. Zie de sectie Microsoft Entra ID.
  • SAML: het inloggen mislukt direct bij de provider. 
  • Waarschijnlijk staat de applicatie niet aan of is hij niet aan die gebruiker toegewezen. Aangepaste SAML-apps staan bij de meeste providers standaard uit.
  • Groepssynchronisatie kent niets toe. 
  • Controleer of de claimnaam klopt, en of de claimwaarden in je toewijzingsregels exact overeenkomen met wat de provider meestuurt — bij Microsoft Entra zijn dat object-ID's van directory-rollen, geen rolnamen. Denk eraan dat groepssynchronisatie alleen bij het inloggen wordt toegepast: een gebruiker moet uitloggen en opnieuw inloggen voordat een gewijzigde toewijzing bij hem aankomt.

Buitengesloten?

Staat SSO aan, is inloggen met een wachtwoord uit, en kan niemand meer inloggen? Neem contact op met Spreash®-support via contact@spreash.com. Dit is precies de reden waarom we aanraden om Accounts zonder SSO toestaan aan te laten staan totdat je hebt vastgesteld dat een echte SSO-aanmelding van begin tot eind werkt.

Gerelateerde pagina's

  • Account-instellingen / Bekijken — de accountbrede instellingen inzien, waaronder de SSO-kaart
  • Account-instellingen / Bewerken — de accountbrede instellingen aanpassen
  • Gebruikers & Groepen — de groepen waaraan je gebruikers koppelt en waarnaar groepssynchronisatie verwijst
  • Inloggen — hoe het inloggen in twee stappen werkt voor je gebruikers
⚠️

Kom je er niet uit? Gebruik de Hulp nodig?-knop rechtsboven in Spreash® om direct een ticket in te sturen vanuit jouw Spreash®-omgeving. 

We helpen je zo snel mogelijk verder.  Laat het ons weten via het feedbackformulier onderaan de pagina. Je kunt ook aangeven wat onduidelijk was of wat je miste.