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 uw 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 aanmaken, meld je dan aan op 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 ze 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. Zet in de linker navigatie Applicaties en Bronnen uit 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. Navigeer naar Instellingen () > Gebruikers & machtigingen > Enterprise SSO.
3. Klik op Create SSO > OpenID Connect.

4. Selecteer bij de Step Choose IdP Okta als je identiteitsprovider. Document360 navigeert automatisch naar de stap SP (Service Provider) configureren .

5. Selecteer in het dialoog 'SP configureren ' 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 + om deze als chip toe te voegen. Dit bepaalt 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. Deze kan niet binnen dezelfde OIDC-applicatie worden ingeschakeld.

Als je geen SCIM-provisioning nodig hebt, zet dan SCIM-provisioning inschakelen uit en ga je verder naar hieronder de SSO-naam en inlogopties Configureren .

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 selectievakje API-integratie inschakelen . 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 in 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 door te gaan naar de laatste configuratievelden.

Configureer SSO-naam en inlogopties

1. Voer in het veld voor de SSO-naam een naam in voor de SSO-configuratie.
2. Voer in het tekstveld van de Login-knop 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 inricht. Lees meer over de groep voor lezer automatisch toewijzen.
4. Zet indien nodig de timeout van de idle-sessie SSO in en stel de timeout-duur in (HH:MM), waarna een idle SSO-gebruiker automatisch wordt uitgelogd.
5. Kies of je bestaande gebruikers- en lezersaccounts uitnodigt bij SSO.

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

Stap 6: 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 with 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 Testapp-versie.
• Voltooi de Document360 Enterprise SSO-configuratie voordat je SCIM test. Het klikken op Test Connector Configuration voordat je de Document360-configuratie opslaat, zal falen. Sla altijd eerst de Document360-configuratie op en keer dan 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, het bijwerken van gebruikersattributen en het deactiveren van gebruikers.

FAQ