Guida introduttiva AWS Lambda per Amazon WorkMail Configurazione delle regole Run Lambda sincrone Dati degli eventi Lambda Schema di risposta Lambda Synchronous Run Esempi di risposte Run Lambda sincrone Ulteriori informazioni sull'utilizzo di Lambda con Amazon WorkMail

Configurazione AWS Lambda per Amazon WorkMail

Utilizza l'azione Esegui Lambda nelle regole del flusso di posta elettronica in entrata e in uscita per passare i messaggi e-mail che corrispondono alle regole a una AWS Lambda funzione di elaborazione.

Scegli tra le seguenti configurazioni per un'azione Esegui Lambda in Amazon. WorkMail

Configurazione Synchronous Run Lambda: I messaggi di posta elettronica che corrispondono alla regola del flusso vengono passati a una funzione Lambda per l'elaborazione prima di essere inviati o recapitati. Utilizzate questa configurazione per modificare il contenuto delle e-mail. Puoi anche controllare il flusso di posta elettronica in entrata o in uscita per diversi casi d'uso. Ad esempio, una regola passata a una funzione Lambda può bloccare la consegna di messaggi e-mail sensibili, rimuovere allegati o aggiungere dichiarazioni di non responsabilità.
Configurazione Run Lambda asincrona: I messaggi di posta elettronica che corrispondono alla regola del flusso vengono passati a una funzione Lambda per l'elaborazione durante l'invio o la consegna. Questa configurazione non influisce sulla consegna delle e-mail e viene utilizzata per attività quali la raccolta di parametri relativi ai messaggi e-mail in entrata o in uscita.

Sia che scegliate una configurazione sincrona o asincrona, l'oggetto evento passato alla funzione Lambda contiene i metadati per l'evento e-mail in entrata o in uscita. È inoltre possibile utilizzare l'ID messaggio nei metadati per accedere all'intero contenuto del messaggio e-mail. Per ulteriori informazioni, consulta Recupero del contenuto del messaggio con AWS Lambda. Per ulteriori informazioni sugli eventi, consulta Dati degli eventi Lambda.

Per ulteriori informazioni sulle regole del flusso di posta in entrata e in uscita, consulta Gestione dei flussi di e-mail. Per ulteriori informazioni su Lambda, consulta la Guida per gli sviluppatori di AWS Lambda .

Nota

Attualmente, le regole del flusso di posta elettronica Lambda fanno riferimento solo alle funzioni Lambda nella stessa AWS regione e Account AWS all'organizzazione Amazon WorkMail da configurare.

Guida introduttiva AWS Lambda per Amazon WorkMail

Per iniziare AWS Lambda a usare Amazon WorkMail, ti consigliamo di distribuire la funzione WorkMail Hello World Lambda dal AWS Serverless Application Repository al tuo account. La funzione dispone di tutte le risorse necessarie e le autorizzazioni sono configurate per te. Per altri esempi, consulta il amazon-workmail-lambda-templatesrepository su. GitHub

Se scegli di creare la tua funzione Lambda, devi configurare le autorizzazioni utilizzando (). AWS Command Line Interface AWS CLI Nel seguente comando di esempio, effettuate le seguenti operazioni:

Sostituisci MY_FUNCTION_NAME con il nome della tua funzione Lambda.
Sostituisci REGION con la tua WorkMail AWS regione Amazon. Le WorkMail regioni Amazon disponibili includono us-east-1 (Stati Uniti orientali (Virginia settentrionale)), us-west-2 (Stati Uniti occidentali (Oregon)) e eu-west-1 (Europa (Irlanda)).
Sostituiscilo AWS_ACCOUNT_ID con il tuo ID a 12 cifre Account AWS .
WORKMAIL_ORGANIZATION_IDSostituiscilo con WorkMail l'ID della tua organizzazione Amazon. Puoi trovarlo sulla scheda della tua organizzazione nella pagina Organizations.


aws --region REGION lambda add-permission --function-name MY_FUNCTION_NAME 
--statement-id AllowWorkMail 
--action "lambda:InvokeFunction" 
--principal workmail.REGION.amazonaws.com
--source-arn arn:aws:workmail:REGION:AWS_ACCOUNT_ID:organization/WORKMAIL_ORGANIZATION_ID

Per ulteriori informazioni sull'utilizzo di AWS CLI, consulta la Guida AWS Command Line Interface per l'utente.

Configurazione delle regole Run Lambda sincrone

Per configurare una regola sincrona Esegui Lambda, crea una regola del flusso di posta elettronica con l'azione Esegui Lambda e seleziona la casella di controllo Esegui in modo sincrono. Per ulteriori informazioni sulla creazione di regole del flusso di e-mail, consulta Creazione di regole del flusso di posta elettronica.

Per completare la creazione della regola sincrona, aggiungi Lambda Amazon Resource ARN Name () e configura le seguenti opzioni.

