OAuth 2 bearbeiten

Nachdem ein OAuth 2-Dienst eingerichtet wurde, können Sie ihn bearbeiten, um nach Bedarf Änderungen vorzunehmen.

Bearbeiten der Einstellungen

Gehen Sie zu Schnellzugriff > Server > OAuth 2- Dienste.
Klicken Sie auf das Zahnradsymbol () in der Spalte Bearbeiten.
Nehmen Sie Ihre Änderungen an den Einstellungen vor.
Klicken Sie auf Änderungen speichern.

Endpoints konfigurieren

Gehen Sie zu Schnellzugriff > Server > OAuth 2- Dienste.
Klicken Sie auf das Listensymbol () in der Spalte Bearbeiten.
Klicken Sie auf das Zahnradsymbol (), um den Namen oder die URL des Endpunkts zu bearbeiten.
Klicken Sie auf Änderungen speichern.

Sie können einen Endpunkt auch löschen, indem Sie auf das Kreuzsymbol () klicken, oder einen neuen Endpunkt hinzufügen, indem Sie auf Neuen Endpunkt für Aussteller erstellen "[issuer name]" klicken.

Die Endpunkte des Emittenten sind die URLs, zu denen Totara eine Verbindung herstellt. Für die Nutzerauthentifizierung sind drei Endpunkte erforderlich:

Autorisierung_Endpunkt
token_endpunkt
userinfo_endpoint

Für Google-, Microsoft-, Facebook- und Nextcloud-Dienste müssen Sie diese Endpunkte nicht konfigurieren, da es sich um URLs für den OAuth-Anbieter handelt. Ein Endpunkt für Google wäre beispielsweise https://accounts.google.com/o/oauth2/v2/auth. Für benutzerdefinierte Dienste müssen Sie die Endpunkte hinzufügen.

Nutzerfeldzuordnung konfigurieren

Sie können Zuordnungen zwischen den Nutzerdatenfeldern auf der Problemseite und Ihrer Totara-Seite bearbeiten, löschen oder erstellen, um sicherzustellen, dass die richtigen Informationen vermittelt werden.

So konfigurieren Sie Nutzerfeldzuordnungen:

Gehen Sie zu Schnellzugriff > Server > OAuth 2- Dienste.
Klicken Sie auf das Personensymbol () in der Spalte Bearbeiten.
Klicken Sie auf das Zahnradsymbol (), um die Felder Externer Feldname und Interner Feldname zu bearbeiten.
Klicken Sie auf Änderungen speichern.

Sie können auch ein Nutzerfeld mit dem Kreuzsymbol () löschen oder eine neue Nutzerfeldzuordnung hinzufügen, indem Sie auf Neue Nutzerfeldzuordnung für Aussteller erstellen "[issuer name]" klicken.

Beim Konfigurieren von Feldzuordnungen verwendet der externe Feldname das Bindestrichzeichen (-) als Trennzeichen für verschachtelte Objektfelder. Zum Beispiel sucht der Name country-region das Feld region eines Länderobjekts in den Antwortdaten einer OAuth 2 userinfo -Anfrage.

Wenn Ihre userinfo- Daten Bindestriche in den Feldnamen enthalten, müssen Sie sie mit einem Backslash-Zeichen (\) im Feld Externer Feldname in Totara entkommen lassen. Wenn Sie beispielsweise den externen Feldnamen auf die Länderregion setzen, versucht Totara, das Feld Land-Region in den Antwortdaten der Benutzerinfo zu finden. Daher sollten Sie den externen Feldnamen auf country\-region setzen, um sicherzustellen, dass der Feldname korrekt interpretiert wird.

Bei der Konfiguration von OAuth 2 mit Microsoft Azure AD sind standardmäßig nur bestimmte Felder zur Zuordnung verfügbar.
Wenn Sie möchten, dass Microsoft zusätzliche Felder bereitstellt, müssen Sie Totara so konfigurieren, dass sie angefordert werden, indem Sie die URL userinfo_endpoint der Microsoft API-Verbindung bearbeiten. Wenn Sie beispielsweise das Abteilungsfeld zusätzlich zu den Standardfeldern zuordnen möchten, ändern Sie die URL von:

https://graph.microsoft.com/v1.0/me
bis
https://graph.microsoft.com/v1.0/me?$select=businessPhones,displayName,givenName,id,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName,department

Wenn Sie Felder auf diese Weise hinzufügen, müssen Sie auch alle Standardfelder in der URL auflisten.

Sie können den Graph Explorer von Microsoft verwenden, um zu bestätigen, welche Daten verfügbar sind (d. h. die genauen Feldnamen) und die URL entsprechend zu ändern.

Join the Totara Community for more resources to help you get the most out of Totara.