Exemplos de código de OTP para usar o SDK para Python (Boto3) no Amazon Pinpoint

Esta seção contém exemplos de código que mostram como usar o SDK para Python (Boto3) para enviar e verificar códigos OTP.

Gerar um ID de referência

A função a seguir gera um ID de referência exclusivo para cada destinatário, com base no número de telefone do destinatário, no produto ou marca para o qual o destinatário está recebendo uma OTP e na origem da solicitação (que pode ser o nome de uma página em um site ou aplicativo, por exemplo). Ao verificar o código OTP, você deve passar um ID de referência idêntico para que a validação seja bem-sucedida. Os exemplos de código de envio e validação usam essa função utilitária.

Essa função não é obrigatória, mas é uma forma útil de definir o escopo do processo de envio e verificação de OTP para uma transação específica, de forma que possa ser facilmente reenviada durante a etapa de verificação. Você pode usar qualquer ID de referência que quiser. Esse é apenas um exemplo básico. No entanto, os outros exemplos de código nesta seção dependem dessa função.

# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier:  Apache-2.0

import hashlib
 
def generate_ref_id(destinationNumber,brandName,source):
    refId = brandName + source + destinationNumber
    return hashlib.md5(refId.encode()).hexdigest()

Enviar códigos de OTP

O exemplo de código a seguir mostra como usar o SDK para Python (Boto3) para enviar um código OTP.

# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier:  Apache-2.0

import boto3
from botocore.exceptions import ClientError
from generate_ref_id import generate_ref_id

### Some variables that are unlikely to change from request to request. ###

# The AWS Region that you want to use to send the message.
region = "us-east-1"

# The phone number or short code to send the message from.
originationNumber = "[phone]"

# The project/application ID to use when you send the message.
appId = "7353f53e6885409fa32d07cedexample"

# The number of times the user can unsuccessfully enter the OTP code before it becomes invalid.
allowedAttempts = 3

# Function that sends the OTP as an SMS message.
def send_otp(destinationNumber,codeLength,validityPeriod,brandName,source,language):
    client = boto3.client('pinpoint',region_name=region)
    try:
        response = client.send_otp_message(
            ApplicationId=appId,
            SendOTPMessageRequestParameters={
                'Channel': 'SMS',
                'BrandName': brandName,
                'CodeLength': codeLength,
                'ValidityPeriod': validityPeriod,
                'AllowedAttempts': allowedAttempts,
                'Language': language,
                'OriginationIdentity': originationNumber,
                'DestinationIdentity': destinationNumber,
                'ReferenceId': generate_ref_id(destinationNumber,brandName,source)
            }
        )

    except ClientError as e:
        print(e.response)
    else:
        print(response)

# Send a message to [phone] that contains a 6-digit OTP that is valid for 15 minutes. The
# message will include the brand name "ExampleCorp", and the request originated from a part of your
# site or application called "CreateAccount". The US English message template should be used to
# send the message.
send_otp("[phone]",6,15,"ExampleCorp","CreateAccount","en-US")

Validar códigos de OTP

O exemplo de código a seguir mostra como usar o SDK para Python (Boto3) para verificar um código OTP já enviado. Para que a etapa de validação seja bem-sucedida, sua solicitação deve incluir um ID de referência que corresponda exatamente ao ID de referência usado para enviar a mensagem.

# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier:  Apache-2.0

import boto3
from botocore.exceptions import ClientError
from generate_ref_id import generate_ref_id

# The AWS Region that you want to use to send the message.
region = "us-east-1"

# The project/application ID to use when you send the message.
appId = "7353f53e6885409fa32d07cedexample"

# Function that verifies the OTP code.
def verify_otp(destinationNumber,otp,brandName,source):
    client = boto3.client('pinpoint',region_name=region)
    try:
        response = client.verify_otp_message(
            ApplicationId=appId,
            VerifyOTPMessageRequestParameters={
                'DestinationIdentity': destinationNumber,
                'ReferenceId': generate_ref_id(destinationNumber,brandName,source),
                'Otp': otp
            }
        )

    except ClientError as e:
        print(e.response)
    else:
        print(response)

# Verify the OTP 012345, which was sent to [phone]. The brand name ("ExampleCorp") and the
# source name ("CreateAccount") are used to generate the correct reference ID.
verify_otp("[phone]","012345","ExampleCorp","CreateAccount")