Overslaan en naar hoofdcontent gaan

Single sign-on (SSO) instellen

Bijgewerkt

Als u al een actieve SSO-verbinding heeft, blijft uw configuratie gewoon werken. U hoeft nu geen actie te ondernemen.

Wij raden echter aan om over te stappen naar Auth0, omdat dit een veel betere gebruikerservaring biedt en veiliger is. Meer informatie over de voordelen en hoe eenvoudig het instellen is, vindt u hier: Migratie naar Auth0 SSO

Vereisten

  1. Geen gebruik van verouderde SSO: U moet ofwel nieuw zijn met SSO bij SoSafe, ofwel uw bestaande SSO-configuratie verbreken.
  2. Ondersteunde enterprise-identiteitsprovider: U moet een identiteitsprovider gebruiken die door Auth0 wordt ondersteund. Alle grote identiteitsproviders, waaronder Azure AD/Entra, Google Workspace, OIDC en SAML, worden ondersteund. Raadpleeg voor meer informatie de Auth0-ondersteuningspagina's.
  3. Zorg dat uw gegevens in orde zijn: Zorg ervoor dat alle gebruikers zijn aangemeld bij SoSafe. Zorg er daarnaast voor dat de e-mailadressen van de gebruikers aanwezig zijn in de gegevens van uw identiteitsprovider en zijn opgeslagen in het juiste veld. Welk veld dit precies is, hangt af van uw provider. Voor Microsoft Entra werkt userPrincipalName of mail.

Installatie-instructies

  1. Ga naar Settings / SSO. Als SSO ontbreekt, neem dan contact op met uw Customer Success Manager zodat het voor uw account kan worden ingeschakeld.

    SoSafe Manager-authenticatiepagina onder Settings, met SSO geselecteerd in de linkernavigatie. De sectie SSO-verbindingen toont geen geconfigureerde verbindingen, met een knop SSO-verbinding toevoegen en een melding dat gebruikers zich aanmelden met e-mail en wachtwoord totdat een verbinding is geverifieerd.

  2. Selecteer + Add SSO connection. Er wordt een nieuw dialoogvenster geopend. Geef uw verbinding een naam en selecteer Create Connection.

    Dialoogvenster SSO-verbinding toevoegen in de SoSafe Manager, met het veld Verbindingsnaam ingevuld als ESSOTest en de knop Create Connection eronder.

  3. U ontvangt nu een link waarmee u de installatie stap voor stap kunt doorlopen. Het meeste werk vindt nu plaats aan de kant van de identiteitsprovider en alle benodigde informatie wordt via deze wizard aangeboden. Als u beheerdersrechten heeft voor uw identiteitsprovider, kunt u direct verdergaan door Open setup te selecteren. Als u geen beheerdersrechten heeft, kunt u Copy link selecteren en deze URL naar een beheerder sturen. U kunt ook een link naar dit artikel sturen om meer context te bieden.

    Dialoogvenster SSO-verbinding instellen in de SoSafe Manager, met het veld Setup SSO-verbindingslink en de knoppen Copy link en Open setup om te delen met een beheerder of de installatie voort te zetten.

Deze link is slechts 1 uur geldig en heeft een beperkt aantal gebruiksmogelijkheden voor betere beveiliging. U kunt altijd een nieuwe link genereren indien nodig. Selecteer daarvoor Regenerate setup link bij de SSO-verbindingsvermelding op de pagina Settings / SSO in de Manager.

  1. Volg de installatiewizard. Let op dat u op bepaalde punten wordt gevraagd bepaalde technische informatie te noteren die u later opnieuw nodig heeft. We bieden gedetailleerde instructies voor Entra ID en Google Workspace. Voor custom SAML- of OIDC-verbindingen bieden we alle benodigde technische informatie, maar de specifieke stappen in uw identiteitsprovider vallen buiten het bereik van onze wizard.

Alleen voor Google Workspace-gebruikers:

In de wizard begint stap 3 ("Assign Access") met het aanmaken van een nieuwe organisatie-eenheid. In onze ervaring is dit meestal niet nodig. Ga in plaats daarvan verder met de stap "Ga naar Security > Access and data control > API controls in de linkernavigatie en klik op Manage Third-Party App Access." Wanneer u wordt gevraagd het bereik in te stellen, kunt u "All in <your organization> (all users)" selecteren. Alleen gebruikers die zijn aangemeld, kunnen zich via SSO aanmelden. Op deze manier hoeft u de bestaande configuratie van uw organisatie-eenheid niet te wijzigen.

  1. Voordat u uw verbinding aan het einde van de installatiewizard test, moet u ervoor zorgen dat u toegang heeft verleend aan uw testgebruiker (bijv. uw eigen account) of aan alle gebruikers die toegang moeten krijgen via SSO. Selecteer Verbinding controleren.

    Wizard Custom SAML configureren op stap 3, SSO testen, met de knop Verbinding controleren en de knop Verbinding inschakelen, naast de voltooide stappen 1 Applicatie aanmaken en 2 SSO-verbinding configureren.

  2. Er wordt een nieuw tabblad geopend en mogelijk wordt u gevraagd uw bedrijfsaccountgegevens in te voeren. Als de test is geslaagd, kunt u het tabblad sluiten en krijgt u een voorbeeld te zien van de ingediende gebruikersinformatie.

    Stap SSO testen van de wizard Custom SAML configureren na een geslaagde test, met een sectie Test geslaagd met een voorbeeld van de geretourneerde gebruikersattributen, waaronder gebruikers-ID, e-mail, naam en identiteitsprovider, en de knop Verbinding inschakelen.

  3. Selecteer Enable Connection. Uw SSO is nu actief en werkend. Controleer of het wordt weergegeven als " verified" op Settings / SSO in de Manager.

