Saltar a contenido

Cómo configurar los métodos de inicio de sesión en Encvoy ID#

En esta guía, aprenderá a configurar los métodos de inicio de sesión en Encvoy ID, incluidos los proveedores OAuth estándar y los métodos de autenticación mejorados (WebAuthn, mTLS, TOTP). También cubriremos cómo configurar y diseñar correctamente el widget de autorización para que el proceso de inicio de sesión sea seguro y fácil de usar.

Tabla de contenidos:

Descripción general de los métodos de inicio de sesión#

Un método de inicio de sesión es un método de autenticación que permite a los usuarios autorizarse en su cuenta personal o en aplicaciones conectadas. Es un elemento clave del sistema de Inicio de Sesión Único (SSO), que proporciona una identificación flexible y segura.

Tipos de proveedores de autenticación en Encvoy ID#

Encvoy ID admite los siguientes tipos de métodos de inicio de sesión:

  • Métodos básicos: nombre de usuario y contraseña, correo electrónico,
  • Proveedores de identidad externos: redes sociales y otros servicios,
  • Métodos mejorados y sin contraseña: autenticación criptográfica mediante mTLS (certificados de cliente) y WebAuthn (biometría, llaves de hardware), así como contraseñas de un solo uso TOTP/HOTP.

Niveles de gestión y publicidad de los métodos de inicio de sesión#

Los métodos de inicio de sesión se pueden crear en diferentes tipos de paneles de Encvoy ID:

  • Panel de Organización — nivel de empresa;
  • Panel de Aplicación (ADM) — nivel de aplicación individual.

Para los métodos de inicio de sesión creados a nivel de organización, puede configurar la publicidad, determinando exactamente dónde estarán disponibles.

Tipo de método de inicio de sesión Ajuste de publicidad Dónde está disponible Gestión
Creado en el Panel de Organización ✔ Sí Todas las aplicaciones de esta organización Gestionado solo desde el Panel de Organización
Creado en la Aplicación (Panel pequeño) ✘ No Solo en esta aplicación Gestionado en la Configuración de la Aplicación

Gestión de métodos de inicio de sesión#

Creación de un nuevo método de inicio de sesión#

Para los servicios más populares, Encvoy ID proporciona plantillas listas para usar con configuraciones. Estas simplifican el proceso de conexión, ya que contienen parámetros pre-completados específicos para cada proveedor.

El proceso de configuración consta de tres pasos:

  1. Preparación: obtenga un Client ID y un Client Secret del servicio del proveedor.

  2. Configuración en Encvoy ID: cree un proveedor del tipo correspondiente.

    Consulte la instrucción específica para configurar el proveedor seleccionado:

Edición de un método de inicio de sesión existente#

Si necesita actualizar la configuración de un método de inicio de sesión existente:

  1. Vaya al Panel de Organización o a la configuración de la aplicación correspondiente → sección Configuración.
  2. Haga clic en Configurar en el bloque Métodos de inicio de sesión.
  3. Se abrirá una ventana con una lista de los métodos de inicio de sesión creados.

  4. Haga clic en el botón Configurar en el panel del método de inicio de sesión que desea editar.

    Edición de un método de inicio de sesión en Encvoy ID

  5. Se abrirá el formulario de edición.

  6. Realice los cambios necesarios.
  7. Haga clic en Guardar.

Eliminación de un método de inicio de sesión#

  1. Vaya al Panel de Organización o a la configuración de la aplicación correspondiente → sección Configuración.
  2. Despliegue el bloque Métodos de inicio de sesión.
  3. Haga clic en Configurar.
  4. Se abrirá una ventana con una lista de los métodos de inicio de sesión creados.

  5. Haga clic en el botón Eliminar Botón Eliminar ubicado en el panel del método de inicio de sesión que desea eliminar.

    Eliminación de un método de inicio de sesión en Encvoy ID

  6. Confirme la acción en la ventana modal.

    Confirmación de eliminación del método de inicio de sesión en Encvoy ID

Tras la eliminación exitosa, el método de inicio de sesión desaparecerá de los widgets de todas las aplicaciones vinculadas.

Copia de la configuración del método de inicio de sesión#

Copiar la configuración le permite crear un nuevo método basado en uno creado previamente.

  1. Copie la configuración del método de inicio de sesión utilizando el botón Copiar Botón Copiar ubicado en el panel del método de inicio de sesión.

    Copia de la configuración del método de inicio de sesión en Encvoy ID

  2. A continuación, abra el formulario para crear un nuevo método de inicio de sesión a partir de una plantilla del mismo tipo y haga clic en Pegar Botón Pegar.

⚠️ Nota: Si los tipos no coinciden, es posible que el nuevo proveedor no funcione correctamente.

Configuración de un identificador obligatorio en el perfil de usuario#

Los Identificadores son servicios externos que el usuario ha añadido a su perfil o a través de los cuales se ha autenticado previamente en el sistema.

La lista de identificadores disponibles para añadir se forma a partir de los métodos de inicio de sesión en el panel de Encvoy ID con un ajuste de publicidad activo.

  • Si un método de inicio de sesión está configurado como público, aparecerá en la lista de identificadores disponibles para añadir en el perfil de usuario.
  • Colocar este método de inicio de sesión en el widget de la aplicación es opcional; puede estar disponible en el perfil incluso sin un botón en la pantalla principal de inicio de sesión.
  • El usuario también puede añadir un identificador durante el inicio de sesión a través del widget si dicho método de inicio de sesión está disponible.

