Press CTRL+K to open search

Lokalisierung läuft: Einige Teile des Inhalts werden möglicherweise noch auf Englisch angezeigt, während wir die Übersetzung abschließen.

OpenID Single Sign On

  • Veröffentlicht am Aug 27, 2026
  • 4 Gelesene Minute(n)
  • LH
 Prev Next

OpenID Single Sign-on (SSO) Provider-Konfiguration

Quinyx unterstützt Single Sign-On (SSO) über die OpenID Connect-Spezifikation (Version 1.0). Dies ermöglicht es den Nutzern, sich mit ihren bestehenden Zugangsdaten des Identity Provider (IdP) Ihrer Organisation bei Quinyx anzumelden.

Dieser Leitfaden behandelt die Konfiguration sowohl für Web- als auch für mobile App-SSO.

Voraussetzungen

Bevor Sie mit der Konfiguration beginnen, stellen Sie sicher, dass Sie:

  • Zugangsrechte: Sie müssen die Rolle des Account Manager in Quinyx haben, um auf die Authentifizierungseinstellungen zugreifen zu können.

  • Identitätsanbieter (IdP): Ein Identity Provider eingerichtet, der das OpenID Connect Framework unterstützt (z. B. Azure AD, Okta, Google Workspace).

  • Kundenzugangsdaten: Die Client ID und Client Secret generiert von Ihrem Identitätsanbieter.

1. Einen neuen Anbieter hinzufügen

Um eine neue Konfiguration zu erstellen oder eine bestehende zu bearbeiten:

  1. Navigieren Sie zu Kontoeinstellungen > Authentifizierungseinstellungen > OpenID-Anbietern.

  2. Klicken Sie auf Hinzufügen , um eine neue Konfiguration zu erstellen.

2. Allgemeine Informationen

Konfigurieren Sie die Details der Kernverbindung. Diese Werte stimmen mit den Einstellungen in Ihrem Identitätsanbieter überein.

  • Name: Der Anzeigename für diese Anmeldemethode (z. B. "Okta Login"). Dieser Name ist für Administratoren sichtbar und, falls Global Login Alias verwendet wird, für Endnutzer.

  • Attributname: Der spezifische Anspruch im OpenID-Token, der als eindeutige Kennung des Benutzers fungiert (z. B. email, sub, oder upn). Das ist hoch- und kleinschreibungssensitiv und muss genau zu deinem IdP passen.

  • Teleskope: Die Erlaubnisse, die Quinyx anfordert.

    • Erforderlich: openid

    • Häufige Ergänzungen: profile, email (getrennte Mehrfachbereiche mit Leerzeichen).

  • Identifikationstyp: Wählen Sie aus, welches Feld im Quinyx-Benutzerprofil mit dem Attributnamen des Anbieters übereinstimmt.

    • Beispiel: Wenn Sie E-Mail auswählen, ordnet Quinyx den email Anspruch des IdP mit der E-Mail-Adresse des Nutzers in Quinyx ab.

  • Kunden-ID: Die öffentliche Kennung der Quinyx-Anwendung, die von deinem IdP bereitgestellt wird.

  • Kundengeheimnis: Der private Schlüssel/Passwort, den dein IdP bereitstellt.

  • Ausloggen URI: Die URL, auf die Nutzer nach dem Ausloggen von Quinyx umgeleitet werden. Das weist normalerweise auf den Logout-Endpunkt deines IdP hin.

3. Konfigurationsoptionen

Diese Kontrollkästchen steuern spezifische Authentifizierungsverhalten.

  • Globaler Login-Alias:

    • Aktiviert: Ermöglicht es Nutzern, den Namen dieses Anbieters (z. B. "MyCompanyLogin") im Benutzernamensfeld der Quinyx Mobile App einzugeben. Sie werden automatisch auf Ihre SSO-Login-Seite weitergeleitet, ohne dass eine bestimmte Region ausgewählt werden muss.

    • Hinweis: Der Name muss weltweit einzigartig in Quinyx (EU und USA) sein. Validiert beim Speichern.

  • PKCE verwenden:

    • Aktiviert: Aktiviert den Proof Key for Code Exchange (PKCE) für erhöhte Sicherheit. Stelle sicher, dass dein IdP dies unterstützt, bevor du es aktivierst.

  • Ausloggen vom IDP:

    • Aktiviert: Wenn ein Nutzer sich bei Quinyx abmeldet, ist er auch aus seiner Identity Provider-Sitzung ausgeloggt.

  • Debug-Modus aktivieren:

    • Aktiviert: Zeigt detaillierte Fehlerprotokolle auf der Anmeldeseite an. Empfehlung: Nur während der Ersteinrichtung/Fehlerbehebung aktivieren und für die Produktion deaktivieren.

Klicken Sie auf Weiterführen , um zu den erweiterten Einstellungen zu gelangen.

4. Erweiterte Preset-Werte

Dieser Abschnitt definiert die technischen Endpunkte. Du kannst das automatisch oder manuell ausfüllen.

