Saltar al contenido principal
Auth0 Guardian es una aplicación móvil para dispositivos iOS y Android que permite a los usuarios completar la autenticación multifactor (MFA) mediante notificaciones push o códigos temporales de un solo uso. Auth0 Guardian puede enviar notificaciones push a los dispositivos inscritos de los usuarios (normalmente teléfonos móviles o tabletas) o generar códigos de un solo uso directamente en la aplicación. Los usuarios pueden responder rápidamente a estas notificaciones push u obtener un código de un solo uso para completar el inicio de sesión. Los usuarios pueden descargar la aplicación Auth0 Guardian desde la Apple App Store o la Google Play Store. Como alternativa, puede integrar las capacidades de Auth0 Guardian en su propia aplicación personalizada mediante el SDK de Guardian.

Notificaciones push

Para usar notificaciones push, los usuarios deben tener instalada en su dispositivo la aplicación Auth0 Guardian o una aplicación personalizada creada con el SDK de Guardian. Cuando un usuario intenta autenticarse, se envían notificaciones push a la aplicación instalada. El usuario debe responder a la notificación para completar el inicio de sesión, lo que demuestra que conoce sus credenciales de inicio de sesión y que posee el dispositivo configurado para . Las notificaciones push de Auth0 se pueden implementar mediante AWS Simple Notification Service (SNS) o uno o varios de los siguientes servicios directos de proveedor para configurar integraciones específicas de cada proveedor:
  • Firebase Cloud Messaging (FCM)
    • Para obtener más información sobre cómo modificar el contenido de las notificaciones push, consulta la documentación de FCM.
  • Apple Push Notification (APN)
    • Para obtener más información sobre cómo modificar el contenido de las notificaciones push, consulta la documentación de Apple.
Diagrama del flujo de Auth0 Guardian

Inscribirse en las notificaciones push

Cuando utiliza Auth0 Guardian para configurar notificaciones push, se les pide a los usuarios que descarguen la aplicación móvil la primera vez que se registran o inician sesión en su aplicación. Si utiliza SDK de Guardian para implementar notificaciones push en una aplicación personalizada, no se les pide a los usuarios que descarguen ninguna aplicación durante la inscripción. Puede habilitar las notificaciones push desde el en Security > Multi-factor Auth > Push Notification using Auth0 Guardian.
Auth0 Dashboard > Security > Multi-factor Auth > Push Notification using Auth0 Guardian
La primera vez que un usuario se registra o inicia sesión en su aplicación, Universal Login muestra un código QR que puede usar para registrar la aplicación Auth0 Guardian o una aplicación personalizada creada con SDK de Guardian como factor de autenticación secundario. El usuario tiene poco tiempo para escanear este código con la aplicación designada y completar la inscripción. Una vez que el usuario se inscribe, puede usar las notificaciones push como factor de autenticación. Cada vez que el usuario intente iniciar sesión en su aplicación, recibirá una notificación push en su dispositivo a través de Auth0 Guardian o de una aplicación personalizada creada con SDK de Guardian. El usuario debe aprobar esta solicitud para iniciar sesión correctamente en su aplicación. Para obtener información sobre cómo restablecer la MFA para usuarios que han perdido sus dispositivos o códigos de recuperación, consulte Restablecer la autenticación multifactor y los códigos de recuperación. Para obtener ayuda adicional, consulte Solucionar problemas de autenticación multifactor.

Códigos temporales de un solo uso

La aplicación Auth0 Guardian y el SDK de Guardian también admiten el uso de códigos temporales de un solo uso (OTP) como factores de autenticación secundarios. Tanto la aplicación como el SDK pueden generar OTP temporales que los usuarios pueden usar para completar los desafíos de MFA de . De forma predeterminada, la aplicación Auth0 Guardian muestra las aplicaciones que el usuario tiene inscritas. Después de seleccionar una aplicación, se muestra el OTP correspondiente. Cada OTP de 6 dígitos es válido durante 30 segundos. Los OTP que están a punto de vencer se muestran en rojo. Cuando vence, la aplicación genera inmediatamente un nuevo OTP. Para evitar errores de autenticación, los usuarios no deben usar ningún OTP que aparezca en rojo En las aplicaciones personalizadas del SDK de Guardian, la apariencia de los OTP puede variar.

Use códigos temporales de un solo uso

Puede usar los OTP de dos formas principales:
  • Como opción de respaldo para las notificaciones push, en caso de que la aplicación Auth0 Guardian u otra aplicación personalizada no reciba una solicitud push.
  • Como desafío de MFA, si habilita el factor One-Time Password en su inquilino.