En Encvoy ID, puede configurar el requisito de vinculación obligatoria de un identificador de cuenta externa al perfil de usuario. En este caso, al iniciar sesión en la aplicación, se le pedirá a un usuario que no tenga un identificador vinculado que añada uno a su perfil.

Cómo hacer que un identificador sea obligatorio#

  1. Vaya al Panel de Organización o a la configuración de la aplicación correspondiente → sección Configuración.
  2. Despliegue el bloque Métodos de inicio de sesión y haga clic en Configurar.
  3. Se abrirá una ventana con una lista de los métodos de inicio de sesión creados.

  4. Haga clic en el botón Hacer obligatorio Botón Hacer Obligatorio en el panel del método de inicio de sesión que desea hacer obligatorio.

    Método de inicio de sesión obligatorio en el perfil de usuario de Encvoy ID

El ajuste se aplica sin confirmación adicional.

💡 Consejo: Al hacer clic de nuevo en el botón Hacer obligatorio, el identificador volverá a ser opcional en el perfil.

Configuración del widget de inicio de sesión#

¿Qué es el widget de inicio de sesión?#

El widget de inicio de sesión es el formulario de autorización que se muestra al usuario cuando intenta acceder a una aplicación o al sistema Encvoy ID si aún no está autenticado.

El widget admite:

  • inicio de sesión clásico mediante nombre de usuario y contraseña,
  • inicio de sesión a través de varios proveedores,
  • configuración flexible de apariencia y estructura,
  • agrupación de métodos de inicio de sesión.

En el widget, los métodos de inicio de sesión se dividen en:

  • Métodos principales — se muestran como botones separados debajo del botón Iniciar sesión y se utilizan con mayor frecuencia.
  • Métodos adicionales — se colocan en el bloque Otros métodos como botones compactos para evitar saturar la interfaz.

Ejemplo de widget:

Ejemplo de widget de inicio de sesión de Encvoy ID

💡 El widget de inicio de sesión es lo primero que ve un usuario durante la autorización, por lo que es importante que coincida con el estilo visual de la empresa y sea lo más claro posible.

Configuración del widget de inicio de sesión: Apariencia y botones#

Para configurar la apariencia del widget:

  1. Vaya al Panel de Organización o a la configuración de la aplicación correspondiente → sección Configuración.
  2. Busque el bloque Métodos de inicio de sesión y haga clic en Configurar.
  3. Se abrirá la ventana Configurar apariencia del widget.

  4. En el primer bloque, se definen los elementos visuales clave:

    • Título del widget — Se muestra en la parte superior del formulario. Para mostrar el nombre de la aplicación en el encabezado del widget, use el valor APP_NAME.
    • Portada del widget — Imagen de fondo del formulario de autorización.

    • Modo de sustitución automática de portada en widgets de aplicación:

      • Desactivado — Se utiliza la portada de la aplicación,
      • Por defecto — Solo para aplicaciones sin portada,
      • Forzado — Se aplica a todas las aplicaciones.

  5. En el segundo bloque, configure la visibilidad de los elementos del formulario de inicio de sesión:

    • Mostrar logotipo de la aplicación en el widget — Cuando está habilitado, muestra el logotipo junto al nombre de la aplicación.
    • Ocultar botón de crear cuenta — Cuando está habilitado, oculta el botón de creación de cuenta del widget.
    • Ocultar pie de página — Cuando está habilitado, oculta el pie de página del widget con el texto "© 2015-2025".
    • Ocultar logotipos de los métodos de inicio de sesión principales — Cuando está habilitado, oculta los logotipos de los métodos de inicio de sesión del grupo Principales.

    Configuración de la apariencia del widget de inicio de sesión de Encvoy ID

  6. En el tercer bloque, configure el diseño de los botones:

    • Color de fondo de los botones — Esquema de color para el fondo del botón (código hex).
    • Color de fuente en los botones — Esquema de color para el texto del botón (código hex).

    Configuración del diseño de botones del widget de Encvoy ID

  7. Si es necesario, especifique el texto:

    • Campo de información adicional dentro del formulario — Texto adicional que se mostrará en la parte inferior del widget,
    • Campo adicional fuera del widget — Texto adicional que se mostrará debajo del widget.

    Configuración de texto adicional en el widget de inicio de sesión de Encvoy ID

    Los campos admiten la inserción de código HTML5 con marcado semántico completo, incluidos estilos CSS incrustados y en línea. El uso de la etiqueta script está prohibido. Al guardar, cualquier etiqueta script (incluido su contenido y atributos) se eliminará automáticamente del campo a nivel de base de datos.

  8. Haga clic en Guardar para aplicar los cambios.

    💡 Puede ver los resultados de los cambios en la sección de Vista previa.

Adición y desactivación de métodos de inicio de sesión en el widget#

Para configurar la visualización de un método de inicio de sesión en el widget:

  1. Vaya al Panel de Organización o a la configuración de la aplicación correspondiente → sección Configuración.
  2. Busque el bloque Métodos de inicio de sesión y haga clic en Configurar.
  3. Active o desactive los interruptores para los métodos de inicio de sesión deseados.
  4. Si es necesario, configure los grupos de métodos de inicio de sesión.

⚠️ Nota:

  1. Es imposible desactivar el método Nombre de usuario/contraseña. Si se desactivan todos los métodos de inicio de sesión, el método Nombre de usuario/contraseña se activa automáticamente, ya que el widget debe tener al menos un método para iniciar sesión.
  2. Desactivar un método de inicio de sesión del widget no elimina el método de inicio de sesión del sistema.

Véase también#