Contenuti delle notifiche per la ricezione di e-mail Amazon SES

Tutte le notifiche per la ricezione di e-mail vengono pubblicate negli argomenti Amazon Simple Notification Service (Amazon SNS) in formato JSON (JavaScript Object Notation).

Per degli esempi di notifiche, consulta Esempi di notifiche.

Indice

• Oggetto JSON di primo livello
• Oggetto receipt
  • Oggetto action
  • Oggetto dkimVerdict
  • Oggetto dmarcVerdict
  • Oggetto spamVerdict
  • Oggetto spfVerdict
  • Oggetto virusVerdict
• oggetto mail
  • Oggetto commonHeaders

Oggetto JSON di primo livello

L'oggetto JSON di primo livello contiene i campi seguenti.

Nome campo	Descrizione
notificationType	Tipo di notifica. Per questo tipo di notifica, il valore è sempre Received.
receipt	Oggetto che contiene informazioni sulla consegna dell'e-mail.
mail	Oggetto che contiene informazioni sull'e-mail a cui la notifica è associata.
content	Stringa che contiene l'e-mail in formato RAW non modificato, in genere il formato Multipurpose Internet Mail Extensions (MIME). Per ulteriori informazioni sul formato MIME, consulta RFC 2045. Nota Questo campo è presente solo se la notifica è stata attivata da un'operazione SNS. Le notifiche attivate da tutte le altre operazioni non contengono questo campo.

Oggetto receipt

L'oggetto receipt dispone dei campi seguenti.

Nome campo	Descrizione
action	Oggetto che incapsula informazioni sull'operazione eseguita. Per un elenco di possibili valori, consulta Oggetto action.
dkimVerdict	Oggetto che indica se il controllo DomainKeys Identified Mail (DKIM) è stato superato. Per un elenco di possibili valori, consulta Oggetto dkimVerdict.
dmarcPolicy	Indica le impostazioni Domain-based Message Authentication, Reporting & Conformance (DMARC) per il dominio di invio. Il campo appare solo se il messaggio fallisce l'autenticazione DMARC. I valori possibili per questo campo sono: none: il proprietario del dominio di invio richiede che non vengano eseguite operazioni specifiche sui messaggi che non superano l'autenticazione DMARC. quarantine: il proprietario del dominio di invio richiede che i messaggi che non superano l'autenticazione DMARC vengano considerati sospetti dai ricevitori. reject: il proprietario del dominio di invio richiede che i messaggi che non superano l'autenticazione DMARC vengano rifiutati.
dmarcVerdict	Oggetto che indica se il controllo DMARC (Domain-based Message Authentication, Reporting & Conformance) è stato superato. Per un elenco di possibili valori, consulta Oggetto dmarcVerdict.
processingTimeMillis	Stringa che specifica il periodo di tempo, in millisecondi, dal momento in cui Amazon SES ha ricevuto il messaggio al momento in cui ha attivato l'operazione.
recipients	I destinatari (nello specifico, gli indirizzi envelope RCPT TO) abbinati dalla regola di ricezione attiva. Gli indirizzi elencati qui potrebbero differire da quelli elencati dal campo destination in oggetto mail.
spamVerdict	Oggetto che indica il messaggio come spam. Per un elenco di possibili valori, consulta Oggetto spamVerdict.
spfVerdict	Oggetto che indica se il controllo Sender Policy Framework (SPF) è stato superato. Per un elenco di possibili valori, consulta Oggetto spfVerdict.
timestamp	Stringa che specifica la data e l'ora in cui l'operazione è stata attivata, in formato ISO 8601.
virusVerdict	Oggetto che indica se il messaggio contiene un virus. Per un elenco di possibili valori, consulta Oggetto virusVerdict.

Oggetto action

L'oggetto action dispone dei campi seguenti.

Nome campo	Descrizione
type	Stringa che indica il tipo di operazione che è stata eseguita. I valori possibili sono S3, SNS, Bounce, Lambda, Stop e WorkMail.
topicArn	Stringa che contiene l'Amazon Resource Name (ARN) dell'argomento Amazon SNS in cui la notifica è stata pubblicata.
bucketName	Stringa che contiene il nome del bucket Amazon S3 in cui il messaggio è stato pubblicato. Presente solo per il tipo di operazione S3.
objectKey	Stringa che include un nome che identifica in modo univoco l'e-mail nel bucket Amazon S3. Ciò corrisponde a messageId in oggetto mail. Presente solo per il tipo di operazione S3.
smtpReplyCode	Stringa che include il codice di risposta SMTP, come definito dallo standard RFC 5321. Presente solo per il tipo di operazione Bounce.
statusCode	Stringa che include il codice di stato avanzato SMTP, come definito dallo standard RFC 3463. Presente solo per il tipo di operazione Bounce.
message	Stringa che contiene il testo leggibile da includere nel messaggio di mancato recapito. Presente solo per il tipo di operazione Bounce.
sender	Stringa che contiene l'indirizzo e-mail del mittente dell'e-mail che non è stata recapitata. Questo è l'indirizzo da cui il messaggio di mancato recapito è stato inviato. Presente solo per il tipo di operazione Bounce.
functionArn	Stringa che contiene l'ARN della funzione Lambda che è stata attivata. Presente solo per il tipo di operazione Lambda.
invocationType	Stringa che include il tipo di richiamo della funzione Lambda. I valori possibili sono RequestResponse e Event. Presente solo per il tipo di operazione Lambda.
organizationArn	Stringa che contiene l'ARN dell'organizzazione Amazon WorkMail. Presente solo per il tipo di operazione WorkMail.