Operazione di fallback: L'azione WorkMail applicata da Amazon se la funzione Lambda non viene eseguita. Questa azione si applica anche a tutti i destinatari che vengono omessi dalla risposta Lambda se il allRecipientsflag non è impostato. L'azione Fallback non può essere un'altra azione Lambda.
Timeout regola (in minuti).: Il periodo di tempo durante il quale la funzione Lambda viene ritentata se Amazon WorkMail non riesce a richiamarla. Operazione di fallback viene applicata alla fine di questo periodo di tempo.

Nota

Le regole Synchronous Run Lambda supportano solo * la condizione di destinazione.

Dati degli eventi Lambda

La funzione Lambda viene attivata utilizzando i seguenti dati di evento. La presentazione dei dati varia a seconda del linguaggio di programmazione utilizzato per la funzione Lambda.


{
    "summaryVersion": "2018-10-10",
    "envelope": {
        "mailFrom" : {
            "address" : "from@example.com"
        },
        "recipients" : [
           { "address" : "recipient1@example.com" },
           { "address" : "recipient2@example.com" }
        ]
    },
    "sender" : {
        "address" :  "sender@example.com"
    },
    "subject" : "Hello From Amazon WorkMail!",
    "messageId": "00000000-0000-0000-0000-000000000000",
    "invocationId": "00000000000000000000000000000000",
    "flowDirection": "INBOUND",
    "truncated": false
}

L'evento JSON include i seguenti dati.

summaryVersion

Il numero di versione perLambdaEventData. Si aggiorna solo quando apporti una modifica incompatibile con le versioni precedenti. LambdaEventData

envelope

La busta del messaggio di posta elettronica, che include i seguenti campi.

mailFrom: L'indirizzo Da, che di solito è l'indirizzo e-mail dell'utente che ha inviato il messaggio e-mail. Se l'utente ha inviato il messaggio di posta elettronica come altro utente o per conto di un altro utente, il mailFromcampo restituisce l'indirizzo e-mail dell'utente per conto del quale è stato inviato il messaggio e-mail, non l'indirizzo e-mail del mittente effettivo.
recipients: L'elenco degli indirizzi e-mail dei destinatari. Amazon WorkMail non fa distinzione tra To, CC o BCC.

Nota
Per le regole del flusso di posta elettronica in entrata, questo elenco include i destinatari in tutti i domini dell' WorkMailorganizzazione Amazon in cui crei la regola. La funzione Lambda viene richiamata separatamente per ogni SMTP conversazione dal mittente e il campo destinatari elenca i destinatari di quella conversazione. SMTP I destinatari con domini esterni non sono inclusi.

mittente

L'indirizzo e-mail dell'utente che ha inviato il messaggio e-mail per conto di un altro utente. Questo campo è impostato solo quando un messaggio e-mail viene inviato per conto di un altro utente.

subject

La riga dell'oggetto del messaggio e-mail. Viene troncata quando supera il limite di 256 caratteri.

messageId

Un ID univoco utilizzato per accedere all'intero contenuto del messaggio e-mail quando si utilizza Amazon WorkMail Message FlowSDK.

invocationId

L'ID per una chiamata Lambda univoca. Questo ID rimane lo stesso quando una funzione Lambda viene chiamata più di una volta per la stessa. LambdaEventData Utilizzare per rilevare i tentativi ed evitare la duplicazione.

flowDirection

Indica la direzione del flusso di posta elettronica, INBOUNDoppure OUTBOUND.

truncated

Si applica alla dimensione del payload e non alla lunghezza della riga dell'oggetto. Se true, la dimensione del payload supera il limite di 128 KB, per cui l'elenco dei destinatari viene troncato in modo da soddisfare il limite.

Schema di risposta Lambda Synchronous Run

Quando una regola del flusso e-mail con un'azione sincrona Esegui Lambda corrisponde a un messaggio e-mail in entrata o in uscita, Amazon WorkMail chiama la funzione Lambda configurata e attende la risposta prima di agire sul messaggio e-mail. La funzione Lambda restituisce una risposta secondo uno schema predefinito che elenca le azioni, i tipi di azione, i parametri applicabili e i destinatari a cui si applica l'azione.

L'esempio seguente mostra una risposta sincrona Run Lambda. Le risposte variano in base al linguaggio di programmazione utilizzato per la funzione Lambda.


{
    "actions": [                          
      {
        "action" : {                       
          "type": "string",                 
          "parameters": { various }       
        },
        "recipients": [list of strings],      
        "allRecipients": boolean            
      }
    ]
}

La risposta JSON include i seguenti dati.

action

Operazione da intraprendere per i destinatari.

tipo

Tipo di operazione. I tipi di azione non vengono restituiti per le azioni Run Lambda asincrone.

