Masiv OTP Manager

El producto OTP Manager permite la generación, envío y validación de claves OTP (One Time Password) o Contraseña de Un Solo Uso.

La generación de una OTP está ligada a una serie de parámetros de configuración: longitud de la clave, la posibilidad de contar con números, letras mayúsculas o minúsculas, tiempo de expiración y cantidad de intentos de validación permitidos, entre otros. OTP Manager cuenta con dos posibilidades de generación, la primera de ellas tomando las opciones de generación de la OTP desde una configuración preestablecida, la cual debe ser creada previamente, y la segunda de ellas tomando las opciones de generación de la OTP desde la petición inicial.

Todas las OTP generadas, deben estar asociadas a un cliente y a un usuario, y la forma de asociarlo es por medio de un Id de cuenta de cliente, y a un número de teléfono o un correo electrónico, es decir, cada solicitud de generación de una OTP debe incluir un número de teléfono o un correo electrónico, al cual va a quedar asociado la clave generada, esto con el fin de poder realizar una posterior validación de la clave.

OTP Manager cuenta con la posibilidad de generar una OTP y retornarla en la respuesta de la solicitud, pero si se requiere, también es posible enviarla a un usuario final por medio de los canales de Masiv, los canales soportados son: SMS, Email, Voice, WhatsApp, y por medio de flujos del Hub Transaccional.

Autenticación

Todas las peticiones que se realicen a los diferentes endpoints de OTP Manager deben contener una cabecera de autenticación

Headers:
Authorization: Bearer/Basic <Authentication Token>

URL Base

<aside> 🔗 https://otp-manager.masivapp.com

</aside>

Gestión de Configuraciones

Este módulo permite definir y gestionar configuraciones reutilizables para la generación de OTPs. En lugar de enviar todos los parámetros necesarios en cada solicitud de generación, el sistema permite registrar previamente una configuración con un identificador único (OtpConfigId) para que luego este sea utilizado en cada generación que se quiera realizar.

POST Creación de configuraciones

GET Listado de Configuraciones por Cliente

GET Configuración

PUT Configuración

DELETE Configuración

Generación de OTP

Este módulo le permite generar una OTP con diferentes carácterísticas como tiempo de expiración de la misma, cantidad de intentos por parte del destinatario final de la misma. Se pueden generar OTPs mediante 2 vías, partiendo de una configuración ya establecida (Para ver la gestión de una configuración ver el módulo Gestión de Configuraciones). En ambas vías es posible tener y configurar una integración con diferentes canales de Masiv: SMS, Email, WhatsApp, Hub Transaccional, Voz (Importante haber configurado y hábilitado estos productos previamente para poder realizar la integración desde OTP).

POST Generación partiendo de una configuración