Générez des mots de passe à usage unique (OTPs) avec Amazon Pinpoint

Amazon Pinpoint inclut une fonctionnalité de gestion des mots de passe à usage unique (OTP) que vous pouvez utiliser pour générer de nouveaux mots de passe à usage unique et les envoyer à vos destinataires sous forme de SMS.

Important

Pour utiliser cette fonctionnalité, votre compte doit disposer d'un accès à la production et d'une identité d'origine active. Pour plus d'informations, reportez-vous aux sections À propos du sandbox SMS/MMS et vocal et Demander un numéro de téléphone dans le Guide de l'utilisateur pour la messagerie SMS à l'utilisateur AWS final.

Dans certains pays et régions, vous devez obtenir un numéro de téléphone ou un identifiant d'origine dédié avant de pouvoir envoyer des SMS. Par exemple, lorsque vous envoyez des messages à des destinataires aux États-Unis, vous devez disposer d'un numéro gratuit dédié, d'un numéro 10DLC ou d'un code abrégé. Lorsque vous envoyez des messages à des destinataires en Inde, vous devez disposer d'un ID d'expéditeur enregistré, qui comprend un ID d'entité principale (PEID) et un ID de modèle. Ces exigences s'appliquent toujours lorsque vous utilisez la fonctionnalité OTP.

Pour utiliser cette fonctionnalité, vous devez disposer d'autorisations pour envoyer et vérifier des messages OTP. Consultez Mots de passe uniques. Si vous avez besoin d'aide pour déterminer les autorisations, consultezDépannage de la gestion des identités et des accès Amazon Pinpoint.

Vous pouvez utiliser l'opération SendOtpMessages dans l'API Amazon Pinpoint pour envoyer un code OTP à un utilisateur de votre application. Lorsque vous utilisez cette API, Amazon Pinpoint génère un code aléatoire et l'envoie à votre utilisateur sous forme de SMS. Votre demande peut inclure les paramètres suivants :

• Channel : le canal de communication par lequel le code OTP est envoyé. Actuellement, seuls les SMS sont pris en charge. La seule valeur acceptable est donc SMS.

• BrandName : le nom de la marque, de l'entreprise ou du produit associé au code OTP. Ce nom peut contenir jusqu'à 20 caractères.

  Note

  Lorsqu'Amazon Pinpoint envoie le message OTP, le nom de la marque est automatiquement inséré dans le modèle de message suivant :

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

  Ainsi, si vous spécifiez ExampleCorp comme nom de marque et qu'Amazon Pinpoint génère un mot de passe à usage unique 123456, le message suivant est envoyé à votre utilisateur :

  This is your One Time Password: 123456 from ExampleCorp

• CodeLength : le nombre de chiffres qui figureront dans le code OTP envoyé au destinataire. Les codes OTP peuvent contenir entre cinq et huit chiffres inclus.

• ValidityPeriod : la durée, en minutes, pendant laquelle le code OTP sera valide. La période de validité peut être comprise entre 5 et 60 minutes incluses.

• AllowedAttempts : le nombre de fois où le destinataire peut tenter en vain de vérifier l'OTP. Si le nombre de tentatives dépasse cette valeur, l'OTP devient automatiquement non valide. Le nombre maximal de tentatives autorisées est de cinq.

• Language : la langue, au format IETF BCP-47, à utiliser lors de l'envoi du message. Les valeurs acceptables sont :

  • de-DE : allemand

  • en-GB : anglais (Royaume-Uni)

  • en-US : anglais (États-Unis)

  • es-419 : espagnol (Amérique latine)

  • es-ES : espagnol

  • fr-CA : français (Canada)

  • fr-FR : français

  • it-IT : italien

  • ja-JP : japonais

  • ko-KR : coréen

  • pt-BR : portugais (Brésil)

  • zh-CN : chinois (simplifié)

  • zh-TW : chinois (traditionnel)

• OriginationIdentity : l'identité d'origine (telle qu'un code long, un code court ou un ID d'expéditeur) utilisée pour envoyer le code OTP. Si vous utilisez un code long ou un numéro gratuit pour envoyer l'OTP, le numéro de téléphone doit être au format E.164.

• DestinationIdentity : le numéro de téléphone au format E.164 auquel le code OTP a été envoyé.

• ReferenceId : un ID de référence unique pour la demande. L'ID de référence correspond exactement à l'ID de référence que vous fournissez lorsque vous vérifiez l'OTP. L'ID de référence peut contenir entre 1 et 48 caractères inclus.

• EntityId : un ID d'entité enregistré auprès d'une agence de réglementation. Ce paramètre est actuellement utilisé uniquement lors de l'envoi de messages à des destinataires en Inde. Si vous n'envoyez pas de messages à des destinataires en Inde, vous pouvez omettre ce paramètre.

• TemplateId : un ID de modèle enregistré auprès d'une agence de réglementation. Ce paramètre est actuellement utilisé uniquement lors de l'envoi de messages à des destinataires en Inde. Si vous n'envoyez pas de messages à des destinataires en Inde, vous pouvez omettre ce paramètre.

  Note

  Pour plus d'informations sur les exigences relatives à l'envoi de messages à des destinataires en Inde, consultez le processus d'enregistrement de l'identifiant d'expéditeur indien dans le guide de l'utilisateur Amazon Pinpoint.

Pour vous assurer que votre compte Amazon Pinpoint est correctement configuré pour envoyer des messages OTP, vous pouvez utiliser le AWS CLI pour envoyer un message test. Pour plus d'informations à ce sujet AWS CLI, consultez le guide de AWS Command Line Interface l'utilisateur.

Pour envoyer un message OTP de test à l'aide du AWS CLI, exécutez la send-otp-messagecommande dans le 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

Dans la commande précédente, procédez comme suit :

• Remplacez 7353f53e6885409fa32d07cedexample par l'identifiant de votre application.

• Remplacez ExampleCorp par le nom de votre entreprise.

• Remplacez CodeLegth par 5 le nombre de chiffres qui figureront dans le code OTP envoyé au destinataire.

• Remplacez par 20 la durée, en minutes, pendant laquelle le code OTP sera valide. ValidityPeriod

• Remplacez AllowedAttempts par 5 le nombre de fois où le destinataire peut tenter sans succès de vérifier l'OTP.

• [phone]OriginationIdentityRemplacez-le par l'identité d'origine utilisée pour envoyer le code OTP.

• Remplacez DestinationIdentity par [phone] le numéro de téléphone auquel envoyer le code OTP.

• SampleReferenceIdReferenceIdRemplacez-le par un numéro de référence unique pour la demande.

Réponse de SendOtpMessage

Lorsque vous parvenez à envoyer un message OTP, vous recevez une réponse similaire à l'exemple suivant :

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