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

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

importante

Para utilizar esta característica, la cuenta debe tener acceso a producción y una identidad de origen activa. Para obtener más información, consulte About the SMS/MMS and Voice sandbox y Request a phone number en la Guía del usuario de Mensajes SMS para usuarios finales de AWS .

En algunos países y regiones, debe obtener un número de teléfono dedicado o un ID de origen antes de poder enviar mensajes SMS. Por ejemplo, cuando envía mensajes a destinatarios en Estados Unidos, debe tener un número gratuito dedicado, un número 10DLC o un código corto. Cuando envíe mensajes a destinatarios en India, debe tener un ID de remitente registrado, que incluya un ID de entidad principal (PEID) y un ID de plantilla. Se siguen aplicando estos requisitos cuando utiliza la característica de OTP.

Para utilizar esta característica, necesita permisos para enviar y verificar mensajes de OTP, consulte Contraseñas únicas. Si necesita ayuda para determinar los permisos, consulte Solución de problemas de la administración de identidades y accesos de Amazon Pinpoint.

Puede utilizar la operación SendOtpMessages en la API de Amazon Pinpoint para enviar un código de OTP a un usuario de la aplicación. Cuando utiliza esta API, Amazon Pinpoint genera un código aleatorio y se lo envía al usuario como mensaje SMS. La solicitud puede incluir los siguientes parámetros:

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

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

  nota

  Cuando Amazon Pinpoint envía el mensaje de OTP, 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 código de OTP que se envía al destinatario. Los códigos de OTP pueden contener entre 5 y 8 dígitos, ambos incluidos.

• ValidityPeriod: la cantidad de tiempo, en minutos, durante el que el código de OTP 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 la OTP sin éxito. Si el número de intentos supera este valor, la OTP deja de ser válida automáticamente. 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 ID del remitente) que se utiliza para enviar el código de OTP. Si utiliza un código largo o un número gratuito para enviar la OTP, 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 código de OTP.

• ReferenceId: un ID de referencia único para la solicitud. El ID de referencia coincide exactamente con el ID de referencia que proporciona al verificar la OTP. 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 cómo enviar mensajes SMS a destinatarios en la India, consulte India sender ID registration process en la Guía del usuario de Amazon Pinpoint.

Para asegurarse de que su cuenta de Amazon Pinpoint está configurada correctamente para enviar mensajes OTP, 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 mensaje OTP 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.

• 7353f53e6885409fa32d07cedexampleSustitúyalo por el identificador de tu aplicación.

• ExampleCorpSustitúyalo por el nombre de su empresa.

• 5Sustitúyelo por el número de dígitos que habrá en el código OTP que se envía al destinatario. CodeLegth

• 20Sustitúyalo por el tiempo, en minutos, durante el que el código OTP será válido. ValidityPeriod

• 5Sustitúyalo por el número de veces que el destinatario puede intentar verificar la OTP sin éxito. AllowedAttempts

• [phone]OriginationIdentitySustitúyalo por la identidad de origen que se utiliza para enviar el código OTP.

• [phone]DestinationIdentitySustitúyalo por el número de teléfono al que se va a enviar el código OTP.

• SampleReferenceIdReferenceIdSustitúyalo por un identificador de referencia único para la solicitud.

Respuesta de SendOtpMessage

Cuando envía correctamente un mensaje de OTP, recibe una respuesta similar al siguiente ejemplo:

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