Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Impostazioni dei messaggi SMS per i bacini d'utenza di Amazon Cognito

Alcuni eventi di Amazon Cognito per il tuo bacino d'utenza potrebbero causare l'invio di SMS da parte di Amazon Cognito ai tuoi utenti. Ad esempio, se configuri il bacino d'utenza in modo da richiedere la verifica tramite telefono, Amazon Cognito invia un SMS quando un utente registra un nuovo account nell'app o quando reimposta la password. A seconda dell'azione che attiva il messaggio SMS, il messaggio può contenere un codice di verifica, una password temporanea o un messaggio di benvenuto.

Amazon Cognito utilizza Amazon Simple Notification Service (SNS) per l'invio di SMS. Se questa è la prima volta che invii un SMS tramite Amazon Cognito o Amazon SNS, sarai inserito in un ambiente sandbox in Amazon SNS. Nell'ambiente sandbox è possibile testare le applicazioni per gli SMS. Nella sandbox, i messaggi possono essere inviati solo a numeri di telefono verificati.

Amazon SNS addebita il costo dei messaggi SMS. Per ulteriori informazioni, consulta Prezzi di Amazon SNS.

Amazon Cognito invia messaggi SMS agli utenti con un codice che possono inserire. Nella tabella seguente vengono mostrati gli eventi che possono generare un messaggio SMS.

Opzioni relative ai messaggi

¹ Per messaggi SMS.

Prima impostazione degli SMS nei bacini d'utenza di Amazon Cognito

Amazon Cognito utilizza Amazon SNS per inviare messaggi SMS ai tuoi bacini d'utenza. Puoi utilizzare un Trigger Lambda del mittente di SMS personalizzato, se desideri servirti delle tue risorse per inviare messaggi SMS. La prima volta che configuri Amazon SNS per inviare messaggi di testo SMS in particolare Regione AWS, Amazon SNS ti inserisce Account AWS nella sandbox SMS per quella regione. Amazon SNS utilizza la sandbox per prevenire frodi e abusi e per soddisfare i requisiti di conformità. Quando ti Account AWS trovi nella sandbox, Amazon SNS impone alcune restrizioni. Ad esempio, puoi inviare SMS a un massimo di 10 numeri di telefono verificati con Amazon SNS. Mentre Account AWS resti nella sandbox, non utilizzare la configurazione di Amazon SNS per applicazioni in produzione. Quando sei nella sandbox, Amazon Cognito non può inviare messaggi ai numeri di telefono degli utenti.

Preparazione di un ruolo IAM che Amazon Cognito può utilizzare per inviare messaggi SMS con Amazon SNS

Quando invii un SMS dal tuo pool di utenti, Amazon Cognito assume un ruolo IAM nel tuo account. Amazon Cognito utilizza l'autorizzazione sns:Publish assegnata a quel ruolo per inviare SMS agli utenti. Nella console Amazon Cognito, puoi impostare una selezione di ruoli IAM dal menu Metodi di autenticazione del tuo pool di utenti, sotto SMS o effettuare questa selezione durante la procedura guidata di creazione del pool di utenti.

Il seguente esempio di policy di attendibilità dei ruoli IAM garantisce al pool di utenti di Amazon Cognito una capacità limitata di assumere un ruolo IAM. Amazon Cognito può assumere il ruolo solo quando soddisfa le seguenti condizioni:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service": "cognito-idp.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "sts:ExternalId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
                    "aws:SourceAccount": "111122223333"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:cognito-idp:us-west-2:111122223333:userpool/us-west-2_EXAMPLE"
                }
            }
        }
    ]
}

Puoi specificare un valore esatto per l'ARN del pool di utenti o un ARN con caratteri jolly nel valore della condizione aws:SourceArn. Cerca i tuoi pool ARNs di utenti nella AWS Management Console o con una DescribeUserPoolrichiesta API.

Per inviare messaggi SMS per l'autenticazione a più fattori, la tua policy di fiducia dei ruoli IAM deve avere una sts:ExternalId condizione. Il valore di questa condizione deve corrispondere alla ExternalId proprietà del pool SmsConfigurationdi utenti. Quando crei un ruolo IAM durante il processo di creazione del pool di utenti nella console Amazon Cognito, Amazon Cognito configura l'ID esterno per te nel ruolo e nelle impostazioni del pool di utenti. Questo non è vero quando utilizzi un ruolo IAM esistente.

È necessario aggiornare il ExternalId parametro del pool di utenti in una richiesta UpdateUserPoolAPI e aggiornare la policy di fiducia dei ruoli IAM con una sts:externalId condizione con lo stesso valore. Per informazioni su come utilizzare l'API per aggiornare un pool di utenti in modo da preservare la configurazione originale, consultaAggiornamento della configurazione del pool di utenti e del client dell'app.

Per ulteriori informazioni sui ruoli IAM e le policy di attendibilità, consulta Termini e concetti dei ruoli nella Guida per l'utente di AWS Identity and Access Management .

Scegli l'opzione Regione AWS per i messaggi SMS di Amazon SNS

In alcuni Regioni AWS, puoi scegliere la regione che contiene le risorse Amazon SNS che desideri utilizzare per i messaggi SMS di Amazon Cognito. Regione AWS Ovunque sia disponibile Amazon Cognito, ad eccezione dell'Asia Pacifico (Seoul), puoi utilizzare le risorse Amazon SNS nel luogo in Regione AWS cui hai creato il tuo pool di utenti. Per rendere l'invio di messaggi SMS più veloce e affidabile quando puoi scegliere tra più regioni, usa le risorse Amazon SNS nella stessa regione del tuo bacino d'utenza.

