Editar OAuth 2

Después de configurar un servicio OAuth 2,puede editarlo para realizar cambios según sea necesario.

Editando la configuración

Vaya al menú de acceso rápido > Servidor > Servicios OAuth 2.
Haga clic en el ícono de engranaje () en la columna Editar.
Haz tus cambios en la configuración.
Haga clic en Guardar cambios.

Configurar puntos de conexión

Vaya al menú de acceso rápido > Servidor > Servicios OAuth 2.
Haga clic en el ícono de lista () en la columna Editar.
Haga clic en el ícono de engranaje () para editar el nombre o la URL del punto final.
Haga clic en Guardar cambios.

También puedes eliminar una terminal haciendo clic en el ícono de cruz (), o añadir una nueva terminal haciendo clic en Crear nueva terminal para el emisor "[issuer name]".

Los puntos finales del emisor son las URL a las que Totara se conecta. Hay tres puntos finales requeridos para la autenticación de usuarios:

autorización_endpoint
token_endpoint
usuarioinfo_endpoint

Para los servicios de Google, Microsoft, Facebook y Nextcloud, no será necesario configurar estos puntos finales, ya que serán URL para el proveedor OAuth. Por ejemplo, un punto final para Google sería https://accounts.google.com/o/oauth2/v2/auth. Para los servicios personalizados, necesitarás añadir los puntos finales.

Configurar asignaciones de campos de usuario

Puedes editar, eliminar o crear mapeos entre los campos de datos de usuario en el sitio del problema y tu sitio de Totara para asegurarte de que se transmita la información correcta.

Para configurar asignaciones de campos de usuario, siga estos pasos:

Vaya al menú de acceso rápido > Servidor > Servicios OAuth 2.
Haga clic en el icono de persona () en la columna Editar.
Haga clic en el ícono de engranaje () para editar loscampos External field namey Internal field name.
Haga clic en Guardar cambios.

También puedes eliminar un campo de usuario con el ícono de cruz () o añadir una nueva asignación de campo de usuario haciendo clic en Crear nueva asignación de campo de usuario para el emisor "[issuer name]".

Al configurar asignaciones de campos, el nombre del campo Externo utiliza el carácter guion (-) como separador para los campos de objetos anidados. Por ejemplo, el nombre país-región buscará elcampo de región de unobjeto de país en los datos de respuesta de una solicitud de información de usuario OAuth 2.

Si tus datos de información de usuario contienen guiones en los nombres de los campos, entonces tendrás que escaparlos usando un carácter de barra invertida (\) en el campo de nombre de campo externo en Totara. Por ejemplo, si configuras el nombre del campo Externo en país-región, Totara intentará encontrar el campo país-región en los datos de respuesta de información del usuario. Por lo tanto, debes establecer el nombre del campo Externo en país\-región para asegurarte de que el nombre del campo se interprete correctamente.

Al configurar OAuth 2 con Microsoft Azure AD, solo ciertos campos estarán disponibles para asignar por defecto.
Si deseas que Microsoft proporcione campos adicionales, tendrás que configurar Totara para solicitarlos editando la URL userinfo_endpoint de la conexión a la API de Microsoft. Por ejemplo, si deseaba asignar el campo de departamento además de los campos por defecto, cambiaría la URL de:

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

Ten en cuenta que si estás añadiendo campos de esta manera, también necesitas enumerar todos los campos predeterminados en la URL.

Puedes usar la herramienta Graph Explorer de Microsoft para confirmar qué datos están disponibles (es decir, los nombres exactos de los campos) y modificar la URL según corresponda.

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