RESPONSUM ermöglicht es, eine spezifische Kundenumgebung mit einem oder mehreren Okta-Verzeichnissen des Kunden zu verknüpfen.
Um die SSO-Verbindung zwischen Okta und RESPONSUM einzurichten, ist eine geringfügige Vorabkonfiguration durch das IT-Team erforderlich, das Okta verwaltet.
Schritt 1: Beantragen Sie die Aktivierung einer Okta-SSO-Integration
Senden Sie uns eine E-Mail an support@responsum.eu mit einer kurzen Beschreibung, dass Sie Okta für Ihre RESPONSUM-Umgebung aktivieren möchten. Als Antwort von uns erhalten Sie eine Redirect-URL, die Sie für die nächsten Schritte benötigen.
Die URL, die Sie erhalten, wird in etwa so aussehen:
- https://id.responsum.app/realms/
/broker/oidc/endpoint - https://be2.responsum.app/sso/callback
Schritt 2: Erstellen Sie eine Okta-Anwendung für den SSO-Sync
- Navigieren Sie zu Ihrem Okta-Admin-Panel, gehen Sie in der Hauptnavigationsleiste zum Unterabschnitt „Applications“ und wählen Sie darunter erneut „Applications“ aus (Direktlink: https://
.okta.com/admin/apps/active)

- Wählen Sie „Create App integration“
- Es erscheint ein Pop-up, in dem Sie eine „sign-in method“ und einen „Application type“ auswählen können
- Der Anmeldetyp (Sign-in type) sollte „OIDC – OpenID Connect“ sein
- Der Anwendungstyp (Application type) sollte „Web Application“ sein

- Eine neue Seite öffnet sich, auf der weitere Details zur Anwendung abgefragt werden:
- App integration name: Dies kann ein aussagekräftiger Name für diese Integration zwischen Okta und RESPONSUM sein, wie z. B. „RESPONSUM SSO Login“
- Logo: Optional, kann also leer gelassen werden
- Grant type: Die standardmäßig ausgewählten Werte können hier beibehalten werden
- Sign-in redirect URIs: Lassen Sie dies vorerst leer und fügen Sie den Wert ein, den Sie von RESPONSUM als Ergebnis von Schritt 3 erhalten haben.
- Sign-out redirect URIs: Die Abmeldeantwort an Okta kann bereitgestellt werden, indem die oben genannte Sign-in Redirect-URL verwendet und „/logout_response“ am Ende dieser URL angehängt wird.
- Base URIs: Optional, kann also leer gelassen werden
- Controlled access: Abhängig davon, ob Sie die Möglichkeit zur Anmeldung bei RESPONSUM für die gesamte Okta-Organisation oder nur für eine ausgewählte Gruppe bereitstellen möchten. Die hier gewählte Option hängt von Ihrem spezifischen Anwendungsfall ab.
- Schließen Sie den Vorgang ab, indem Sie auf „Save“ klicken
- Notieren Sie sich die Client ID und das Client Secret, um diese später in Schritt 3 zu verwenden
Schritt 3: Finden Sie die Details zum Autorisierungsserver Ihrer Okta-Umgebung (OAuth 2)
- Nachfolgend finden Sie zwei Ansätze, um die Details des Autorisierungsservers zu finden. Je nach Ihrem Okta-Abonnement ist Option 3B möglicherweise nicht verfügbar. Verwenden Sie in diesem Fall Option 3A:
Schritt 3A: Erstellen Sie die URL selbst basierend auf Ihren Umgebungsdetails
- Okta beschreibt in diesem Leitfaden, wie die URLs für OAuth- und OpenID-Autorisierungsserver ermittelt werden. Verwenden Sie in diesem Fall die OAuth-Anweisung.
- Zusammenfassend sollte die URL die folgende Struktur haben:
- https://<IhreOktaOrg>/.well-known/oauth-authorization-server
- Beispiel: https://responsum.okta.com/.well-known/oauth-authorization-server
Schritt 3B: Verwenden Sie das API Access Management Portal (falls Teil Ihres Abonnements und/oder mehrere Autorisierungsserver definiert sind)
- Navigieren Sie im Okta-Admin-Portal über das Seitenmenü zu Security >> API >> Registerkarte „Authorization servers“. Hier finden Sie normalerweise einen „Default“-Autorisierungsserver.

- Klicken Sie in der Übersicht auf den Namen „Default“, um zur Detailseite zu gelangen.
- Kopieren Sie den Wert „Metadata URI“ zur späteren Verwendung in Schritt 3

Schritt 4: Bündeln Sie die Informationen und übermitteln Sie diese an RESPONSUM
Kopieren Sie mit den kombinierten Informationen aus den Schritten 2 und 3 die folgenden Details in 3 separaten E-Mails an support@responsum.eu:
- Client ID
- Client Secret
- Authorization URL
Sobald wir Ihre Integration basierend auf den oben genannten Details eingerichtet haben, werden wir Ihnen die korrekten Redirect-URLs und Logout-URLs mitteilen, die der App in Okta hinzugefügt werden müssen, um sie voll einsatzfähig zu machen.
Wenn Sie zusätzliche Sicherheit für die Übertragung dieser Zugangsdaten wünschen, senden Sie uns vorab eine E-Mail an support@responsum.eu. Wir werden Ihnen dann eine sichere Upload-Zone zur Verfügung stellen, in der Sie die Zugangsdaten hochladen und uns direkt übermitteln können.
Wir werden nun mit der Einrichtung der SSO-Integration für Ihre spezifische Umgebung fortfahren. Wir werden uns in einer Antwort auf eine der E-Mails bei Ihnen melden, sobald die Integration aktiviert und verfügbar ist. Führen Sie nach dieser Mitteilung einen gründlichen Test durch, um zu prüfen, ob alles wie gewünscht funktioniert.
Viel Erfolg bei der Nutzung von Okta für den Login bei RESPONSUM!