Configurazione delle notifiche Amazon SNS per Amazon SES - Amazon Simple Email Service
PrerequisitiConfigurazione di notifiche tramite la console Amazon SESConfigurazione di notifiche tramite l'API Amazon SESRisoluzione dei problemi relativi alle notifiche di feedback

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).

È possibile configurare le notifiche nella console Amazon SES oppure usando l'API Amazon SES.

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 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:

    {
  "Version": "2012-10-17",
  "Id": "notification-policy",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "ses.amazonaws.com"
      },
      "Action": "sns:Publish",
      "Resource": "arn:aws:sns:topic_region: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:

    • Sostituisci topic_region con la regione AWS in cui hai creato l'argomento SNS.

    • Sostituisci 111122223333 con l'ID del tuo account AWS.

    • Sostituisci topic_name con il nome del tuo argomento SNS.

    • Sostituisci identity_name con l'identità verificata (indirizzo e-mail o dominio) a cui stai sottoscrivendo l'argomento SNS.

  2. 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 nella Guida per gli sviluppatori di Amazon Simple Notification Service.

  3. (Opzionale) Se l'argomento Amazon SNS utilizza AWS Key Management Service (AWS KMS) per la crittografia lato server, devi aggiungere autorizzazioni alla policy delle chiavi AWS KMS. Puoi aggiungere autorizzazioni collegando la policy seguente alla policy delle chiavi AWS KMS:

    {
    "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. Aprire la console Amazon SES all'indirizzo https://console.aws.amazon.com/ses/.

  2. Nel pannello di navigazione, in Configuration (Configurazione), scegli Verified identities (Identità verificate).

  3. 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.

  4. Nella schermata dei dettagli dell'identità verificata selezionata, scegli la scheda Notifications (Notifiche) e seleziona Edit (Modifica) nel container Feedback notifications (Notifiche di feedback).

  5. 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.)

    Importante

    Gli argomenti Amazon SNS utilizzati per le notifiche di mancato recapito, reclamo e consegna devono trovarsi nella stessa Regione AWS che utilizza 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 nella Guida per gli sviluppatori di Amazon Simple Notification Service.

  6. (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.

  7. Scegliere Save changes (Salva modifiche). Potrebbero essere necessari alcuni minuti perché le modifiche apportate alle impostazioni di notifica diventino effettive.

  8. (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 JSON (JavaScript Object Notation) e seguono la struttura descritta in Contenuti delle notifiche.

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.

Nota

Se un tentativo di pubblicazione nell'argomento Amazon SNS non riesce perché l'argomento è stato eliminato o l'Account AWS non dispone più delle autorizzazioni per la pubblicazione, Amazon SES rimuove la configurazione di tale argomento se è stato configurato per mancati recapiti o reclami (non le 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:

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.

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 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. In caso affermativo, devi modificare la policy per la chiave AWS KMS. Consulta Prerequisiti per una policy di esempio.