SMS_Code_Gold
Send Code by SMS
Proveedor: Sysworld
Fecha: 2021-08-18 14:20:03
notifications, productivity, security
automotive, coorp, fintech, insurance, tech
- ID : 3873c89a52756b1a2a1ec5393d5014bd
- Contexto : certisend/sms/codetrack
- Estado : Activa
El servicio de SMS_Code_Gold o comúnmente llamado como Autenticación de dos factores (2FA) vía SMS es un servicio que originalmente nació para poder lograr incrementar la seguridad de autenticación de un usuario y/o validar la identidad de una persona.
Dicho servicio permite generar un código rándom numérico / alfanumérico de varios dígitos y enviárselo por un servicio premium de SMS de número corto a un dispositivo móvil.
Ventajas
- Envío de SMS mediante SMS Premium de Número Corto con tiempos de entrega inmediatos y seguridad en el despacho.
- No se necesitan tokens adicionales puesto que utiliza los dispositivos móviles que se portan en todo momento.
- Puesto que se cambian continuamente, los códigos generados dinámicamente son más seguros de utilizar que la información de autenticación fija o estática.
- Dependiendo de la solución, los códigos que se han utilizados son reemplazados para asegurarse de que siempre hay un código válido disponible. Por lo tanto, los problemas de transmisión o recepción no son un impedimento para la autenticación del usuario.
- La opción de especificar un número máximo de intentos fallidos reduce el riesgo de que haya ataques de personas no autorizadas.
- Fácil de configurar y de fácil uso.
Aplicaciones:
- Validar y comprobar el celular de la persona que se está registrando.
- Incrementar la seguridad de un sistema de control de accesos.
- Simplificar el login a sistemas seguros mediante contraseña de un solo uso (OTP).
Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:
- Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/certisend/sms/codetrack
Parámetros de entrada:
- token-susc: Token obtenido al momento de la suscripción a nivel empresa.
- token-api: Token obtenido al momento de la suscripción a nivel API.
- country: Código numérico del país.
- tel: (Obligatorio) Número de teléfono móvil (solo números, sin espacios ni guiones).
- msg: (Obligatorio) Mensaje de texto, dentro del mismo tiene que venir la inscripción #CODE#, la cual será reemplazada por el código OTP.
El mensaje de SMS no debe superar los 160 caracteres, tampoco debe incluir acentos o caracteres especiales. - digits: Cantidad de números que se generarán en su código, el mínimo por defecto es de 4 caracteres.
- expiry_time: Tiempo de expiración que tendrá el código generado, en minutos.
- mark: En el caso de que se haya realizado un envío previo en la API "ERN_Complete_Code_Gold" y se haya completado el campo opcional "mark", en este parámetro se debe agregar el mismo valor ingresado con anterioridad. Esto permitirá que el PIN enviado por SMS sea el mismo que el enviado por Email.
- id_internal: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.
La llamada quedaría de la siguiente manera:
https://cont1-virtual1.certisend.com/web/container/api/v1/certisend/sms/codetrack?token-susc=TOKENSUSC&token-api=TOKENAPI&tel=1111111111&msg=Tu%20pin%20es:%20%23CODE%23&digits=5&mark=marcacliente1&internalid=2
Una vez realizada la llamada van a recibir los siguientes parámetros:
- state: Tendrá el valor 0 para un parámetro faltante y un 1 en el caso de que se encuentre información.
- desc: Descripción del parámetro "state" recibido.
- code: Código generado, se puede utilizar para el seguimiento del envío.
- id_internal: ID interno ingresado por el cliente.
Respuesta de Ejemplo:
Negativa:
{"state": "0","desc": "minimum digits must be 4","id_internal": "10"}
Positiva:
{"state": "1","desc": "email sent","code": "3cdfbc5ecb0cb63d02df7e9e9c2effa0","id_internal": "10"}
Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test