Scegli una regione per le risorse SMS nel passaggio Configure message delivery (Configura invio di messaggi) della procedura guidata per la configurazione del nuovo bacino d'utenza. Puoi anche scegliere Modifica sotto SMS nel menu Metodi di autenticazione di un pool di utenti esistente.

Al momento del lancio, per alcuni Regioni AWS, Amazon Cognito inviava messaggi SMS con risorse Amazon SNS in una regione alternativa. Per impostare la tua regione preferita, usa il SnsRegion parametro dell'SmsConfigurationTypeoggetto per il tuo pool di utenti. Quando crei a livello di programmazione una risorsa del bacino d'utenza di Amazon Cognito in una Regione di Amazon Cognito inclusa nella tabella seguente e non fornisci un parametro SnsRegion, il bacino d'utenza può inviare messaggi SMS utilizzando le risorse Amazon SNS di una Regione di Amazon SNS legacy.

I pool di utenti di Amazon Cognito in Asia Pacifico (Seoul) Regione AWS devono utilizzare la configurazione Amazon SNS nella regione Asia Pacifico (Tokyo).

La quota di spesa di Amazon SNS è impostata su 1,00 USD al mese per tutti i nuovi account. Potresti aver aumentato il limite di spesa in un account Regione AWS che utilizzi con Amazon Cognito. Prima di modificare Regione AWS i messaggi SMS di Amazon SNS, apri una richiesta di aumento della quota nel AWS Support Center per aumentare il limite nella nuova regione. Per ulteriori informazioni, consulta Richiesta di aumento della quota di spesa mensile per l'invio di SMS per Amazon SNS nella Guida per gli sviluppatori di Amazon Simple Notification Service.

Puoi inviare messaggi SMS per qualsiasi Regione di Amazon Cognito inclusa nella tabella seguente utilizzando le risorse Amazon SNS della Regione di Amazon SNS corrispondente.

Ottenere un'identità di origine per l'invio di messaggi SMS a numeri di telefono USA

Se intendi inviare messaggi SMS a numeri di telefono negli Stati Uniti, devi ottenere un'identità di origine, indipendentemente dalla creazione di un ambiente di test sandbox SMS o di produzione.

A partire dal 1° giugno 2021, gli operatori statunitensi richiedono agli utenti di fornire un'identità di origine per inviare messaggi a numeri di telefono degli Stati Uniti. Se non disponi ancora di un'identità di origine, devi richiederne una. Per informazioni su come ottenere un'identità di origine, consulta Richiesta di un numero nella Guida per l'utente di Amazon Pinpoint.

Se operi nei seguenti settori Regioni AWS, devi aprire un Supporto ticket per ottenere un'identità di origine. Per le istruzioni, consulta Richiesta di supporto per la messaggistica SMS nella Guida per gli sviluppatori di Amazon Simple Notification Service.

Quando hai più di un'identità di origine nella stessa identità Regione AWS, Amazon SNS sceglie un tipo di identità di origine nel seguente ordine di priorità: codice breve, 10DLC, numero verde. Non puoi modificare questa priorità. Per ulteriori dettagli, consulta la pagina Amazon SNS FAQs.

Verifica di trovarti nella sandbox SMS

Utilizza la procedura seguente per confermare se ti trovi nella sandbox SMS. Ripeti l'operazione per ogni Regione AWS area in cui hai pool di utenti Amazon Cognito di produzione.

Sposta il tuo account all'esterno della sandbox di Amazon SNS

Se stai eseguendo il test dell’app e devi solo inviare messaggi SMS ai numeri di telefono che gli amministratori possono verificare, ignora questo passaggio.

Per utilizzare la tua app in produzione, sposta il tuo account dall'ambiente della sandbox SMS a quello della produzione. Dopo aver configurato un'identità di origine Regione AWS che contiene le risorse Amazon SNS che desideri vengano utilizzate da Amazon Cognito, puoi verificare i numeri di telefono degli Stati Uniti mentre i Account AWS tuoi rimangono nella sandbox SMS. Quando il tuo ambiente Amazon SNS è in produzione, non devi verificare i numeri di telefono utente in Amazon SNS per inviare messaggi SMS agli utenti.

Per le istruzioni dettagliate, consulta Uscita dalla sandbox SMS nella Guida per gli sviluppatori di Amazon Simple Notification Service.

Verifica i numeri di telefono per Amazon Cognito in Amazon SNS

Se hai spostato il tuo account al di fuori dell’ambiente di sperimentazione (sandbox) SMS, ignora questo passaggio.

Quando sei nella sandbox SMS, puoi inviare messaggi a qualsiasi numero di telefono verificato con Amazon SNS.

Per verificare un numero di telefono, procedi come segue:

Per le istruzioni dettagliate, consulta Aggiunta e verifica dei numeri di telefono nella sandbox SMSnella Guida per gli sviluppatori di Amazon Simple Notification Service.

Completamento della configurazione del pool di utenti in Amazon Cognito

Torna alla scheda del browser in cui stavi creando o modificando il pool di utenti. Completare la procedura. Dopo aver aggiunto correttamente la configurazione dei messaggi SMS al pool di utenti, Amazon Cognito invia un messaggio di prova a un numero di telefono interno per verificare che la configurazione funzioni. Amazon SNS addebita il costo di ogni messaggio SMS di prova.