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 può inviare messaggi SMS con una delle seguenti configurazioni:

Un pool di utenti utilizza una configurazione SMS alla volta. Amazon SNS e le configurazioni AWS End User Messaging SMS dirette si escludono a vicenda. Quando imposti una configurazione, Amazon Cognito cancella l'altra. Questo vale per e SetUserPoolMfaConfigper CreateUserPoolUpdateUserPoolle operazioni.

Amazon SNS SMS è disponibile nelle versioni Regioni AWS elencate in. Configurazione della regione del percorso Amazon SNS Per inviare messaggi SMS da un pool di utenti a qualsiasi altro Regione AWS, usa AWS End User Messaging SMS direttamente.

Se invii un messaggio di testo tramite Amazon Cognito per la prima volta, ti AWS End User Messaging SMS colloca in un ambiente sandbox. Nell'ambiente sandbox è possibile testare le applicazioni per gli SMS. Nella sandbox, puoi inviare messaggi a un numero limitato di numeri di telefono di destinazione verificati se disponi di un'identità di origine o simulare l'invio di messaggi in caso contrario.

AWS End User Messaging SMS costi per i messaggi di testo SMS. Per ulteriori informazioni, consultare Prezzi di AWS End User Messaging SMS.

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

¹ Richiede un piano di funzionalità Essentials o superiore e la configurazione e-mail di Amazon SES.

² Per SMS e messaggi e-mail.

³ È possibile personalizzare il modello di messaggio MFA solo quando l'MFA è obbligatoria o facoltativa nel pool di utenti. Quando la MFA è inattiva, Amazon Cognito invia password monouso con il modello predefinito.

AWS End User Messaging SMS addebiti per i messaggi SMS. Per ulteriori informazioni, consultare Prezzi di AWS End User Messaging SMS.

Per ulteriori informazioni su MFA, consulta MFA per SMS e messaggi e-mail.

Amazon Cognito potrebbe impedire la consegna di messaggi e-mail o SMS aggiuntivi verso un'unica destinazione in un breve periodo di tempo. Se ritieni che il tuo pool di utenti sia interessato, configura e rivedi i log per individuare eventuali errori di recapito dei messaggi, quindi contatta il team del tuo account.

Scelta tra Amazon SNS e AWS End User Messaging SMS

I pool di utenti di Amazon Cognito possono inviare messaggi SMS attraverso due percorsi: Amazon AWS End User Messaging SMS SNS o direttamente. Per i nuovi pool di utenti, usa il AWS End User Messaging SMS percorso diretto. Amazon SNS SMS è disponibile solo in un set fisso di. Regioni AWS Il AWS End User Messaging SMS percorso diretto supporta regioni aggiuntive ed espone funzionalità che il percorso Amazon SNS non offre. Entrambi i percorsi consentono di recapitare i messaggi. AWS End User Messaging SMS

La tabella seguente confronta i due percorsi di configurazione SMS.

Configurazione SMS nell'API dei pool di utenti di Amazon Cognito

L'SmsConfigurationTypeoggetto nell'API dei pool di utenti di Amazon Cognito contiene la configurazione SMS per il tuo pool di utenti. Questo oggetto ha i seguenti percorsi di configurazione:

Per ulteriori informazioni, consulta SmsConfigurationTypeAmazon Cognito User Pools API Reference.

Best practice

A causa del volume di traffico SMS indesiderato in tutto il mondo, alcuni governi impongono barriere tra mittenti e destinatari dei messaggi SMS. Quando utilizzi i messaggi SMS per l'autenticazione MFA e gli aggiornamenti utente, devi adottare misure aggiuntive per assicurarti che i messaggi vengano recapitati. È inoltre necessario monitorare SMS-message-related le normative nei paesi in cui risiedono gli utenti e mantenere aggiornata la configurazione dei messaggi SMS. Per ulteriori informazioni, consulta le funzionalità e le limitazioni nazionali relative agli SMS e MMS nella Guida per l'AWS End User Messaging SMS utente.

L'uso di messaggi SMS per autenticare e verificare gli utenti non è una best practice di sicurezza. I numeri di telefono possono cambiare proprietario e potrebbero non rappresentare in modo affidabile un fattore di autenticazione MFA elementi che possiedi per gli utenti. Implementa invece l'autenticazione MFA TOTP nell'app o con il gestore dell'identità digitale (IdP) di terze parti. Puoi anche creare fattori di autenticazione personalizzati aggiuntivi con Trigger Lambda di richieste di autenticazione personalizzate.

Consulta i seguenti collegamenti per informazioni sulla protezione dell'architettura di recapito dei messaggi SMS.

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

Amazon Cognito utilizza Amazon SNS (e AWS End User Messaging SMS indirettamente) AWS End User Messaging SMS o direttamente per inviare messaggi SMS dai tuoi pool di utenti. 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 i messaggi di testo SMS in una particolare regione Regione AWS, ti AWS End User Messaging SMS inserisce Account AWS nella sandbox SMS per quella regione. AWS End User Messaging SMS utilizza la sandbox per prevenire frodi e abusi e per soddisfare i requisiti di conformità. Quando sei Account AWS nella sandbox, AWS End User Messaging SMS impone alcune restrizioni. Ad esempio, puoi inviare messaggi di testo a un massimo di 10 numeri di destinazione verificati se disponi di un'identità di origine oppure puoi simulare l'invio di messaggi senza un'identità di origine. Mentre Account AWS rimanete nella sandbox, non inviate messaggi SMS in fase di produzione. Quando sei nella sandbox, Amazon Cognito non può inviare messaggi ai numeri di telefono degli utenti.