Methode A: Fetch-Preset (empfohlen)

Die meisten Identitätsanbieter bieten eine Metadaten-URL (Discovery URL) an.

  1. Füge die Metadaten-URL deines IdP in das Feld der Preset-URL ein.

    • Beispiel: https://login.microsoftonline.com/{tenant}/v2.0/.well-known/openid-configuration

  2. Klicken Sie auf das Preset "Fetch".

  3. Quinyx füllt automatisch die untenstehenden Felder aus.

Methode B: Manuelle Konfiguration

Wenn du den Preset-Fetcher nicht verwenden kannst, gib die Werte manuell basierend auf deiner IdP-Dokumentation ein:

  • AutorisierungURI: Die URL der Anmeldeseite.

  • RedirectURI: Die Quinyx-URL, die der IdP nach dem Login an den Nutzer sendet.

    • Wichtig: Kopieren Sie diese URL nach dem Speichern und fügen Sie sie zu den "Erlaubten Callback-URLs" Ihres IdP. hinzu.

  • Client-Authentifizierungsmethode: Wie die Client-Zugangsdaten gesendet werden (z. B. keine oder  client_secret_basic oder client_secret_post.

  • Endpunkt der Sitzung: Die URL, die zur Beendigung der IdP-Sitzung verwendet wird.

  • Fördertyp: Kann auf Refresh tokenoder Client credentialsgesetzt werden, aber normalerweise auf Authorization Code

  • IssuerURI: Die eindeutige Kennung des Identitätsanbieters.

  • JWK setzt URI: Die URL enthält öffentliche Schlüssel zur Signaturverifikation.

  • Token-URI: Der Endpunkt zum Austausch des Autorisierungscodes gegen einen Zugriffstoken.

  • Benutzerinformations-Endpunkt: Die URL, um Benutzerprofildetails abzurufen.

5. Fertigstellung der Einrichtung (Redirect-URI)

  1. Speichere deine Konfiguration in Quinyx.

  2. Öffnen Sie die Konfiguration erneut (klicken Sie auf das Vorhängeschloss-Symbol , wenn der erweiterte Bereich geschlossen ist).

  3. Finden Sie das Feld RedirectURI im Abschnitt Erweiterte Preset-Werte.

  4. Kopiere diese URL.

  5. Melden Sie sich im Admin-Portal Ihres Identitätsanbieters an und fügen Sie diese URL in die Einstellungen für erlaubte Redirect-URIs (manchmal auch Reply URLs oder Callback-URLs genannt) der Quinyx-Anwendung ein.

Appendix: Example setup (Azure AD)

Hinweis: Dies ist eine allgemeine Anleitung für Azure Active Directory. Schnittstellen können sich ändern.

1. Initiale Einrichtung in Azure AD

  1. Gehe zu Azure Active Directory > App-Registrierungen > Neue Registrierung.

  2. Nenne die App (z. B. "Quinyx").

  3. Für die Redirect-URI wählen Sie Web aus und geben Sie einen temporären Platzhalter ein (z. B. https://localhost). Du wirst das später aktualisieren.

  4. Klicken Sie auf Registrieren.

2. Sammeln von Qualifikationen

  1. Kunden-ID: Auf der Übersichtsseite kopieren Sie die Anwendungs-(Client-)ID.

  2. Mieter-ID: Kopiere die Verzeichnis-(Tenant-)ID.

  3. Kundengeheimnis: Gehe zu Zertifikate & Geheimnisse > Geheimnis des neuen Kunden. Erstellen Sie eines und kopieren Sie den Wert sofort (Sie können es später nicht mehr ansehen).

3. Quinyx konfigurieren

  1. Erstelle in Quinyx einen neuen OpenID-Provider.

  2. Füge die Client-ID und das Client Secret aus Azure ein.

  3. In der Preset-URL geben Sie Folgendes ein (ersetzen Sie {your-tenant-id} durch die in Schritt 2.2 kopierte ID):
    https://login.microsoftonline.com/{your-tenant-id}/v2.0/.well-known/openid-configuration

  4. Klicken Sie auf das Preset "Fetch".

  5. Stellen Sie die Teleskope ein: openid profile.

  6. Klicken Sie auf Weitermachen oder Speichern.

  7. Wichtig: In den erweiterten Einstellungen kopieren Sie die von Quinyx generierte RedirectURI .

4. Finalisierung in Azure AD

  1. Zurück zu Ihrer App-Registrierung in Azure > Authentifizierung.

  2. Füge die RedirectURI hinzu, die du von Quinyx kopiert hast.

  3. Lösche die temporäre Platzhalter-URL, die du in Schritt 1 erstellt hast.

  4. Stelle sicher, dass das Kästchen für ID-Tokens angekreuzt ist (falls es dein spezifischer Flow verlangt, obwohl Standard-OIDC den Token Endpoint verwendet).

  5. Speichere die Änderungen.

Verwandte Artikel