VergeOS mit OIDC als Identitätsanbieter einrichten
Anleitung zur Konfiguration von VergeOS als OpenID-Connect-(OIDC)-Identitätsanbieter für die zentrale Authentifizierung über mehrere Systeme und Mandanten hinweg.
Überblick
Diese Anleitung führt Sie durch den Prozess der Konfiguration von VergeOS als Identitätsanbieter mithilfe von OpenID Connect (OIDC) und ermöglicht eine zentrale Authentifizierung für mehrere VergeOS-Systeme und Mandanten.
Voraussetzungen
Administrativer Zugriff auf das VergeOS-System
Gültiges SSL-Zertifikat auf dem VergeOS-System installiert
Grundlegendes Verständnis der OIDC-Konzepte
URLs der Client-Systeme, die diese Authentifizierung verwenden werden
Schritte zum Erstellen einer OIDC-Anwendung
OIDC-Einstellungen aufrufen
Navigieren Sie zu System > OIDC-Anwendungen aus dem oberen Menü
Klicken Sie Neu
Grundlegende Einstellungen konfigurieren
Geben Sie einen beschreibenden Name für die Anwendung
Prüfen Sie die Aktiviert Feld
Fügen Sie ein optionales Beschreibung
Redirect-URIs einrichten
Geben Sie die Callback-URL(s) ein, zu denen Benutzer nach der Authentifizierung weitergeleitet werden
Format:
https://your-system-name.example.comFür unterschiedliche Client-Systeme können mehrere URIs hinzugefügt werden
Verwendung von Platzhaltern
Sie können Platzhalter in Redirect-URIs verwenden:
Für mehrere Systeme:
https://examplecorp-site*.example.comFür mehrere Subdomains:
https://vergesystem.*.example.com
Authentifizierungsoptionen konfigurieren
Autorisierungsquelle erzwingen: Optional einen Drittanbieter-Provider auswählen
Benutzer zuordnen: Wählen Sie aus, ob alle verifizierten Benutzer einem bestimmten Konto zugeordnet werden sollen
Setzen Sie Bereichseinstellungen (Profil, E-Mail, Gruppen)
Bei Bedarf Zugriffsbeschränkungen konfigurieren
Konfiguration speichern
Klicken Sie Absenden um die OIDC-Anwendung zu erstellen
Das System generiert eine Client-ID und ein Secret
Abrufen der Client-Anmeldedaten
Anwendungs-Dashboard aufrufen
Navigieren Sie zu System > OIDC-Anwendungen
Doppelklicken Sie auf Ihre OIDC-Anwendung
Erforderliche Informationen kopieren
Client-ID: Mit dem angezeigten Wert oder dem Kopiersymbol kopieren
Client-Secret: Verwenden Sie das Kopiersymbol (Wert ist ausgeblendet)
Well-Known-Konfigurations-URL: Kopieren Sie die angezeigte URL
Bewährte Verfahren
Erstellen Sie separate OIDC-Anwendungen für unterschiedliche Client-Gruppen
Überprüfen und aktualisieren Sie regelmäßig die Zugriffsbeschränkungen
Verwenden Sie nach Möglichkeit spezifische Redirect-URIs statt Platzhaltern
Dokumentieren Sie, welche Systeme jede OIDC-Anwendung verwenden
Fehlerbehebung
Häufige Probleme
Authentifizierung schlägt fehl
Überprüfen Sie, ob das SSL-Zertifikat gültig und nicht abgelaufen ist
Prüfen Sie, ob die Redirect-URI exakt übereinstimmt
Stellen Sie sicher, dass Client-ID und Secret korrekt kopiert wurden
Bereichszugriff verweigert
Überprüfen Sie, ob die erforderlichen Bereiche aktiviert sind
Prüfen Sie die Benutzerberechtigungen in den Einschränkungseinstellungen
Weiterleitungsprobleme
Bestätigen Sie, dass das URL-Format mit der Redirect-URI übereinstimmt
Überprüfen Sie gegebenenfalls die Platzhaltermuster
Prüfen Sie auf Probleme mit dem SSL-Zertifikat
Zusätzliche Ressourcen
Feedback
Zuletzt aktualisiert
War das hilfreich?