Okta met OpenID SSO

Okta is een Identity Provider (IdP) die gebruikerstoegang beheert over meerdere applicaties vanaf één platform. Met OpenID Connect SSO geconfigureerd tussen Okta en Document360, kunnen je gebruikers en lezers inloggen op Document360 met hun bestaande Okta-inloggegevens.

Wat je kunt doen met Okta als je IdP

Voordat je begint

• Je hebt een actief Okta-account met beheerdersrecht. Als je er een moet maken, meld je dan aan bij developer.okta.com/signup.
• Je hebt eigenaar - of beheerdersrechten in je Document360-project.
• Open Document360 en Okta in twee aparte browsertabbladen. Je zult tijdens de installatie meerdere keren tussen deze moeten wisselen.

Stap 1: Maak een OpenID Connect-applicatie aan in Okta

1. Log in op je Okta-account en klik rechtsboven op Admin om over te schakelen naar de beheerdersconsole.
2. Vemeer in de linkernavigatie Applicaties en klik op Applicaties.
3. Klik op App-integratie aanmaken.
4. Selecteer OIDC - OpenID Connect als aanmeldmethode.
5. Kies Webapplicatie als applicatietype en klik op Volgende.
6. Op de pagina Nieuwe Webapplicatie-integratie voert u een naam van uw applicatie in het veld App-integratienaam .

Stap 2: Haal de SP-parameters op van Document360

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

4. Selecteer Okta als je identiteitsprovider om automatisch naar de pagina Configureer the Service Provider (SP) te navigeren.

5. Op de pagina Configureren van de Service Provider (SP) selecteer je de OpenID-radioknop .
6. Er wordt een set parameters weergegeven.

Stap 3: Voer de Document360-parameters in in Okta

1. Schakel over naar het tabblad Okta op de pagina Nieuwe Webapplicatie-integratie .
2. Voer de parameters van Document360 in met behulp van de onderstaande mapping.

3. Scroll naar beneden naar Toewijzingen en selecteer de gewenste optie voor gecontroleerde toegang .

4. Klik op Opslaan. Je wordt doorgestuurd naar de algemene pagina van de aanvraag.

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 Okta-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 Okta opvraagt. Je kunt tot 3 scopes toevoegen.
4. Zorg ervoor dat de Client ID en Client Secret overeenkomen met de waarden die in Okta worden gegenereerd.

5. Klik op Volgende om door te gaan naar de SCIM-provisioningpagina .

Stap 5: Configureer SCIM-provisioning

SCIM-provisioning automatiseert het beheer van de levenscyclus van gebruikers en lezers tussen Okta en Document360. Bij gebruik van OpenID Connect vereist SCIM een aparte OAuth Bearer Token-app in de Okta-catalogus. Het kan niet worden ingeschakeld binnen dezelfde OIDC-applicatie.

Als je geen SCIM-provisioning nodig hebt, ga dan naar stap 6: Configureer SSO-naam en inlogopties.

Schakel SCIM in in Document360 in

1. Zet de schakelaar SCIM inschakelen aan .
2. Er verschijnt een bevestigingsdialoog. Bekijk de voorwaarden en klik op Akkoord.
3. De parameters die nodig zijn om de SCIM-configuratie in Okta te voltooien, worden vervolgens weergegeven.

Voeg de SCIM OAuth Bearer Token-app toe in Okta

1. Uit in Okta Applicaties in de linker navigatie en klik op Applicaties.
2. Klik op Browse App Catalog en zoek op SCIM 2.0 (OAuth Bearer Token), selecteer vervolgens 'Alle resultaten zien'.

3. Selecteer in de zoekresultaten (OAuth Bearer Token) Governance met SCIM 2.0 en klik op Integratie toevoegen.

4. Op de pagina Algemene Instellingen kun je het applicatielabel wijzigen indien nodig en op Volgende klikken.

5. Klik op Klaar op de pagina Aanmeld-optie .

Configureer de SCIM API-verbinding in Okta

1. Ga in de SCIM-app naar het tabblad Provisioning en selecteer API-integratie configureren.
2. Selecteer het vakje API-integratie activeren . Er wordt een set velden weergegeven.
3. Voer de parameters van Document360 in met behulp van de onderstaande mapping.

4. Als dat klaar is, ga je terug naar Document360 om de configuratie te voltooien.

Wijs standaardrollen en groepen toe in Document360

1. Zet indien nodig de schakelaar groepssynchronisatie inschakelen in.
2. In het veld Standaardrol staat de rol standaard op Bijdrager . Je kunt dit wijzigen via het dropdownmenu indien nodig.
3. Selecteer in de velden Gebruikersgroepen en Lezergroepen de groepen die je wilt toevoegen. Meerdere groepen kunnen worden toegevoegd, en ze erven de standaardrol die je eerder hebt gekozen.
4. Klik op Volgende om naar de pagina Meer-instellingen te gaan.

Stap 6: 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. Automatisch toewijzen van lezergroep — deze optie is alleen beschikbaar voor bestaande SSO-configuraties. 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. Schakel de uitloggende SSO-gebruiker in indien nodig, en zet hem aan 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.

Stap 7: Volledige SCIM-integratie in Okta

1. Ga terug naar de Okta SCIM-app.
2. Klik op Test API-inloggegevens. Er verschijnt een succesbericht dat bevestigt dat de SCIM-app succesvol is geïntegreerd.

3. Klik op Opslaan.
4. Ga naar het tabblad Provisioning , selecteer Naar App, en klik op Bewerken in het gedeelte Provisioning to App .
5. Selecteer alleen de volgende ondersteunde acties:
   • Maak gebruikers aan
   • Werk gebruikersattributen bij
   • Deactiveer gebruikers

6. Klik op Opslaan.

SCIM-provisioning met Okta OpenID Connect is nu succesvol geconfigureerd.

De SSO-configuratie gebaseerd op het OpenID-protocol is succesvol geconfigureerd met Okta.

Best practices

• Gebruik een aparte SCIM-app voor provisioning. Bij gebruik van OpenID Connect met Okta vereist SCIM een eigen OAuth Bearer Token-app uit de Okta-catalogus. Probeer SCIM niet in te schakelen binnen de OIDC-app.
• Selecteer de juiste SCIM-app. Zoek specifiek naar (OAuth Bearer Token) Governance met SCIM 2.0 . Selecteer niet de Test-app versie.
• Voltooi de Document360 SSO-configuratie voordat je SCIM test. Als je op Test Connector Configuration klikt voordat je de Document360-configuratie opslaat, mislukt dat. Sla altijd eerst de Document360-configuratie op en ga daarna terug naar Okta om te testen.
• Selecteer alleen de drie ondersteunde provisioning-acties. Het inschakelen van niet-ondersteunde acties kan provisioningfouten veroorzaken. Beperk de selectie tot het aanmaken van gebruikers, werk gebruikersattributen bij en deactiveer gebruikers.

FAQ