Skip to content

Single Sign-On mit SAML 2.0

Cognigy.AI lässt sich in gängige SSO-Identitätsanbieter (Single Sign-On) wie Azure Active Directory, OneLogin und Okta integrieren. Diese Integration ermöglicht es Benutzern innerhalb Ihrer Organisation, sich ohne separate Anmeldeinformationen bei Cognigy.AI anzumelden. Durch die Verwendung von Single Sign-On wird automatisch Zugriff gewährt, der einen optimierten Authentifizierungsprozess gewährleistet. Darüber hinaus können Sie das robuste Zugriffskontrolltool verwenden, Cognigy.AI die Zugriffsrechte einzelner Benutzer effektiv zu verwalten und zu kontrollieren.

Abrufen der SSO-URL
Um Single Sign-On in Ihrem Identitätsanbieter zu konfigurieren, benötigen Sie die URL, die während des SAML-Authentifizierungsprozesses verwendet wird. Die SAML-Anforderungen werden an den API-Dienst gesendet, daher sollten Sie die API-Domäne verwenden, die Sie für Ihre Installation konfiguriert haben. Die SSO-URL hat das folgende Format:

'''txt https:///auth/saml/login/'''

Die API-URL für die App-Umgebung lautet beispielsweise "api-app.cognigy.ai". Die "Organisations-ID" ist die "ID" Ihrer Organisation innerhalb Cognigy.AI. Sie können Ihre 'organizationId' auf der Mein Profil durch Klicken auf ! [vertikale-Auslassungspunkte] (.. /.. /assets/icons/vertical-ellipsis.svg) > Organisations-ID kopieren.

Sie benötigen die SSO-URL, wenn Sie Ihren Identitätsanbieter (IDP) mit einem der bereitgestellten Einrichtungsleitfäden konfigurieren.

Informationen zum Konfigurieren des SSO-Anbieters mit Cognigy.AI finden Sie in einem der spezifischen Handbücher für die unterstützten Identitätsanbieter. Diese Leitfäden enthalten Beispiele für die erforderlichen API-Anfragen. Wenn Ihr Identitätsanbieter nicht aufgeführt ist, empfehlen wir, dem OneLogin-Handbuch als Beispiel zu folgen. Die API-Anforderung für die Konfiguration von SSO mit Cognigy.AI ist dieselbe, aber die Konfigurationswerte können je nach Anbieter variieren.

Abrufen der SLO-URL
!!! Warnung

- Single Logout wird nur mit OneLogin und Microsoft Azure Active Directory unterstützt:
    - Die vom Dienstanbieter initiierte einmalige Abmeldung wird nur mit Microsoft Azure Active Directory unterstützt.
    - Vom Identitätsanbieter initiiertes Single Logout wird nur mit OneLogin unterstützt.

Um Single Logout für Ihren Identitätsanbieter zu konfigurieren, benötigen Sie die URL, die für die Verarbeitung der Abmeldeanforderung vom IDP verwendet wird. Während des Single-Logout-Prozesses leitet der IDP an das Frontend von Cognigy.AI weiter. Daher sollten Sie die Frontend-Domäne verwenden, die Sie für Ihre Installation konfiguriert haben. Die SLO-URL hat das folgende Format:

'''txt https:///Slo/'''

Zum Beispiel könnte die Frontend-URL "app.cognigy.ai" lauten.

Weitere Informationen zum Herstellen einer Verbindung mit Ihrem angebotenen SSO-Anbieter finden Sie im Cognigy Help Center.

Ändern einer Single-Sign-On-Konfiguration in Cognigy.AI
Sie können nur eine SSO-Konfiguration für Ihre Organisation haben. Wenn Sie die Konfiguration ändern möchten, müssen Sie sie zunächst löschen und eine neue erstellen. Um eine SSO-Konfiguration zu löschen, senden Sie eine "POST"-Anfrage an:

'''txt https:///v2.0/identityprovider/reset '''

Weitere Informationen zur Verwendung der Cognigy.AI API finden Sie auf der API-Referenzseite.

Melden Sie sich über SSO an
Wenn sich ein Benutzer zum ersten Mal über SSO bei Cognigy.AI anmeldet, muss er dies über den Identitätsanbieter tun. Auf diese Weise erhalten sie die richtigen Zugriffsrechte in Cognigy.AI und können sich bei nachfolgenden Anmeldungen über die Cognigy.AI Anmeldeseite anmelden.

Erstmalige Anmeldung

Bei der ersten Anmeldung müssen sich Benutzer mit ihren Anmeldeinformationen für den Identitätsanbieter (IDP) anmelden.

Um sich auf der Anmeldeseite bei Cognigy.AI anzumelden, klicken Sie auf Mit SSO anmelden und geben Sie Ihre E-Mail-Adresse ein. Dadurch werden Sie zu Ihrem konfigurierten IDP weitergeleitet, wenn ein IDP für Ihre Organisation konfiguriert ist.

Mehr Informationen