Usa la experiencia telefónica unificada para la autenticación sin contraseña

Aprende a configurar la experiencia telefónica unificada para la autenticación sin contraseña.

Antes de empezar

Para migrar a la experiencia telefónica unificada, debes:

• Tener habilitadas y configuradas en tu inquilino las notificaciones de MFA por SMS, voz o SMS+voz, o
• Tener habilitado y configurado el SMS sin contraseña en tu inquilino

Si no has configurado ni MFA ni la autenticación sin contraseña, lee Configurar la experiencia telefónica unificada de Auth0 para empezar desde el principio.

Si tienes integraciones de MFA y de autenticación sin contraseña con distintos proveedores, debes usar un proveedor telefónico personalizado.

Si utilizas Phone as ID, ya estás usando automáticamente la experiencia telefónica unificada de Auth0 y no necesitas hacer nada más.

La experiencia telefónica unificada centraliza toda la configuración de tus proveedores telefónicos en un solo lugar dentro de tu inquilino. No tendrás que configurar un proveedor telefónico varias veces para distintos factores de autenticación por teléfono. Para obtener más información sobre los factores telefónicos de sin contraseña, consulta Autenticación sin contraseña con SMS.

Si ya tienes un proveedor telefónico configurado para la autenticación sin contraseña, puedes migrar tu configuración a la experiencia telefónica unificada y aplicarla a nivel de inquilino.

Auth0 no informa al usuario final si un mensaje telefónico se ha enviado correctamente con el proveedor a nivel de inquilino. Para solucionar problemas, revisa los registros del inquilino.

​

Actualice su proveedor telefónico

Para usar la experiencia telefónica unificada, debe:

• Verificar la configuración actual

• Configurar su proveedor:

  • Configurar Twilio
  • Configurar un proveedor telefónico personalizado

• Actualizar los métodos de envío

​

Verifique la configuración actual

1. Para verificar su configuración actual de inicio de sesión sin contraseña, vaya a Auth0 Dashboard > Authentication > sin contraseña > SMS.
2. Seleccione Phone Message.
3. Si puede usar la experiencia telefónica unificada, aparecerá un banner indicándole que configure un proveedor a nivel de inquilino:

Si debe usar la experiencia heredada para configurar su proveedor telefónico y no aparece el interruptor para usar un proveedor a nivel de inquilino, póngase en contacto con Auth0 Support.

​

Configura Twilio como proveedor a nivel de inquilino

Si usas Twilio como proveedor telefónico para la autenticación sin contraseña, debes agregar el SID de Twilio y el AuthToken a la experiencia telefónica unificada. Puedes copiar el SID de Twilio de tu configuración actual, pero tendrás que obtener el valor de AuthToken desde Twilio.

1. Ve a Marca > Proveedor telefónico.

2. Selecciona y configura tu proveedor:

   
   1. Elige Twilio como proveedor telefónico.
   2. Elige tus métodos de entrega.
   3. Ingresa la configuración de Twilio.

3. Guarda los cambios.

4. Selecciona Send Test Message para probar el proveedor a nivel de inquilino antes de usarlo en un entorno de producción.

5. Habilita un proveedor a nivel de inquilino.

   1. Ve a Authentication > sin contraseña > SMS.

   2. Selecciona Use Tenant-level Messaging Provider

      Si no aparece ningún selector en tu inquilino, ya estás usando la experiencia telefónica unificada.

6. Guarda los cambios.

​

Cree una nueva Action custom-phone-provider para sin contraseña

La experiencia telefónica unificada no usa la pasarela SMS personalizada que configuró para SMS sin contraseña. Puede usar el Auth0 Dashboard o la Management API para configurar un proveedor telefónico personalizado con Actions de Auth0. Para obtener más información, consulte Configurar un proveedor telefónico personalizado.

Configurar custom-phone-provider para autenticación sin contraseña

Para configurar la opción telefónica de su puerta de enlace SMS personalizada mediante una Action del proveedor telefónico:

1. Vaya a Marca > Proveedor telefónico.

2. Seleccione su proveedor:

   1. Elija Personalizado.
   2. En Configuración del proveedor, agregue sus nuevas Actions de custom-phone-provider que reenvían la notificación de autenticación sin contraseña a una puerta de enlace SMS personalizada.

3. Guarde los cambios.

4. Seleccione Enviar mensaje de prueba para probar el proveedor a nivel de inquilino antes de usarlo en un entorno de producción.

5. Vaya a Autenticación > Sin contraseña > SMS para habilitar Usar proveedor de mensajería a nivel de inquilino.

6. Guarde los cambios.

Ejemplo de puerta de enlace SMS personalizada para custom-phone-provider

const request = require('<favorite_http_client>');
/**
* Manejador que se ejecuta al enviar una notificación de teléfono
* 
@param
 {Event} event - Detalles sobre el usuario y el contexto en el que está iniciando sesión.
* 
@param
 {CustomPhoneProviderAPI} api - Métodos y utilidades para modificar el comportamiento del envío de una notificación de teléfono.
*/
exports.onExecuteCustomPhoneProvider = async (event, api) => {
  const notificationType = event.notification.message_type;
  switch (notificationType) {
    case '<otp_verify>': {
      const req = {
        url: event.secrets.GATEWAY_URL,
        method: 'POST',
        headers: {
          'User-Agent': 'Auth0'
        },
        body: {
          recipient: event.notification.recipient,
          body: event.notification.as_text, // o event.notification.as_voice
          sender: event.notification.from, // TODO: falta sender, hay que verificar si se desea agregar.
          req: event.request || {}, // si no está habilitado, llegará como undefined
        }
      }
      const response = await request(req);
      console.log(response.statusCode);
      return
    }
    default: {
      // manejar otras notificaciones de la manera habitual
      return;
    }
  }
};

​

Actualizar los métodos de entrega

Factores telefónicos	Método de entrega actual del inquilino	Método de entrega deseado del inquilino	Acción del usuario
SMS	SMS	SMS + voz	Ninguna
SMS	SMS	Voz	El usuario debe actualizar los factores telefónicos sin contraseña para que sean un subconjunto de los métodos de entrega habilitados para el proveedor del inquilino
SMS	SMS + voz	Voz	El usuario debe actualizar los factores telefónicos sin contraseña para que sean un subconjunto de los métodos de entrega habilitados para el proveedor del inquilino
SMS	SMS + voz	SMS	Ninguna

​

Deshabilitar el proveedor telefónico

Si configura la experiencia telefónica unificada y luego la deshabilita, las integraciones existentes con su proveedor telefónico, incluidas las de sin contraseña, podrían dejar de funcionar.