RESPONSUM maakt het mogelijk om een specifieke kantomgeving te koppelen aan een of meer Okta-directories van de klant.
Een kleine voorafgaande configuratie door het IT-team dat Okta beheert, is vereist om de SSO-koppeling tussen Okta en RESPONSUM in te stellen.
Stap 1: Verzoek indienen om een Okta SSO-integratie te activeren
Stuur ons een e-mail via support@responsum.eu met een korte beschrijving dat u Okta wilt activeren voor uw RESPONSUM-omgeving. Als antwoord van ons ontvangt u een Redirect-URL die u nodig heeft voor de volgende stappen.
De URL die u ontvangt, zal er ongeveer als volgt uitzien:
- https://id.responsum.app/realms/
/broker/oidc/endpoint - https://be2.responsum.app/sso/callback
Stap 2: Een Okta-applicatie aanmaken voor de SSO-synchronisatie
- Navigeer naar uw Okta-beheerderspaneel en ga in de hoofdnavigatiebalk naar de subsectie “Applications” en selecteer daaronder “Applications” (Directe link: https://
.okta.com/admin/apps/active)

- Selecteer “Create App integration”
- Er verschijnt een pop-up waarin u een “sign-in method” en “Application type” kunt selecteren
- Het type aanmelding (Sign-in type) moet “OIDC – OpenID Connect” zijn
- Het type applicatie (Application type) moet “Web Application” zijn

- Er wordt een nieuwe pagina geopend waarin om meer details over de applicatie wordt gevraagd:
- App integration name: Dit kan een herkenbare naam zijn voor deze integratie tussen Okta and RESPONSUM, zoals bijv. “RESPONSUM SSO Login”
- Logo: Optioneel, dus dit kan leeg gelaten worden
- Grant type: de geselecteerde standaardwaarden kunnen hier worden behouden
- Sign-in redirect URIs: Laat dit voorlopig leeg en plak de waarde die u van RESPONSUM heeft ontvangen als resultaat van stap 3.
- Sign-out redirect URIs: De afmeldingsrespons naar Okta kan worden ingesteld door de bovenstaande sign-in redirect-URL te nemen en “/logout_response” aan het einde van die URL toe te voegen.
- Base URIs: Optioneel, dus dit kan leeg gelaten worden
- Controlled access: Afhankelijk van of u de mogelijkheid om in te loggen op RESPONSUM wilt bieden aan de gehele Okta-organisatie of aan een geselecteerde groep. De gekozen optie hangt af van uw specifieke use case.
- Rond af door op “Save” te klikken
- Noteer de Client ID en Client Secret die worden getoond, om deze later in stap 3 te gebruiken
Stap 3: De gegevens van de Authorization server van uw Okta-omgeving vinden (Oauth 2)
- Hieronder vindt u twee manieren om de gegevens van de autorisatieserver te vinden. Afhankelijk van uw Okta-abonnement is optie 3B mogelijk niet beschikbaar. Gebruik in dat geval optie 3A:
Stap 3A: De URL zelf samenstellen op basis van uw omgevingsdetails
- Okta beschrijft in deze gids hoe u de URL’s van de Oauth- en OpenID-autorisatieserver kunt bepalen. Gebruik in dit geval de Oauth-instructie.
- Samenvattend moet de URL de volgende structuur hebben:
- https://<uwOktaOrg>/.well-known/oauth-authorization-server
- Voorbeeld: https://responsum.okta.com/.well-known/oauth-authorization-server
Stap 3B: Gebruik het API access management portal (indien onderdeel van uw abonnement en/of als er meerdere autorisatieservers zijn gedefinieerd)
- Navigeer in het Okta-beheerdersportaal via het zijmenu naar het tabblad Security >> API >> Authorization servers. Hier zult u zien dat u normaal gesproken een “Default” autorisatieserver heeft.

- Klik door op de naam “Default” in het overzicht om naar de detailpagina te gaan.
- Kopieer de waarde van de “Metadata URI” voor later gebruik in stap 3

Stap 4: De informatie bundelen en aan RESPONSUM verstrekken
Kopieer de gecombineerde informatie uit stap 2 en 3 in 3 afzonderlijke e-mails naar support@responsum.eu:
- Client ID
- Client Secret
- Authorization URL
Wanneer wij uw integratie instellen op basis van de bovenstaande gegevens, zullen wij u de juiste redirect-URL’s en logout-URL’s verstrekken die aan de app in Okta moeten worden toegevoegd om deze volledig operationeel te maken.
Indien u extra beveiliging wenst voor de overdracht van deze inloggegevens, stuur ons dan vooraf een e-mail via support@responsum.eu. Wij zullen dan een beveiligde uploadzone voorzien waar u de inloggegevens kunt uploaden en rechtstreeks aan ons kunt verstrekken.
Wij gaan nu aan de slag om de SSO-integratie voor uw specifieke omgeving in te stellen. Wij nemen contact met u op via een antwoord op een van de e-mails wanneer de integratie geactiveerd en beschikbaar is. Voer na deze communicatie een grondige test uit om te zien of alles naar behoren werkt.
Veel plezier met het gebruik van Okta om in te loggen bij RESPONSUM!