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à. # Configurazione delle notifiche Amazon SNS per Amazon SES Amazon SES può notificarti i tuoi mancati recapiti, i tuoi reclami e i messaggi recapitati tramite [Amazon Simple Notification Service (Amazon SNS)](https://aws.amazon.com/sns). È possibile configurare le notifiche nella console Amazon SES oppure usando l'API Amazon SES. **Topics** + [Prerequisiti](#configure-feedback-notifications-prerequisites) + [Configurazione di notifiche tramite la console Amazon SES](#configure-feedback-notifications-console) + [Configurazione di notifiche tramite l'API Amazon SES](#configure-feedback-notifications-api) + [Risoluzione dei problemi relativi alle notifiche di feedback](#configure-feedback-notifications-troubleshooting) ## Prerequisiti Completa le fasi seguenti prima di configurare le notifiche Amazon SNS in Amazon SES: 1. Crea un argomento in Amazon SNS. Per ulteriori informazioni, consulta la pagina [Creazione di un argomento](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*. **Importante** Quando crei il tuo argomento utilizzando Amazon SNS, per **Type** (Tipo), scegli solo **Standard**. (SES non supporta argomenti di tipo FIFO). Sia che crei un nuovo argomento SNS o ne selezioni uno esistente, è necessario concedere l'accesso a SES per pubblicare le notifiche sull'argomento. Per concedere ad Amazon SES l'autorizzazione a pubblicare notifiche nell'argomento, nella schermata **Edit topic** (Modifica argomento) della console SNS, espandi **Access policy** (Policy di accesso) e in **JSON editor** (Editor JSON), aggiungi la policy di autorizzazione che segue: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "notification-policy", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:{{us-east-1}}:{{111122223333}}:{{topic_name}}", "Condition": { "StringEquals": { "AWS:SourceAccount": "{{111122223333}}", "AWS:SourceArn": "arn:aws:ses:{{topic_region}}:{{111122223333}}:identity/{{identity_name}}" } } } ] } ``` ------ Nel precedente esempio di policy, apporta le modifiche seguenti: + {{topic\_region}}Sostituiscilo con la AWS regione in cui hai creato l'argomento SNS. + Sostituisci {{111122223333}} con il tuo ID account AWS . + {{topic\_name}}Sostituiscilo con il nome del tuo argomento SNS. + Sostituisci {{identity\_name}} con l'identità verificata (indirizzo email o dominio) con cui ti stai abbonando all'argomento SNS. 1. Effettua la sottoscrizione di almeno un endpoint per l'argomento. Se, ad esempio, desideri ricevere notifiche tramite messaggio di testo, effettua la sottoscrizione di un endpoint SMS, ovvero un numero di telefono cellulare, per l'argomento. Per ricevere le notifiche tramite e-mail, effettua la sottoscrizione di un endpoint e-mail (un indirizzo e-mail) per l'argomento. Per ulteriori informazioni, consulta [Nozioni di base](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*. 1. (Facoltativo) Se il tuo argomento Amazon SNS utilizza AWS Key Management Service (AWS KMS) per la crittografia lato server, devi aggiungere le autorizzazioni alla policy chiave. AWS KMS Puoi aggiungere autorizzazioni allegando la seguente politica alla politica chiave: AWS KMS ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowSESToUseKMSKey", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` ------ ## Configurazione di notifiche tramite la console Amazon SES **Configurazione delle notifiche tramite la console Amazon SES** 1. Apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configurazione**, scegli **Identità.** 1. Nel container **Identities (Identità)**, seleziona l'identità verificata per cui desideri ricevere notifiche di feedback in caso di mancato recapito, reclamo o consegna dei messaggi inviati. **Importante** Le impostazioni di notifica dei domini verificati si applicano a tutte le e-mail inviate dagli indirizzi in tale dominio *ad eccezione* degli indirizzi e-mail che sono anch'essi verificati. 1. Nella schermata dei dettagli dell'identità verificata selezionata, scegli la scheda **Notifications (Notifiche)** e seleziona **Edit (Modifica)** nel container **Feedback notifications (Notifiche di feedback)**. 1. Espandi la casella dell'elenco di argomenti SNS di ogni tipo di feedback per cui desideri ricevere notifiche e seleziona un argomento SNS di cui sei proprietario, **No SNS topic (Nessun argomento SNS)** o **SNS topic you don't own (Argomento SNS che non possiedi)**. 1. Se scegli **SNS topic you don't own (Argomento SNS che non possiedi)**, verrà visualizzato il campo **SNS topic ARN (ARN dell'argomento SNS)**, in cui devi inserire l'ARN dell'argomento SNS condiviso con te dal mittente delegato. Solo il mittente delegato riceverà queste notifiche, perché è proprietario dell'argomento SNS. Per ulteriori informazioni sull'invio di delegati, consulta [Panoramica dell'autorizzazione di invio](sending-authorization-overview.md).) **Importante** Gli argomenti di Amazon SNS utilizzati per le notifiche di respingimento, reclamo e consegna devono essere gli stessi in Regione AWS cui utilizzi Amazon SES. Inoltre, è necessario sottoscrivere uno o più endpoint all'argomento per ricevere le notifiche. Se, ad esempio, desideri ricevere le notifiche a un indirizzo e-mail, devi effettuare la sottoscrizione di un endpoint e-mail all'argomento. Per ulteriori informazioni, consulta [Nozioni di base](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*. 1. (Facoltativo) Se desideri che la notifica dell'argomento includa le intestazioni dall'e-mail originale, seleziona la casella **Include original email headers (Includi intestazioni e-mail originali)** direttamente sotto il nome dell'argomento SNS di ogni tipo di feedback. Questa opzione è disponibile solo se hai assegnato un argomento Amazon SNS al tipo di notifica associato. Per informazioni sui contenuti delle intestazioni e-mail originali, consulta l'oggetto `mail` in [Contenuti delle notifiche](notification-contents.md). 1. Scegli **Save changes** (Salva modifiche). Potrebbero essere necessari alcuni minuti perché le modifiche apportate alle impostazioni di notifica diventino effettive. 1. (Facoltativo) Se scegli di abilitare le notifiche dell'argomento Amazon SNS sia per i mancati recapiti che per i reclami, puoi disabilitare completamente le notifiche e-mail in modo da non riceverle tramite entrambi i canali. Per disabilitare le notifiche e-mail per mancati recapiti e reclami, nella scheda **Notifications (Notifiche)** della schermata dei dettagli dell'identità verificata, vai al container **Email Feedback Forwarding (Inoltro feedback e-mail)**, scegli **Edit (Modifica)**, deseleziona la casella **Enabled (Abilitato)** e scegli **Save changes (Salva modifiche)**. Dopo aver configurato le impostazioni, inizierai a ricevere le notifiche di mancato recapito, reclamo e/o consegna per l'argomento o gli argomenti Amazon SNS. Queste notifiche sono in formato JavaScript Object Notation (JSON) e seguono la struttura descritta in. [Contenuti delle notifiche](notification-contents.md) Per le notifiche di mancato recapito, reclamo e consegna ti verranno addebitate le tariffe standard di Amazon SNS. Per ulteriori informazioni, consulta la pagina dei [prezzi di Amazon SNS](https://aws.amazon.com/sns/pricing). **Nota** Se un tentativo di pubblicazione sul tuo argomento Amazon SNS fallisce perché l'argomento è stato eliminato o Account AWS non disponi più delle autorizzazioni per pubblicarlo, Amazon SES rimuove la configurazione per quell'argomento se è stato configurato per rimbalzi o reclami (non consegne: per le notifiche di consegna, SES non eliminerà l'impostazione di configurazione dell'argomento SNS). Inoltre, Amazon SES abilita nuovamente le notifiche e-mail di mancato recapito e reclamo per l'identità e riceverai una notifica della modifica tramite e-mail. Se sono configurate più identità per utilizzare l'argomento, la configurazione dell'argomento per ogni identità viene modificata quando in ogni identità si verifica un errore di pubblicazione nell'argomento. ## Configurazione di notifiche tramite l'API Amazon SES È anche possibile configurare le notifiche di mancato recapito, reclamo e consegna usando l'API Amazon SES. Per configurare le notifiche, usa le operazioni seguenti: + [SetIdentityNotificationTopic](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityNotificationTopic.html) + [SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html) + [GetIdentityNotificationAttributes](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityNotificationAttributes.html) + [SetIdentityHeadersInNotificationsEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityHeadersInNotificationsEnabled.html) Puoi usare queste operazioni dell'API per scrivere un'applicazione front-end personalizzata per le notifiche. Per una descrizione completa delle operazioni dell'API correlate alla verifica del dominio, consulta la [Documentazione di riferimento dell'API Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/). ## Risoluzione dei problemi relativi alle notifiche di feedback **Nessuna notifica ricevuta** Se non ricevi notifiche, assicurati di aver sottoscritto un endpoint all'argomento a cui vengono inviate le notifiche. Quando effettui la sottoscrizione di un endpoint e-mail a un argomento, ricevi un’e-mail con la conferma di sottoscrizione. Devi confermare la sottoscrizione prima di iniziare a ricevere le notifiche e-mail. Per ulteriori informazioni, consulta [Nozioni di base](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*. **Errore `InvalidParameterValue` durante la scelta di un argomento** Se ricevi un errore che indica `InvalidParameterValue`, controlla l'argomento Amazon SNS per vedere se è crittografato utilizzando AWS KMS. Se lo è, devi modificare la politica della chiave. AWS KMS Consulta [Prerequisiti](#configure-feedback-notifications-prerequisites) per una policy di esempio.