Integre RCS en sus flujos de trabajo de autenticación

Introducción

Servicios de Comunicación Enriquecidos (RCS) es la próxima evolución de los SMS con funciones modernas como la verificación de marca, los recibos de lectura y la entrega a través de datos móviles o Wi-Fi. A medida que aumenta el número de dispositivos móviles y operadores que admiten RCS por defecto, los usuarios esperan cada vez más interacciones seguras y fluidas directamente dentro de su aplicación de mensajería.

Para las empresas, esto abre una poderosa oportunidad: habilitar la autenticación de dos factores (2FA) directamente a través de RCS.

En este tutorial, aprenderás a integrar RCS en tus flujos de trabajo de autenticación utilizando la Verify API de Vonage. También configurarás una ruta de retorno, de modo que si RCS no es compatible con el dispositivo o la red del usuario, la solicitud de verificación volverá automáticamente a otro canal como SMS.

Requisitos previos

• npm y Node instalados.

• Un teléfono con capacidades RCS.

• Vonage API Account

  To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

  

  Ready to start building?

  Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

¿Qué es RCS y por qué utilizarlo?

RCS es una mejora del canal SMS que permite enviar mensajes a través de Wi-Fi o datos móviles a aplicaciones de mensajería predeterminadas en Android y iPhone. También admite la validación de marca y tiene baja latencia en la entrega. Para utilizar el canal canal RCSun Agente RCS o ID de remitente es necesario.

Preguntas frecuentes

1. ¿Qué es RCS?

2. ¿Qué es un agente RCS/RBM?

3. ¿Cómo puedo comprobar si RCS está activo en mi dispositivo?

Configurar un flujo de trabajo Verify API

A flujo de trabajo de Verify es una secuencia de pasos creada para autenticar la identidad de un usuario. Puede tratarse del envío de un SMS o de un mensaje de correo electrónico con un código de contraseña que puede utilizarse una sola vez para confirmar la identidad del usuario.

Puede crear un flujo de trabajo de verificación que utilice en primer lugar un canal preferido y, a continuación, vuelva automáticamente a un canal diferente si el intento inicial no tiene éxito. Dispone de una lista de canales que también puede enviar, incluidos SMS, autenticación silenciosa, correo electrónico y WhatsApp.

Configuremos un flujo de trabajo Verify que toma el canal RCS como el predeterminado. Si el mensaje no se convierte con éxito, se utilizará el siguiente canal de la lista. Utilizaremos SMS como segundo canal, ya que es omnipresente y está ampliamente disponible.

Configuración del proyecto

Configura tu cuenta de Vonage y Verify Agent

Asegúrate de registrarte/ingresar a una cuenta API de Vonage para tener acceso a la API.

Crear una aplicación

Configure su proyecto Node

Crea un nuevo directorio para tu proyecto, inicializa un nuevo proyecto Node e instala las dependencias.

mkdir blog-verify_rcs-node-auth-workflows

cd blog-verify_rcs-node-auth-workflows

npm init -y

npm install @vonage/server-sdk @vonage/verify2

Configuración del entorno

Cree un archivo .env, y añadiremos algunas variables de entorno a él. Pasaré por cada una explicando para qué se usan y dónde encontrarlas.

• VERIFY_BRAND_NAME: Nombre que verán los usuarios durante la verificación.

• VONAGE_APPLICATION_PRIVATE_KEY_PATH: Ruta a su archivo de clave privada.

• VONAGE_APPLICATION_ID: Tu ID de solicitud de Vonage.

• VERIFY_NUMBER: Número de teléfono de prueba para recibir RCS/SMS.

• RCS_SENDER_ID: Sender ID para RCS, que se encuentra en la pestaña "Link External Accounts".

Enviar un código de verificación utilizando RCS y Fallback en Node.js

Cree un archivo JavaScript, llamaré al mío index.jse inicializa tus dependencias:

// index.js

require("dotenv").config();

const { Vonage } = require("@vonage/server-sdk");

const { Channels } = require("@vonage/verify2");

const vonage = new Vonage({

 applicationId: process.env.VONAGE_APPLICATION_ID,

 privateKey: process.env.VONAGE_APPLICATION_PRIVATE_KEY_PATH,

});

Luego usaremos vonage.verify2.newRequest del Vonage Verify V2 SDK para Node.jsagregando el canal RCS (primer intento) y SMS (fallback), respectivamente.

// index.js

vonage.verify2

 .newRequest({

   brand: process.env.VERIFY_BRAND_NAME,

   workflow: [

     {

       channel: Channels.RCS,

       to: process.env.VERIFY_NUMBER,

       from: process.env.RCS_SENDER_ID,

     },

     {

       channel: Channels.SMS,

       to: process.env.VERIFY_NUMBER,

     },

   ],

 })

 .then(({ requestId }) => console.log(requestId))

 .catch((err) => console.error(err));

Ejecute su flujo de trabajo y pruebe RCS Fallback

Ejecute el comando nodo seguido del nombre de su archivo JavaScript. Al hacerlo, se enviará un mensaje al número que haya especificado en la variable de entorno VERIFY_NUMBER. En primer lugar, intentará ponerse en contacto contigo a través de RCS; si esto no es posible, se enviará un mensaje SMS como alternativa.

node index.js

Nota: Si recibe una devolución de llamada a su webhook indicando que la solicitud ha sido bloqueada, es posible que la red de destino haya sido bloqueada por el sistema antifraude de la plataforma antifraude de la plataforma.

Posibles ampliaciones

Cuanto más podamos ayudar a nuestros usuarios a mitigar el fraude, mejor. Verify API de Vonage te permite verificar a tus usuarios enviando contraseñas de un solo uso (OTP) a varios canales. El código que he mostrado hoy es similar a la guía sobre cómo enviar una solicitud de verificación usando múltiples canales para fallbacksin embargo, este tutorial se centra en los canales RCS y SMS en JavaScript. Puedes encontrar más ejemplos en otros lenguajes enlazados en la documentación.

Conclusión

¡Eso es todo! En esta publicación del blog, has visto cómo es posible usar el canal RCS dentro de Verify API de Vonage y cómo se puede volver al siguiente canal especificado en caso de que RCS no esté disponible en el dispositivo.

Lecturas complementarias

Mejora tu autenticación multifactor con las API de Vonage y Firebase.

Autenticación de grupos de confianza con SMS y Express.

Mejore su autenticación multifactor con las API Verify y SIM Swap.