Het kan tot 10 minuten duren voordat alle gegevens zijn gesynchroniseerd. Alleen gebruikers van wie de e-mailadressen in uw gebruikersgegevens staan, kunnen inloggen.

Auth0 SSO uitschakelen en verwijderen

  1. Ga naar Settings / SSO in de Manager en selecteer Remove. U wordt gevraagd de verwijdering te bevestigen.
Bevestigingsdialoogvenster Verbinding verwijderen in de SoSafe Manager, met de waarschuwing dat het verwijderen van de SSO-verbinding niet ongedaan kan worden gemaakt en geverifieerde gebruikers de verbinding verliest, met een veld om DELETE in te typen ter bevestiging en een knop Ja, verbinding verwijderen.
  1. Aanbevolen: Verwijder in uw identiteitsprovider de applicatie die u tijdens het installatieproces heeft aangemaakt.

Vervaldatums van secrets beheren

Auth0 SSO-verbindingen zijn gebaseerd op een gedeeld secret dat u aanmaakt en tijdens het instellen van de verbinding aan SoSafe verstrekt. Om veiligheidsredenen hebben deze doorgaans een vervaldatum. Dit betekent dat u het secret uiteindelijk moet vernieuwen om de verbinding werkend te houden. Wij raden aan de vervaldatum van het secret bij te houden. Om dit eenvoudiger te maken, kunt u de vervaldatum voor de verbinding opslaan in de Manager, zodat u weet wanneer u het secret moet bijwerken.

Een vervaldatum toevoegen

  1. Ga in de Manager naar Settings / SSO. Zoek uw SSO-verbinding op en selecteer Secret vervaldatum toevoegen. Er wordt een nieuw dialoogvenster geopend.

    Pagina SSO-verbindingen van de SoSafe Manager met de Entra-verbinding weergegeven als Geverifieerd en zonder toegevoegde secret-vervaldatum, en de knop Secret vervaldatum toevoegen gemarkeerd.

     

  2. Voeg hier de vervaldatum toe door de datumkiezer te selecteren. Selecteer daarna Save & validate.

    Dialoogvenster Secret-informatie - Entra in de SoSafe Manager, met een datum ingevoerd in het veld Vervaldatum secret of certificaat en de knop Opslaan en valideren eronder.

Uw secret bijwerken

  1. Ga in de Manager naar Settings / SSO. Zoek uw SSO-verbinding op en selecteer Secret-info bijwerken. Er wordt een nieuw dialoogvenster geopend.

    Pagina SSO-verbindingen van de SoSafe Manager met de Entra-verbinding weergegeven als Geverifieerd, een knop Secret-info bijwerken en de resterende geldigheidsduur van het huidige secret ernaast weergegeven.

  2. Plak de bijgewerkte secret-informatie in het eerste tekstveld. Gebruik vervolgens de datumkiezer om uw vervaldatum bij te werken. Selecteer daarna Save & validate.

    Dialoogvenster Secret-informatie - Entra in de SoSafe Manager, met het veld Client secret of certificaat ingevuld, een ingevoerde vervaldatum met een optie om deze te wissen, en de knop Opslaan en valideren eronder.

 

Aanmeldingsopties

Er zijn twee beschikbare opties om te bepalen hoe gebruikers zich kunnen aanmelden nadat u Auth0 SSO heeft geactiveerd:

  1. Pure SSO-aanmelding: Wanneer deze optie is geactiveerd, kunnen alle gebruikers zich alleen via SSO aanmelden als ten minste één SSO-verbinding is geverifieerd. Dit is onze aanbeveling.
  2. Hybride aanmelding: Wanneer deze optie is geactiveerd, kunnen gebruikers inloggen met hun e-mail- en wachtwoordgegevens of via een SSO-verbinding. Dit kan handig zijn wanneer niet alle gebruikers zijn opgenomen in de gegevens van uw identiteitsprovider, of wanneer bepaalde gebruikers (bijv. admin users) zich toch via e-mail en wachtwoord moeten kunnen aanmelden.
Pagina SSO-verbindingen van de SoSafe Manager met de link SSO-aanmelding gemarkeerd naast SSO-verbinding toevoegen, en de Entra-verbinding eronder weergegeven als Geverifieerd.

Om deze instelling te wijzigen, selecteert u de tekst links van + Add SSO connection (zie hierboven). Deze tekst toont ook de huidige instelling. Er wordt een nieuw dialoogvenster geopend waarmee u deze instelling kunt wijzigen:

Dialoogvenster Aanmeldingsopties in de SoSafe Manager, met de schakelaar Pure SSO-aanmelding ingeschakeld en een opmerking dat aanmelden met e-mail en wachtwoord automatisch wordt uitgeschakeld zodra een SSO-verbinding is geverifieerd.

Deze vertaling is geautomatiseerd. Bekijk bij twijfel de Engelse versie.

Verwante artikelen