Prepara un ruolo IAM che Amazon Cognito possa utilizzare per inviare messaggi SMS AWS End User Messaging SMS

Quando invii un SMS dal tuo pool di utenti, Amazon Cognito assume un ruolo IAM nel tuo account. Le autorizzazioni richieste dal ruolo dipendono dal percorso di configurazione SMS scelto:

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:

Queste condizioni relative alla politica di fiducia si applicano sia al percorso Amazon SNS che al percorso AWS End User Messaging SMS diretto.

JSON

{
    "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 gli ARN dei tuoi pool di utenti in Console di gestione AWS o con una richiesta DescribeUserPoolAPI.

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 .

Per configurare AWS End User Messaging SMS SMS diretti per un pool di utenti

Utilizza la seguente procedura per configurare il tuo pool di utenti per l'invio diretto di messaggi SMS tramite AWS End User Messaging SMS. Questa configurazione utilizza l'EumsSmsoggetto in SmsConfigurationType.

Autorizzazioni IAM per AWS End User Messaging SMS SMS diretti

Il ruolo di IAM in CallerArn richiede una politica di fiducia che consenta al responsabile del cognito-idp.amazonaws.com servizio di assumerlo. Utilizza la stessa struttura di policy di fiducia del percorso Amazon SNS (vediPrepara un ruolo IAM che Amazon Cognito possa utilizzare per inviare messaggi SMS AWS End User Messaging SMS). Il ruolo richiede anche una politica di autorizzazioni che conceda un sms-voice:SendTextMessage ARN specifico all'identità di origine (vedere la procedura di configurazione in). Per configurare AWS End User Messaging SMS SMS diretti per un pool di utenti

Seleziona Regione AWS per i messaggi SMS

Configurazione della regione del percorso 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 in 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).

Amazon SNS (tramite AWS End User Messaging SMS) imposta la quota di spesa per tutti i nuovi account a 1,00 USD (USD) al mese. Potresti aver aumentato il limite di spesa in una 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 Passare dalla sandbox AWS End User Messaging SMS MMS and Voice alla produzione nella Guida per l'AWS End User Messaging SMS utente.

Puoi inviare messaggi SMS per qualsiasi regione di Amazon Cognito nella tabella seguente con AWS End User Messaging SMS risorse nella regione di messaggi SMS corrispondente.

AWS End User Messaging SMS percorso diretto: configurazione della regione

AWS End User Messaging SMS è disponibile in un proprio set di Regioni AWS, che può differire dalle regioni in cui sono disponibili i pool di utenti Amazon SNS o Amazon Cognito. Per l'elenco aggiornato, consulta Regioni e paesi supportati nella Guida per l'AWS End User Messaging SMS utente.

Il Region campo dell'EumsSmsoggetto in SmsConfigurationTypeimposta la Regione AWS destinazione delle chiamate di Amazon Cognito. AWS End User Messaging SMS AWS End User Messaging SMS deve essere disponibile nella regione del tuo pool di utenti. Ometti Region e AWS End User Messaging SMS utilizza Amazon Cognito nella regione del tuo pool di utenti o Region imposta esplicitamente la regione del tuo pool di utenti. Amazon Cognito rifiuta qualsiasi altro valore.

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.

I corrieri statunitensi richiedono un'identità di origine per inviare messaggi ai numeri di telefono statunitensi. Se non disponi ancora di un'identità di origine, devi richiederne una. Per informazioni su come ottenere un'identità di origine, consulta Richiedere un numero di telefono nella Guida per l'AWS End User Messaging SMS utente.

Quando hai più di un'identità di origine nella stessa identità Regione AWS, AWS End User Messaging SMS scegli un tipo di identità di origine nel seguente ordine di priorità: codice breve, 10DLC, numero verde. Non puoi modificare questa priorità. Per ulteriori informazioni, consulta FAQ AWS End User Messaging SMS.

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 fuori dalla sandbox

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 AWS End User Messaging SMS risorse 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 l'ambiente è in produzione, non è necessario verificare i numeri di telefono degli utenti prima di inviare loro messaggi SMS.

Puoi creare una richiesta per uscire dalla sandbox dalla AWS End User Messaging SMS console o dalla console Amazon SNS. Per istruzioni dettagliate, consulta Passare dalla sandbox SMS nella Guida per l'AWS End User Messaging SMS utente.

Usa i numeri del simulatore o i numeri di telefono verificati con AWS End User Messaging SMS

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

Se ti trovi nella sandbox ma hai impostato un numero di origine, puoi inviare messaggi a numeri di destinazione verificati. Per configurare destinazioni verificate, consulta Aggiungere un numero di telefono di destinazione verificato nella Guida per l'AWS End User Messaging SMS utente.

Puoi anche inviare messaggi con mittenti e destinazioni simulati. I messaggi del simulatore producono registri ma non vengono inviati tramite la rete dell'operatore. Dal menu Scelte rapide, seleziona Verifica l'invio di SMS con il simulatore SMS. Per ulteriori informazioni, consulta i numeri di telefono del simulatore nella Guida per l'AWS End User Messaging SMS utente.

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 con successo la configurazione SMS al tuo pool di utenti, Amazon Cognito invia un messaggio di prova a un numero di telefono interno per verificare che la configurazione funzioni. AWS End User Messaging SMS costi per ogni messaggio SMS di prova.