Auth0 met OpenID SSO

Auth0 is een cloudgebaseerde Identity Provider (IdP) waarmee je gebruikers en lezers kunnen inloggen op Document360 met hun bestaande Auth0-inloggegevens via het OpenID Connect-protocol. In plaats van aparte wachtwoorden voor Document360 te beheren, authenticeren gebruikers via Auth0, waardoor uw organisatie gecentraliseerde toegangscontrole en een consistente inlogervaring heeft.

Wat je kunt doen met Auth0 als je IdP

Voordat je begint

• Je hebt een actief Auth0-account. Als je er een moet aanmaken, meld je dan aan bij auth0.com/signup.
• Je hebt eigenaar - of beheerdersrechten in je Document360-project.
• Open Document360 en Auth0 in twee aparte browsertabbladen voordat je begint.

Hoe Auth0 OpenID SSO te configureren in Document360

Stap 1: Maak een applicatie aan in Auth0

1. Log in op je Auth0-account. Na het inloggen vind je het menu Applicaties in de linker navigatie.
2. Klik op Applicaties > Aanmaken Applicatie.
3. Voer een naam in voor je applicatie en kies Reguliere Webapplicaties als applicatietype.
4. Klik op Aanmaken.

Stap 2: Haal de SP-parameters op van Document360

1. Open Document360 in een apart tabblad.
2. Ga naar Instellingen () > Gebruikers & machtigingen > SSO-configuratie.
3. Klik op Create SSO.

4. Selecteer Overigen als uw identiteitsprovider op de pagina Kies uw identiteitsprovider (IdP).

5. Kies OpenID als protocol op de pagina Configure the Service Provider (SP).

Deze pagina toont de parameters die je moet configureren in Auth0.

Stap 3: Voer de parameters van Document360 in Auth0 in

Voer in je Auth0-applicatieinstellingen de Document360-parameters in met behulp van de onderstaande mapping.

Zodra je alle vereiste velden hebt ingevoerd, klik je onderaan de pagina op Wijzigingen opslaan .

Stap 4: Configureer de identiteitsprovider in Document360

1. Keer terug naar Document360 op de pagina Configureer de Service Provider (SP) en klik op Volgende om naar de pagina Configureer de Identity Provider (IdP) te gaan.

2. Voer de bijbehorende waarden in vanuit je Auth0-applicatie met behulp van de onderstaande mapping.

3. Typ in het veld Scope (optioneel) een scope-waarde in en klik op + om deze als chip toe te voegen. Dit definieert welke gebruikersinformatie of rechten Document360 van Auth0 opvraagt. Je kunt tot 3 scopes toevoegen.
4. Klik op Volgend om naar de pagina Meer instellingen te gaan.

Stap 5: Configureer de SSO-naam en inlogopties

1. Voer in het veld voor de SSO-naam een naam in voor de SSO-configuratie.
2. Voer in de knop 'Inlogen aanpas' de tekst in voor de inlogknop die aan gebruikers wordt weergegeven.
3. Zet automatisch de lezersgroep aan of uit indien nodig. Voor nieuw aangemaakte SSO-configuraties wordt deze schakelaar niet weergegeven omdat SCIM automatisch gebruikers en groepen provisioneert. Lees meer over de Auto assign reader-groep.
4. Zet of uit Uitloggen en inactieve SSO-gebruiker aan of uit op basis van je vereisten.
5. Kies of je bestaande gebruikers- en lezersaccounts uitnodigt bij SSO.

6. Klik op Aanmaken om de OpenID SSO-configuratie te voltooien.

De SSO-configuratie met Auth0 en het OpenID Connect-protocol is nu actief in Document360.

Best practices

• Gebruik de domeinwaarde voor Autoriteit. Auth0 biedt een domeinveld in je applicatie-instellingen. Dit is gekoppeld aan het Authority-veld in Document360, niet aan een Issuer URI of volledige URL.
• Plak de Sign-in omleidings-URI in beide velden. De Sign-in redirect-URI van Document360 moet zowel in Application Login URI als Allowed Callback URL's in Auth0 worden ingevoerd. Het missen van een van beide velden veroorzaakt authenticatiefouten.
• Test eerst met één gebruiker. Controleer voordat je SSO uitrolt naar alle gebruikers, de configuratie met één testaccount om te bevestigen dat de Client ID, Client Secret, Domain en redirect URI's correct zijn ingesteld.

FAQ