Oggetto dkimVerdict

L'oggetto dkimVerdict dispone dei campi seguenti.

Nome campo

Descrizione

status

Stringa che contiene il risultato DKIM. I valori possibili sono: PASS: il messaggio ha superato l'autenticazione DKIM. FAIL: il messaggio non ha superato l'autenticazione DKIM. GRAY: il messaggio non è firmato da DKIM o il dominio di provenienza e il dominio con firma DKIM non corrispondono. PROCESSING_FAILED:A un problema impedisce ad Amazon SES di verificare la firma DKIM. Ad esempio, le query DNS non riescono o l'intestazione della firma DKIM non ha il formato corretto.

Oggetto dmarcVerdict

L'oggetto dmarcVerdict dispone dei campi seguenti.

Nome campo

Descrizione

status

Stringa che contiene il risultato DMARC. I valori possibili sono: PASS: il messaggio ha superato l'autenticazione DMARC. FAIL: il messaggio non ha superato l'autenticazione DMARC. GRAY: almeno uno tra SPF e DKIM ha superato l'autenticazione, ma il dominio di invio non dispone di una policy DMARC o utilizza la policy p=none. PROCESSING_FAILED: un problema impedisce ad Amazon SES di fornire un risultato DMARC.

Oggetto spamVerdict

L'oggetto spamVerdict dispone dei campi seguenti.

Nome campo

Descrizione

status

Stringa che contiene il risultato della scansione di verifica spam. I valori possibili sono: PASS: la scansione di verifica spam ha determinato che non è probabile che il messaggio contenga spam. FAIL: la scansione di verifica spam ha determinato che è probabile che il messaggio contenga spam. GRAY: Amazon SES ha analizzato l'e-mail senza poter determinare con sicurezza se si tratta di spam. PROCESSING_FAILED: Amazon SES non è stato in grado di analizzare l'e-mail. Ad esempio, l'e-mail non è un messaggio MIME valido.

Oggetto spfVerdict

L'oggetto spfVerdict dispone dei campi seguenti.

Nome campo	Descrizione
status	Stringa che contiene il risultato SPF. I valori possibili sono: PASS: il messaggio ha superato l'autenticazione SPF. FAIL: il messaggio non ha superato l'autenticazione SPF. GRAY: il risultato SPF è none, softfail o neutral. PROCESSING_FAILED: un problema impedisce ad Amazon SES di verificare il record SPF. Ad esempio, le query DNS non riescono.

Oggetto virusVerdict

L'oggetto virusVerdict dispone dei campi seguenti.

Nome campo

Descrizione

status

Stringa che contiene il risultato della scansione di verifica virus. I valori possibili sono: PASS: il messaggio non contiene virus. FAIL: il messaggio contiene virus. GRAY: Amazon SES ha analizzato l'e-mail senza poter determinare con sicurezza se contiene virus. PROCESSING_FAILED: Amazon SES non è in grado di analizzare il contenuto dell'e-mail. Ad esempio, l'e-mail non è un messaggio MIME valido.

oggetto mail

L'oggetto mail dispone dei campi seguenti.

Nome campo	Descrizione
destination	Un elenco completo di tutti gli indirizzi dei destinatari (inclusi i destinatari A: e Cc:) tratti dalle intestazioni MIME dell'e-mail in entrata.
messageId	Stringa che contiene l'ID univoco assegnato all'e-mail da Amazon SES. Se l'e-mail è stata consegnata ad Amazon S3, l'ID messaggio è anche la chiave dell'oggetto Amazon S3 utilizzata per scrivere il messaggio al tuo bucket Amazon S3.
source	Stringa che contiene l'indirizzo e-mail da cui l'email è stata inviata (nello specifico, l'indirizzo MAIL FROM della busta).
timestamp	Stringa che contiene data e ora in cui l'e-mail è stata ricevuta, in formato ISO8601.
headers	Le intestazioni Amazon SES e le intestazioni personalizzate. Ogni intestazione dispone dei campi seguenti: name e value.
commonHeaders	Le intestazioni comuni a tutte le e-mail. Ogni intestazione dispone dei campi seguenti: name e value.
headersTruncated	Stringa che specifica se le intestazioni sono state troncate nella notifica. Ciò si verifica se le intestazioni hanno dimensione superiore a 10 KB. I valori possibili sono true e false.

Oggetto commonHeaders

L'oggetto commonHeaders può avere i campi indicati nella tabella riportata di seguito. I campi presenti in questo oggetto variano a seconda di quali campi erano presenti nella posta in entrata.

Nome campo	Descrizione
messageId	L'ID del messaggio originale.
date	La data e l'ora in cui Amazon SES ha ricevuto il messaggio.
to	L'intestazione To dell'e-mail.
cc	L'intestazione CC dell'e-mail.
bcc	L'intestazione BCC dell'e-mail.
from	L'intestazione From dell'e-mail.
sender	L'intestazione Sender dell'e-mail.
returnPath	L'intestazione Return-Path dell'e-mail.
replyTo	L'intestazione Reply-To dell'e-mail.
subject	L'intestazione Subject dell'e-mail.