I tipi di azioni delle regole in entrata includono BOUNCE, DROPDEFAULT, BYPASS_ _ e _TO_ SPAM. CHECK MOVE JUNK Per ulteriori informazioni, consulta Operazioni delle regole di posta in entrata.

I tipi di azioni delle regole in uscita includono BOUNCE, e. DROPDEFAULT Per ulteriori informazioni, consulta Operazioni delle regole di posta in uscita.

parametri

Parametri di operazione aggiuntivi. Supportato per il tipo di BOUNCEazione come JSON oggetto con la stringa di chiave bounceMessagee valore. Questo messaggio di mancato recapito (bounce) viene utilizzato per creare il messaggio e-mail di mancato recapito (bounce).

recipients

Elenco di indirizzi e-mail su cui deve essere intrapresa l'operazione. È possibile aggiungere nuovi destinatari alla risposta anche se non sono stati inclusi nell'elenco dei destinatari originali. Questo campo non è obbligatorio se allRecipientsè vero per un'azione.

Nota

Quando viene richiesta un'azione Lambda per la posta elettronica in entrata, è possibile aggiungere solo nuovi destinatari che provengono dalla propria organizzazione. I nuovi destinatari vengono aggiunti alla risposta come. BCC

allRecipients

Se impostato su true, applica l'azione a tutti i destinatari che non sono soggetti a un'altra azione specifica nella risposta Lambda.

Limiti di azione Lambda di Synchronous Run

I seguenti limiti si applicano quando Amazon WorkMail richiama le funzioni Lambda per azioni sincrone Run Lambda:

Le funzioni Lambda devono rispondere entro 15 secondi o essere trattate come chiamate non riuscite.

Nota
Il sistema riprova la chiamata per l'intervallo di timeout della regola specificato.
Sono consentite risposte della funzione Lambda fino a 256 KB.
Nella risposta sono consentite fino a 10 operazioni univoche. Le operazioni superiori a 10 sono soggette all'Operazione di fallback configurata.
Sono consentiti fino a 500 destinatari per le funzioni Lambda in uscita.
Il valore massimo per Timeout regola è 240 minuti. Se è configurato il valore minimo 0, non ci sono nuovi tentativi prima che Amazon WorkMail applichi l'azione di fallback.

Errori dell'azione Synchronous Run Lambda

Se Amazon non WorkMail riesce a richiamare la funzione Lambda a causa di un errore, di una risposta non valida o di un timeout Lambda, WorkMail Amazon ritenta la chiamata con un backoff esponenziale che riduce la velocità di elaborazione fino al completamento del periodo di timeout della regola. Quindi, l'Operazione di fallback viene applicata a tutti i destinatari del messaggio e-mail. Per ulteriori informazioni, consulta Configurazione delle regole Run Lambda sincrone.

Esempi di risposte Run Lambda sincrone

Gli esempi seguenti illustrano la struttura delle risposte Run Lambda sincrone comuni.

Esempio : rimozione dei destinatari specificati da un messaggio e-mail

L'esempio seguente dimostra la struttura di una risposta sincrona Run Lambda per rimuovere i destinatari da un messaggio di posta elettronica.


{
    "actions": [
      {
        "action": {
          "type": "DEFAULT"
        },
        "allRecipients": true
      },
      {
        "action": {
          "type": "DROP"
        },
        "recipients": [
          "drop-recipient@example.com"
        ]
      }
    ]
}

Esempio : mancato recapito (bounce) con un messaggio e-mail personalizzato

L'esempio seguente dimostra la struttura di una risposta sincrona Run Lambda per il rimbalzo con un messaggio e-mail personalizzato.


{
    "actions" : [
      {
        "action" : {
          "type": 'BOUNCE',
          "parameters": {
            "bounceMessage" : "Email in breach of company policy."
          }
        },
        "allRecipients": true
      }
    ]
}

Esempio : aggiunta di destinatari a un messaggio e-mail

L'esempio seguente dimostra la struttura di una risposta sincrona Run Lambda per aggiungere destinatari al messaggio di posta elettronica. Questa operazione non aggiorna i campi A o Cc del messaggio e-mail.


{
    "actions": [
      {
        "action": { 
          "type": "DEFAULT" 
        },
        "recipients": [
          "new-recipient@example.com"
         ]
      },
      {
        "action": { 
          "type": "DEFAULT" 
        },
        "allRecipients": true
      }
    ]
}

Per altri esempi di codice da utilizzare durante la creazione di funzioni Lambda per le azioni Esegui Lambda, consulta i modelli di Amazon Lambda. WorkMail

Ulteriori informazioni sull'utilizzo di Lambda con Amazon WorkMail

Puoi anche accedere al contenuto completo del messaggio e-mail che attiva la funzione Lambda. Per ulteriori informazioni, consulta Recupero del contenuto del messaggio con AWS Lambda.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Modifica delle regole del flusso di posta elettronica

Recupero del contenuto del messaggio con AWS Lambda