Si un usuario no recibe una notificación push a través de Auth0 Guardian u otra aplicación personalizada, puede usar un OTP temporal para completar su desafío de MFA.Ejemplo de flujo del usuario:
  1. Un usuario intenta iniciar sesión en su aplicación. Llega a la pantalla de MFA de Universal Login, pero no recibe ninguna notificación push.
  2. En la pantalla de MFA, el usuario selecciona el botón Manually Enter Code. Debe seleccionar esta opción para autenticarse con OTP.
    Ejemplo de una pantalla de MFA que muestra el botón Manually Enter Code
  3. El usuario abre Auth0 Guardian o la aplicación personalizada con SDK de Guardian y selecciona la aplicación a la que intenta acceder.
  4. El usuario copia el OTP que se muestra en la parte inferior de la página Account Detail.
  5. El usuario introduce el OTP en la pantalla de MFA para completar el desafío.
Para permitir que los usuarios se autentiquen con OTP, debe habilitar One-Time Password como factor MFA para su inquilino. Una vez habilitado, los usuarios pueden completar las pantallas de MFA con OTP al iniciar sesión mediante Universal Login. Para habilitar factores MFA, vaya a Auth0 Dashboard > Security > Multi-factor Auth.Los usuarios pueden inscribirse en OTP como factor MFA cuando se registran o inician sesión por primera vez en su aplicación. Según el tipo de dispositivo que usen, Universal Login muestra una de las siguientes opciones:
  • Para dispositivos no móviles: Universal Login muestra un código QR que el usuario puede escanear para continuar con la inscripción.
Ejemplo de una pantalla de inscripción en OTP que muestra el enlace Trouble Scanning?
  • Para dispositivos móviles: Universal Login omite el código QR y, en su lugar, muestra directamente el código de inscripción.
Pantalla de inscripción de código temporal de un solo uso tal como se muestra en un dispositivo móvil.
Con cualquiera de estos métodos, los usuarios pueden seguir los pasos que aparecen en pantalla para registrar la aplicación Auth0 Guardian o una aplicación personalizada con SDK de Guardian como factor de autenticación secundario. Normalmente, este proceso implica que el usuario agregue su aplicación a la aplicación correspondiente y obtenga el OTP resultante para esa aplicación. Luego, introduce el OTP en la pantalla de Universal Login para finalizar el proceso de inscripción.La próxima vez que el usuario intente iniciar sesión en su aplicación después de completar la inscripción, podrá autenticarse introduciendo un OTP de su aplicación Auth0 Guardian o de su aplicación personalizada con SDK de Guardian en el desafío.

Configuración de la aplicación Auth0 Guardian

Configuración de seguridad del usuario

En la aplicación Auth0 Guardian, los usuarios pueden habilitar códigos de acceso y biometría como capas adicionales de seguridad en iOS y Android. Si un usuario habilita una o más de estas opciones, debe completar estos desafíos antes de poder responder a las notificaciones push u obtener códigos de un solo uso. Para habilitar estas opciones en dispositivos iOS o Android, los usuarios pueden seguir los pasos que se indican a continuación.
Para habilitar la configuración de seguridad de la aplicación Auth0 Guardian en iOS:
  1. En la aplicación, selecciona el icono del engranaje para abrir el menú Configuración.
  2. Selecciona Passcode para habilitar la protección con código de acceso.
  3. Define y confirma un código de acceso de 6 dígitos.
La aplicación ahora está protegida con el código de acceso. El usuario debe introducir este código de acceso antes de poder responder a las notificaciones push u obtener OTP.Después de habilitar la protección con código de acceso, el usuario puede configurar la biometría del dispositivo como medida de seguridad alternativa. Para habilitar la biometría del dispositivo:
  1. En la aplicación, selecciona el icono del engranaje para abrir el menú Configuración.
  2. Habilita la biometría del dispositivo seleccionando una de las opciones disponibles, como Face ID o Touch ID.

Opciones de localización

