Genere contraseñas de un solo uso (OTPs) con Amazon Pinpoint

Amazon Pinpoint incluye una función de administración de contraseñas de un solo uso (OTP) que puede utilizar para generar nuevas contraseñas de un solo uso y enviarlas a los destinatarios como SMS mensajes.

importante

Para utilizar esta función, su cuenta debe tener acceso a la producción y una identidad de origen activa. Para obtener más información, consulte Acerca del entorno limitado de SMS MMS /and Voice y Solicite un número de teléfono en la Guía del usuario de mensajería SMS para el usuario AWS final.

En algunos países y regiones, debes obtener un número de teléfono exclusivo o un identificador de origen para poder enviar SMS mensajes. Por ejemplo, al enviar mensajes a destinatarios de los Estados Unidos, debe tener un número gratuito exclusivo, un DLC número 10 o un código abreviado. Al enviar mensajes a destinatarios de la India, debe tener un identificador de remitente registrado, que incluya un identificador de entidad principal (PEID) y un identificador de plantilla. Estos requisitos se seguirán aplicando cuando utilices la OTP función.

Para utilizar esta función, necesita permisos para enviar y verificar OTP mensajes; consulteContraseñas únicas. Si necesita ayuda para determinar los permisos, consulteSolución de problemas de la administración de identidades y accesos de Amazon Pinpoint.

Puede usar la SendOtpMessages operación en Amazon Pinpoint API para enviar un OTP código a un usuario de su aplicación. Cuando lo usaAPI, Amazon Pinpoint genera un código aleatorio y se lo envía a su usuario en forma de mensaje. SMS Su solicitud puede incluir los siguientes parámetros:

• Channel— El canal de comunicación por el que se envía el OTP código. Actualmente, solo se admiten SMS mensajes, por lo que el único valor aceptable esSMS.

• BrandName— El nombre de la marca, empresa o producto asociado al OTP código. Este nombre puede contener hasta 20 caracteres.

  nota

  Cuando Amazon Pinpoint envía el OTP mensaje, el nombre de la marca se inserta automáticamente en la siguiente plantilla de mensaje:

  This is your One Time Password: {{otp}} from {{brand}}

  Por lo tanto, si especificas ExampleCorp el nombre de tu marca y Amazon Pinpoint genera una contraseña de un solo uso llamada 123456, enviará el siguiente mensaje a tu usuario:

  This is your One Time Password: 123456 from ExampleCorp

• CodeLength— El número de dígitos que habrá en el OTP código que se envía al destinatario. OTPlos códigos pueden contener entre 5 y 8 dígitos, ambos incluidos.

• ValidityPeriod— El tiempo, en minutos, durante el que el OTP código será válido. El periodo de validez puede oscilar entre 5 y 60 minutos, ambos incluidos.

• AllowedAttempts— El número de veces que el destinatario puede intentar verificar sin éxito elOTP. Si el número de intentos supera este valor, OTP automáticamente deja de ser válido. El número máximo de intentos permitidos es 5.

• Language— El idioma, en formato IETF BCP -47, que se utilizará al enviar el mensaje. Los valores aceptables son:

  • de-DE: alemán

  • en-GB: inglés (Reino Unido)

  • en-US: inglés (EE. UU.)

  • es-419: español (Latinoamérica)

  • es-ES: español

  • fr-CA: francés (Canadá)

  • fr-FR: francés

  • it-IT: italiano

  • ja-JP: japonés

  • ko-KR: coreano

  • pt-BR: portugués (Brasil)

  • zh-CN: chino (simplificado)

  • zh-TW: chino (tradicional)

• OriginationIdentity— La identidad de origen (como un código largo, un código corto o un identificador del remitente) que se utiliza para enviar el OTP código. Si utilizas un código largo o un número gratuito para enviarloOTP, el número de teléfono debe tener el formato E.164.

• DestinationIdentity— El número de teléfono, en formato E.164, al que se envió el OTP código.

• ReferenceId: un ID de referencia único para la solicitud. El identificador de referencia coincide exactamente con el identificador de referencia que proporcionaste al verificar elOTP. El ID de referencia puede contener entre 1 y 48 caracteres, ambos incluidos.

• EntityId: un ID de entidad registrado con una agencia reguladora. Actualmente, este parámetro solo se usa cuando se envían mensajes a destinatarios en India. Si no envía a destinatarios en India, puede omitir este parámetro.

• TemplateId: un ID de plantilla registrado con una agencia reguladora. Actualmente, este parámetro solo se usa cuando se envían mensajes a destinatarios en India. Si no envía a destinatarios en India, puede omitir este parámetro.

  nota

  Para obtener más información sobre los requisitos para enviar mensajes a destinatarios de la India, consulte el proceso de registro del identificador de remitente de la India en la Guía del usuario de Amazon Pinpoint.

Para asegurarse de que su cuenta de Amazon Pinpoint está configurada correctamente para enviar OTP mensajes, puede utilizarla AWS CLI para enviar un mensaje de prueba. Para obtener más información al respecto AWS CLI, consulte la Guía del AWS Command Line Interface usuario.

Para enviar un OTP mensaje de prueba mediante el AWS CLI, ejecute el send-otp-messagecomando en la terminal:

aws pinpoint send-otp-message --application-id 7353f53e6885409fa32d07cedexample --send-otp-message-request-parameters Channel=SMS,BrandName=ExampleCorp,CodeLength=5,ValidityPeriod=20,AllowedAttempts=5,OriginationIdentity=[phone],DestinationIdentity=[phone],ReferenceId=SampleReferenceId

En el comando anterior, haga lo siguiente.

• Reemplazar 7353f53e6885409fa32d07cedexample con el identificador de tu aplicación.

• Reemplazar ExampleCorp con el nombre de su empresa.

• Reemplazar 5 entre CodeLegth el número de dígitos que habrá en el OTP código que se envíe al destinatario.

• Reemplazar 20 ValidityPeriodIndica el tiempo, en minutos, durante el que el OTP código será válido.

• Reemplazar 5 es AllowedAttempts el número de veces que el destinatario puede intentar verificar sin éxito elOTP.

• Reemplazar [phone] entre OriginationIdentity con la identidad de origen que se utiliza para enviar el OTP código.

• Reemplazar [phone] ingresa DestinationIdentity con el número de teléfono al que deseas enviar el OTP código.

• Reemplazar SampleReferenceId ReferenceIdcon un identificador de referencia único para la solicitud.

Respuesta de SendOtpMessage

Cuando envías un OTP mensaje correctamente, recibes una respuesta similar a la del siguiente ejemplo:

{
    "MessageResponse": {
        "ApplicationId": "7353f53e6885409fa32d07cedexample",
        "RequestId": "255d15ea-75fe-4040-b919-096f2example",
        "Result": {
            "[phone]": {
                "DeliveryStatus": "SUCCESSFUL",
                "MessageId": "nvrmgq9kq4en96qgp0tlqli3og1at6aexample",
                "StatusCode": 200,
                "StatusMessage": "MessageId: nvrmgq9kq4en96qgp0tlqli3og1at6aexample"
            }
        }
    }
}