Genera password monouso (OTPs) con Amazon Pinpoint

Amazon Pinpoint include una funzionalità di gestione delle password monouso (OTP) che puoi utilizzare per generare nuove password monouso e inviarle ai destinatari come messaggi SMS.

Importante

Per utilizzare questa funzionalità, il tuo account deve avere accesso alla produzione e un'identità di origine attiva. Per ulteriori informazioni, consulta Informazioni sulla sandbox SMS/MMS e Voice e Richiedi un numero di telefono nella Guida per l'utente di SMS di messaggistica per l'utente AWS finale.

In alcuni paesi e aree geografiche, è necessario ottenere un numero di telefono o un ID di origine dedicato prima di poter inviare messaggi SMS. Ad esempio, quando invii messaggi a destinatari negli Stati Uniti, devi disporre di un numero verde dedicato, un numero 10DLC o un codice breve. Quando invii messaggi a destinatari in India, devi disporre di un ID mittente registrato, che include un ID entità principale (PEID) e un ID modello. Questi requisiti continuano a essere valido quando si utilizza la funzionalità OTP.

Per utilizzare questa funzionalità, sono necessarie le autorizzazioni per inviare e verificare i messaggi OTP; consulta Codici OTP (One-Time Password). Se hai bisogno di aiuto per determinare le autorizzazioni, consulta. Risoluzione dei problemi relativi alla gestione di identità e accessi di Amazon Pinpoint

Puoi utilizzare l'operazione SendOtpMessages nell'API Amazon Pinpoint per inviare un codice OTP (One-Time Password) a un utente della tua applicazione. Quando usi questa API, Amazon Pinpoint genera un codice casuale e lo invia all'utente come messaggio SMS. La tua richiesta può includere i seguenti parametri:

• Channel: canale di comunicazione attraverso il quale viene inviato il codice OTP. Attualmente sono supportati solo i messaggi SMS, quindi l'unico valore accettabile è SMS.

• BrandName: nome del marchio, dell'azienda o del prodotto associato al codice OTP. Il nome può contenere un massimo di 20 caratteri.

  Nota

  Quando Amazon Pinpoint invia il messaggio OTP, il nome del marchio viene inserito automaticamente nel seguente modello di messaggio:

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

  Quindi, se specifichi ExampleCorp come nome del marchio e Amazon Pinpoint genera una password monouso di 123456, invia il seguente messaggio all'utente:

  This is your One Time Password: 123456 from ExampleCorp

• CodeLength: numero di cifre contenute nel codice OTP inviato al destinatario. I codici OTP possono contenere da 5 a 8 cifre.

• ValidityPeriod: periodo di validità, espresso in minuti, del codice OTP. Il periodo di validità può essere compreso tra 5 e 60 minuti.

• AllowedAttempts: numero di volte in cui il destinatario può tentare senza successo di verificare il codice OTP. Se il numero di tentativi supera questo valore, il codice OTP diventa automaticamente non valido. Il numero massimo di tentativi consentiti è 5.

• Language: lingua, in formato IETF BCP-47, da utilizzare per l'invio del messaggio. I valori accettabili sono:

  • de-DE: tedesco

  • en-GB: inglese (Regno Unito)

  • en-US: inglese (Stati Uniti)

  • es-419: spagnolo (America Latina)

  • es-ES: spagnolo

  • fr-CA: francese (Canada)

  • fr-FR: francese

  • it-IT: italiano

  • ja-JP: giapponese

  • ko-KR: coreano

  • pt-BR: portoghese (Brasile)

  • zh-CN: cinese (semplificato)

  • zh-TW: cinese (tradizionale)

• OriginationIdentity: identità di origine (ad esempio codice lungo, codice breve o ID mittente) utilizzata per inviare il codice OTP. Se utilizzi un codice lungo o un numero verde per inviare il codice OTP (One-Time Password), il numero di telefono deve essere in formato E.164.

• DestinationIdentity: numero di telefono, nel formato E.164, al quale è stato inviato il codice OTP.

• ReferenceId: ID di riferimento univoco per la richiesta. L'ID di riferimento corrisponde esattamente all'ID di riferimento fornito al momento della verifica del codice OTP. L'ID di riferimento può contenere da 1 a 48 caratteri.

• EntityId: ID dell'entità registrato presso un ente regolatore. Questo parametro viene attualmente utilizzato solo per l'invio di messaggi ai destinatari in India. Se non effettui invii a destinatari in India, puoi omettere questo parametro.

• TemplateId: ID del modello registrato presso un ente regolatore. Questo parametro viene attualmente utilizzato solo per l'invio di messaggi ai destinatari in India. Se non effettui invii a destinatari in India, puoi omettere questo parametro.

  Nota

  Per ulteriori informazioni sui requisiti per l'invio di messaggi a destinatari in India, consulta la procedura di registrazione dell'ID mittente indiano nella Guida per l'utente di Amazon Pinpoint.

Per assicurarti che il tuo account Amazon Pinpoint sia configurato correttamente per inviare messaggi OTP, puoi utilizzare l'opzione AWS CLI per inviare un messaggio di prova. Per ulteriori informazioni su AWS CLI, consulta la Guida per l'AWS Command Line Interface utente.

Per inviare un messaggio OTP di prova utilizzando il AWS CLI, esegui il send-otp-messagecomando nel terminale:

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

Nel comando precedente, procedi come segue.

• 7353f53e6885409fa32d07cedexampleSostituiscilo con l'ID dell'applicazione.

• Sostituiscilo ExampleCorp con il nome della tua azienda.

• 5Sostituiscilo CodeLegth con il numero di cifre che sarà contenuto nel codice OTP che verrà inviato al destinatario.

• Sostituisci 20 ValidityPeriod con il periodo di validità, in minuti, entro il quale il codice OTP sarà valido.

• Sostituisci AllowedAttempts con il numero di volte 5 in cui il destinatario può tentare senza successo di verificare l'OTP.

• [phone]OriginationIdentitySostituiscilo con l'identità di origine utilizzata per inviare il codice OTP.

• [phone]DestinationIdentitySostituiscilo con il numero di telefono a cui inviare il codice OTP.

• SampleReferenceIdReferenceIdSostituiscilo con un ID di riferimento univoco per la richiesta.

Risposta SendOtpMessage

Quando invii correttamente un messaggio OTP, viene visualizzata una risposta analoga all'esempio seguente:

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