La aplicación Auth0 Guardian admite la localización en varios idiomas y dialectos en iOS y Android. En la sección Idioma del menú Configuración, los usuarios pueden seleccionar su idioma preferido. De forma predeterminada, la aplicación usa el mismo idioma que el sistema del dispositivo.
La mayor parte del contenido de las notificaciones push se muestra a los usuarios en su idioma preferido. Sin embargo, los títulos de las notificaciones push no se traducen, ya que la configuración de idioma no se recupera hasta después de que se completa el título.
La aplicación Auth0 Guardian admite los siguientes idiomas y dialectos:
IdiomaCódigo
Albanéssq
Amháricoam
Árabe*ar
Árabe (Egipto)*ar-EG
Árabe (Arabia Saudita)*ar-SA
Armeniohy
Azerbaiyanoaz
Vascoeu-ES
Bengalíbn
Bosniobs
Búlgarobg
Catalánca-ES
Chino - Hong Kongzh-HK
Chino - Simplificadozh-CN
Chino - Tradicionalzh-TW
Croatahr
Checocs
Danésda
Neerlandésnl
Inglésen
Inglés - Canadáen-CA
Estonioet
Farsi (persa)*fa
Finésfi
Francésfr-FR
Francés - Canadáfr-CA
Gallegogl-ES
Georgianoka
Alemánde
Griegoel
Guyaratígu
Hebreo*he
Hindihi
Húngarohu
Islandésis
Indonesioid
Italianoit
Japonésja
Canaréskn
Coreanoko
Letónlv
Lituanolt
Macedoniomk
Malayoms
Malayalamml
Maratímr
Mongolmn
Montenegrinocnr
Birmanomy
Noruegono
Noruego - Bokmålnb
Noruego - Nynorsknn
Polacopl
Portugués - Brasilpt-BR
Portugués - Portugalpt-PT
Punyabípa
Rumanoro
Rusoru
Serbiosr
Eslovacosk
Eslovenosl
Somalíso
Españoles
Español - Argentinaes-AR
Español - América Latinaes-419
Español - Méxicoes-MX
Suajilisw
Suecosv
Tagalotl
Tamazightzgh
Tamilta
Telugute
Tailandésth
Turcotr
Ucranianouk
Urdu*ur
Vietnamitavi
Galéscy

Temas de la app Guardian

La aplicación Auth0 Guardian, tanto para iOS como para Android, admite los temas claro y oscuro. En la sección Theme del menú Settings, los usuarios pueden seleccionar las siguientes opciones:
  • System: Usa el tema predeterminado del sistema
  • Light: Activa el tema claro
  • Dark: Activa el tema oscuro

Opciones de personalización para aplicaciones protegidas

Para que a los usuarios les resulte más fácil distinguir entre sus aplicaciones protegidas en la aplicación Auth0 Guardian, cada aplicación puede personalizarse con un nombre, un color de acento y un icono distintos.
El nombre predeterminado asignado a su aplicación en la aplicación Auth0 Guardian lo determina su nombre del inquilino o el nombre descriptivo configurado en la configuración del inquilino. Del mismo modo, el logotipo predeterminado proviene de la URL del logotipo proporcionada en la configuración del inquilino.Para editar la configuración del inquilino, vaya a Auth0 Dashboard > Settings > General.
Para personalizar una aplicación protegida:
  1. Seleccione una aplicación de la lista.
    • Consejo: También puede deslizar el dedo hacia la izquierda sobre la aplicación para mostrar las opciones Edit y Delete.
  2. En la página Account Detail, elija Edit.
  3. Actualice el nombre, el color y el icono de la aplicación según sea necesario.
  4. Seleccione Save.

SDKs de Guardian

Puede instalar el SDK de Guardian (disponible para iOS y Android) para crear su propia aplicación de autenticación multifactor con control total sobre la marca y el aspecto visual. Con el SDK de Guardian, puede crear sus propias aplicaciones móviles personalizadas que funcionen como Guardian o integrar algunas de sus funcionalidades, como recibir notificaciones push en sus aplicaciones móviles existentes. Un caso de uso típico podría ser una aplicación bancaria. Puede usar el SDK de Guardian en su aplicación móvil existente para recibir y confirmar notificaciones push cuando alguien realiza una transacción en un cajero automático.

Utilice Actions para habilitar la autenticación multifactor con Auth0 Guardian

Para habilitar Auth0 Guardian en una Action, pase guardian como parámetro provider al habilitar la autenticación multifactor:
exports.onExecutePostLogin = async (event, api) => {
  api.multifactor.enable('guardian', { allowRememberBrowser: false });
};
Para obligar a tus usuarios a iniciar sesión con Auth0 Guardian en cada ocasión, crea la Action con allowRememberBrowser: false.

Autenticación multifactor con Auth0 Guardian y Authorization Extension

Esta plantilla proporciona un ejemplo y un punto de partida para desencadenar la autenticación multifactor con Auth0 Guardian mediante notificaciones push cuando se cumple una condición. En el primer inicio de sesión, el usuario puede inscribir su dispositivo. Consulte Habilitar la autenticación multifactor para obtener más información sobre M
exports.onExecutePostLogin = async (event, api) => {
const groups = event.user.app_metadata.authorization.groups;
const GROUPS_WITH_MFA = {
// Agrega aquí los grupos que requieren MFA
// Ejemplo
admins: true
};

const needsMFA = !!groups.find(function (group) {
return GROUPS_WITH_MFA[group];
});

if (needsMFA) {
// opcional, el valor predeterminado es true. Establece en false para forzar la autenticación con Guardian en cada inicio de sesión.
// Consulta https://auth0.com/docs/secure/multi-factor-authentication/customize-mfa#change-frequency-of-mfa-prompts para más detalles
api.multifactor.enable('guardian', { allowRememberBrowser: false });
}

};

Más información