Presentación
Aunque la aplicación móvil Go.Learn admite muchos protocolos de inicio de sesión único (SSO) distintos, concretamente SAML, OKTA, Google Apps, Gmail, Auth0 y OpenID Connect, es posible que no admita otros protocolos SSO o algunos esquemas SSO personalizados, o que estos no funcionen como se espera en Go.Learn.
Por este motivo, Docebo ha introducido la compatibilidad avanzada con enlaces profundos y tokens JWT, así como varias opciones de personalización en la página de inicio de sesión, con el fin de permitir que todos los clientes implementen y protejan la fase de inicio de sesión de la manera que prefieran.
A tener en cuenta: Los usuarios que se autentican mediante un procedimiento de inicio de sesión personalizado configurado de este modo siguen un flujo equivalente al SSO. La opción Recordarme no se aplica, por lo que los usuarios deben repetir este procedimiento de inicio de sesión cada vez que expira la sesión de su plataforma, y el hecho de que lo completen determina si las notificaciones push siguen llegando sin interrupciones. Para obtener más información, consulte el capítulo Centro de notificaciones móviles de Descripción general de la aplicación móvil Go.Learn.
Personalización del inicio de sesión en Go.Learn
Para poder personalizar el inicio de sesión en su aplicación móvil Go.Learn, siga estos cuatro pasos:
- Cree una nueva aplicación OAuth2 en su plataforma Docebo y habilite la compatibilidad con los tokens JWT.
- Implemente la autenticación real del usuario en un portal web que controle o en cualquier aplicación utilizada y desarrollada por su organización.
- Una vez que la autenticación del usuario se haya completado correctamente, redirija al usuario a la aplicación Go.Learn (o a su versión de Go.Learn con su marca) mediante un enlace profundo y pasando un token JWT adecuado como parámetro.
- Optimice la experiencia en la aplicación para evitar confusiones entre los usuarios.
1. Cree una nueva aplicación OAuth2
En primer lugar, necesitará un par de claves RSA privadas/públicas en formato .pem. Puede crearlas de la manera que prefiera, por ejemplo, mediante OpenSSL o el servicio de generación de claves de Travis Tidwell (se abre en una nueva pestaña).
A continuación, acceda al menú de navegación de su plataforma Docebo. En Complementos e integraciones (icono de puzzle), seleccione el elemento API a través de OAuth . En la página que se abrirá, acceda a la pestaña Credenciales API y pulse el botón Añadir aplicación OAuth2. Aparecerá un cuadro emergente. Deberá rellenar sus campos de acuerdo con las instrucciones proporcionadas en el artículo sobre la aplicación API y SSO acerca de la aplicación de API y en el artículo sobre la autenticación de API.
A tener en cuenta: Recuerde marcar la opción Portador JWT en la configuración avanzada, en la parte inferior del cuadro emergente. Por último, deberá cargar la clave pública que creó al principio de este procedimiento. Cuando termine, pulse Confirmar.
2. Implemente el procedimiento de inicio de sesión
Puede implementar el inicio de sesión en un portal web que administre o en cualquier aplicación utilizada por su organización.
| Ejemplo de página de inicio de sesión web | Ejemplo de página de inicio de sesión en una aplicación |
En la página de inicio de sesión, el usuario escribirá su nombre de usuario y contraseña. Cuando pulse el botón Iniciar sesión, podrá verificar sus credenciales mediante los procedimientos estándar que haya implementado.
3. Redirija a la aplicación mediante un token JWT
Al final de la fase de autenticación, en lugar de dirigir al usuario a cualquier página de destino, ahora deberá crear un portador JWT que contenga el nombre de usuario y otra información necesaria.
Recuerde firmar el token JWT mediante la clave privada RSA que creó al principio del paso 1 Crear una nueva aplicación OAuth2 de este documento. Para obtener más información sobre cómo crear un token JWT adecuado para utilizarlo en la plataforma Docebo, consulte el artículo sobre la autenticación de API.
Por último, llame al enlace profundo de Go.Learn para iniciar la aplicación (puede ser la aplicación Go.Learn o su propia aplicación con su marca) pasando como parámetro el portador JWT que acaba de crear. Consulte el artículo sobre los enlaces profundos para la aplicación móvil para obtener más información sobre los enlaces profundos compatibles con Go.Learn.
La estructura de un enlace profundo de Go.Learn es la siguiente: golearn://sso_login_exchange_token={userJWT}
4. Optimice la experiencia en la aplicación
Dado que ahora ha implementado el procedimiento de inicio de sesión fuera de la aplicación, podría resultar confuso para un usuario ver las opciones de inicio de sesión dentro de la aplicación. Por este motivo, se recomienda ocultar estas opciones dentro de la aplicación y proporcionar las instrucciones correctas para que el usuario pueda iniciar sesión de la manera adecuada.
Por ejemplo, puede configurar la página de inicio de sesión de la aplicación para que tenga el siguiente aspecto:
En esta página de inicio de sesión, el usuario no verá ningún cuadro de nombre de usuario/contraseña ni ningún enlace a los inicios de sesión mediante SSO, sino únicamente un botón (Ir a la página de inicio de sesión) que lo redirige a la página de inicio de sesión real.
Para configurar la página de inicio de sesión de esta manera, acceda al menú de navegación de su plataforma Docebo. En Personalización (icono de formas), seleccione el elemento Marca y diseño . En la página que se abrirá, acceda a la pestaña Aplicación móvil y, a continuación, vaya a la sección Página de inicio de sesión.
En la subsección Fondo de la página de inicio de sesión de la sección Página de inicio de sesión, puede personalizar la imagen de fondo de esta página. Tenga en cuenta que, para proporcionar a sus usuarios información más detallada, también puede insertar el texto que desee en la imagen de fondo.
En la subsección Opciones de la sección Página de inicio de sesión, puede configurar los siguientes ajustes:
Aquí puede elegir ocultar todos los botones de inicio de sesión mediante SSO habilitando el inicio de sesión en la aplicación móvil únicamente mediante un servicio de inicio de sesión externo. También puede decidir si desea mostrar u ocultar un botón para redirigir al usuario a la página de inicio de sesión adecuada marcando o desmarcando la opción correspondiente (Mostrar un botón de redireccionamiento), que aparece al seleccionar la opción Habilitar el inicio de sesión en la aplicación móvil solo a través de un servicio de inicio de sesión externo anterior. Al seleccionar la opción del botón de redireccionamiento, deberá añadir la URL (o un enlace profundo) para redirigir al usuario a la página de inicio de sesión correcta en el campo URL del servicio de inicio de sesión externo que aparece debajo.
Por último, recuerde cambiar a la pestaña Escritorio en la página Configurar marca y apariencia, abrir la sección Página de inicio de sesión y activar el interruptor Mostrar solo los botones de SSO y ocultar el formulario de inicio de sesión en la subsección Formulario de inicio de sesión.