SAML Single Sign On

Quinyx unterstützt die SAML 2.0-Spezifikation für Single Sign-On. Dies ermöglicht es den Nutzern, sich mit ihren bestehenden Zugangsdaten des Identity Provider (IdP) Ihrer Organisation bei Quinyx anzumelden.

Hinweis: Ältere SAML-Konfigurationen, die in früheren Versionen von Quinyx erstellt wurden, werden nicht automatisch auf dieses neue Format aktualisiert und sind möglicherweise nicht in dieser Anbieterliste sichtbar. SAML Single Sign-On (SSO) Provider-Konfiguration

SAML Single Sign-on (SSO) Provider-Konfiguration

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie Folgendes haben:

• Zugangsrechte: Du musst die Rolle des Account Manager haben, um auf die Authentifizierungseinstellungen zugreifen zu können.

• Identitätsanbieter (IdP): Ein konfiguriertes IdP (z. B. Azure AD/Entra-ID, ADFS), das SAML 2.0 unterstützt.

1. Einen neuen Anbieter hinzufügen

Um eine neue Konfiguration zu erstellen:

1. Navigieren Sie zu Kontoeinstellungen > Authentifizierungseinstellungen > SAML-Anbieter.

2. Klicken Sie auf Hinzufügen , um das Erstellungsformular zu öffnen.

2. Erstellen Sie ein SAML-Formular

Konfigurieren Sie die grundlegenden Verbindungsdetails.

• Name: Der Anzeigename dieses Anbieters in Quinyx (z. B. "Corporate login"). Dies ist für Administratoren sichtbar und, wenn ein globales Login-Alias verwendet wird, für Endnutzer.

• Attributname: Das spezifische Attribut in der SAML-Behauptung, das als Benutzername fungiert.

  • Hinweis: Im Gegensatz zu OpenID benötigt SAML hier oft die vollständige Claim-URI.

  • Azure AD Beispiel: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

• Identifikationstyp: Wählen Sie aus, welches Feld im Quinyx-Benutzerprofil mit dem Attributnamen des Anbieters übereinstimmt (z. B. E-Mail).

3. Konfigurationsoptionen

Kontrolliere das Verhalten des Anmelde-/Aus-Flusses.

• Globaler Login-Alias:

  • Aktiviert: Ermöglicht es Nutzern, den Namen dieses Anbieters im Anmeldebildschirm der mobilen App einzugeben, um automatisch an Ihren SSO weitergeleitet zu werden.

  • Voraussetzung: Der Name muss weltweit einzigartig in allen Quinyx-Regionen (EU und USA) sein. Einzigartigkeit wird beim Speichern bestätigt.

• Ausloggen vom IDP:

  • Aktiviert: Wenn ein Nutzer sich bei Quinyx abmeldet, wird er auch aus seiner Sitzung im Identitätsanbieter ausgeloggt.

  • Hinweis: Stellen Sie sicher, dass Ihr Identitätsanbieter Single Logout (SLO) unterstützt.

• Debug-Modus aktivieren:

  • Aktiviert: Zeigt detaillierte Fehlerinformationen auf der Anmeldeseite an, falls die Authentifizierung fehlschlägt. Empfohlen nur für die anfängliche Einrichtung und Fehlersuche.

4. IDP-Metadaten importieren

Sie müssen Quinyx die Metadaten Ihres Identitätsanbieters bereitstellen. Wählen Sie eine der beiden Methoden unter "Wie Sie URL abrufen" auswählen:

• URL (Empfohlen): Wählen Sie die URL aus und fügen Sie die von Ihrem IdP bereitgestellte öffentliche Metadaten-URL in das Feld Metadaten-URL ein. Quinyx hält die Konfiguration mit dieser URL synchron.

• XML: Wählen Sie XML aus, um den vollständigen Roh-XML-Metadatencode direkt ins Feld einzufügen.

Klicken Sie auf Speichern , um den Anbieter zu erstellen.

5. Fertigstellung der Einrichtung (erstellte URL)

Sobald Sie die Konfiguration gespeichert haben, generiert Quinyx eine Metadaten-URL, die Sie Ihrem Identitätsanbieter zurückgeben müssen, um die "Vertrauens"-Beziehung abzuschließen.

1. Nachdem Sie auf Speichern geklickt haben, sehen Sie sich das linke Menü der SAML-Anbieterseite an.

2. Klicken Sie auf URL erstellt.

3. Kopieren Sie die bereitgestellte URL (diese dient als Entitäts-ID und als Assertion Consumer Service/Antwort-URL).

4. Füge diese URL in die Konfigurationseinstellungen deines Identitätsanbieters ein.

6. Verwendung globaler Login-Alias

Wenn Sie den Alias Global Login aktiviert haben, können sich Nutzer über die mobile App mit einem vereinfachten Ablauf anmelden:

1. Öffnen Sie die Quinyx-Mobile-App.

2. Im Feld Benutzername geben Sie den genauen Namen des Anbieters ein (z. B. "MyCompanyLogin").

3. Tippen Sie auf Weitermachen.

4. Der Nutzer wird sofort auf die Login-Seite Ihres Identitätsanbieters weitergeleitet.

Fehlerbehebung: Wenn der Benutzer nach einem Passwort gefragt wird, anstatt weitergeleitet zu werden, kann es sein, dass er den Alias falsch eingegeben hat oder das Kästchen Global Login Alias in Schritt 3 nicht aktiviert wurde.

Tipps zur Fehlerbehebung

• Groß- und Kleinschreibsensitivität: Der Name des Anbieters ist nicht hochschreibungssensitiv.

• Fehlerbehandlung: Wenn der Benutzer nach einem Passwort gefragt wird, anstatt weitergeleitet zu werden, hat er möglicherweise den Alias falsch eingegeben oder das Kästchen Global Login Alias wurde in Schritt 3 nicht aktiviert.