Patrones de autenticación

Los complementos pueden requerir que los usuarios inicien sesión o se registren para acceder a las características. Los controles de autenticación comunes incluyen campos de nombre de usuario y contraseña y botones que inician flujos de credenciales que no son de Microsoft. Una experiencia de autenticación sencilla y eficaz ayuda a los usuarios a empezar a trabajar rápidamente.

Procedimientos recomendados

Correcto	Incorrecto
Antes de iniciar sesión, describa el valor del complemento o muestre la funcionalidad sin necesidad de una cuenta.	Espere que los usuarios inicien sesión sin comprender el valor y las ventajas del complemento.
Guíe a los usuarios a través de flujos de autenticación con un botón principal muy visible en cada pantalla.	Atraiga la atención hacia las tareas secundarias y terciarias con botones contrapuestos y llamadas a la acción.
Use etiquetas de botón claras que describan tareas específicas, como "Iniciar sesión" o "Crear cuenta".	Use etiquetas de botón vagas como "Enviar" o "Empezar".
Use un cuadro de diálogo para centrar la atención de los usuarios en los formularios de autenticación.	Superpobla el panel de tareas con una experiencia de primera ejecución y formularios de autenticación.
Busque pequeñas eficiencias en el flujo, como los cuadros de entrada de enfoque automático.	Agregue pasos innecesarios a la interacción, como exigir a los usuarios que haga clic en los campos de formulario.
Proporcione una manera de que los usuarios cierren sesión y vuelvan a autenticarse.	Obligue a los usuarios a desinstalar para cambiar de identidad.

Flujo de autenticación

Use este flujo para guiar a los usuarios desde la experiencia de primera ejecución hasta un inicio de sesión completado.

1. Placemat de primera ejecución: coloque el botón de inicio de sesión como una llamada a la acción clara en la experiencia de primera ejecución del complemento.

   

2. Cuadro de diálogo Opciones del proveedor de identidades: muestra una lista clara de proveedores de identidades, incluidos un nombre de usuario y un formulario de contraseña si procede. Es posible que la interfaz de usuario del complemento se bloquee mientras el cuadro de diálogo de autenticación está abierto.

   

3. Inicio de sesión del proveedor de identidades: el proveedor de identidades tiene su propia interfaz de usuario. Microsoft Entra ID admite la personalización de las páginas de inicio de sesión y del panel de acceso para mantener la apariencia coherente con el servicio. Para obtener más información, consulte Configuración de la personalización de marca de la empresa.

   

4. Progreso: indique el progreso mientras se cargan la configuración y la interfaz de usuario.

   

Nota:

Al usar Microsoft Entra ID, puede usar un botón de inicio de sesión de marca personalizable para temas claros y oscuros. Para obtener más información, consulte Plataforma de identidad de Microsoft y flujo del código de autorización de OAuth 2.0.

Flujo de autenticación de inicio de sesión único

Nota:

La API de inicio de sesión único se admite actualmente para Word, Excel, Outlook y PowerPoint. Para obtener más información sobre la compatibilidad con el inicio de sesión único, consulte Conjuntos de requisitos de IdentityAPI. Si está trabajando con un complemento de Outlook, asegúrese de habilitar la autenticación moderna para el inquilino de Microsoft 365. Para obtener información sobre cómo hacerlo, vea Habilitar o deshabilitar la autenticación moderna para Outlook en Exchange Online.

Use el inicio de sesión único para una experiencia de usuario final más fluida. La identidad del usuario en Office (una cuenta Microsoft o una identidad de Microsoft 365) se usa para iniciar sesión en el complemento. Como resultado, los usuarios solo inician sesión una vez. Esto simplifica la experiencia y facilita el uso del servicio por parte de los clientes.

1. Cuando se instala un complemento, el usuario ve una ventana de consentimiento similar a la siguiente:

   

   Nota:

   El publicador del complemento controla el logotipo, las cadenas y los ámbitos de permisos incluidos en la ventana de consentimiento. Microsoft preconfigura la interfaz de usuario de la ventana de consentimiento.

2. Una vez que el usuario da su consentimiento, el complemento carga y puede extraer y mostrar información específica del usuario.

   

Vea también

• Desarrollo de un complemento de Office con SSO