Amazon SES(Simple Email Service)でメール受信時のアクションでLambdaを実行して渡されるデータを見てみる

2018/01/08

Amazon SESで受信したメールをS3に保存して、S3のトリガーでLambdaを実行して転送処理を書くのがよくあるケースのようですが、受信ルールのアクションでもLambdaを実行出来るので、その場合どのようなデータがLambdaに渡されているのかを見てみました。
あわよくば、S3からではなく、SESから渡されたデータをもとに転送出来たら処理がシンプルかなと思いまして。

テスト用のLambda関数を作成

ランタイムはPython3.6です。
テスト用なのでeventの内容をログに出すだけです。
SESと同じリージョンにLambda関数を作成する必要があります。

import logging

logger = logging.getLogger()
logger.setLevel(20)

def lambda_handler(event, context):
    logger.info(event)

    return

import logging

logger = logging.getLogger()

logger.setLevel(20)

def lambda_handler(event, context):

logger.info(event)

return

SESの受信ルール設定

SESにドメインは登録されている前提で進めます。

新しいルールを作成します。
今回はRecipientsは設定せずに進めてみます。
ルールをドメインやアカウントに限定する場合は設定するべきです。

ActionでLambda Functionを選択します。

Rule Detailsはデフォルトのままにしました。

確認画面です。
作成します。

テストメールを送信してみる

SESに登録済のドメインの適当なアカウント宛にGmailからメールを送信してLambdaのログを確認してみました。

このようなデータが渡っていました。

{
  'Records': [
    {
      'eventSource': 'aws:ses',
      'eventVersion': '1.0',
      'ses': {
        'mail': {
          'timestamp': '2018-01-08T01:49:28.137Z',
          'source': 'source@gmail.com',
          'messageId': 'lelpuk070j3q3ifuhhjut2mjhpnj6ruhhk0p7b81',
          'destination': [
            'user1@destination.com'
          ],
          'headersTruncated': False,
          'headers': [
            {
              'name': 'Return-Path',
              'value': '<source@gmail.com>'
            },
            {
              'name': 'Received',
              'value': '**********'
            },
            {
              'name': 'X-SES-Spam-Verdict',
              'value': 'PASS'
            },
            {
              'name': 'X-SES-Virus-Verdict',
              'value': 'PASS'
            },
            {
              'name': 'Received-SPF',
              'value': '********'
            },
            {
              'name': 'Authentication-Results',
              'value': '******'
            },
            {
              'name': 'X-SES-RECEIPT',
              'value': '******'
            },
            {
              'name': 'X-SES-DKIM-SIGNATURE',
              'value': '******'
            },
            {
              'name': 'Received',
              'value': '******'
            },
            {
              'name': 'DKIM-Signature',
              'value': '******'
            },
            {
              'name': 'X-Google-DKIM-Signature',
              'value': '******'
            },
            {
              'name': 'X-Gm-Message-State',
              'value': '*******'
            },
            {
              'name': 'X-Google-Smtp-Source',
              'value': '******'
            },
            {
              'name': 'X-Received',
              'value': '******'
            },
            {
              'name': 'MIME-Version',
              'value': '1.0'
            },
            {
              'name': 'Received',
              'value': '******'
            },
            {
              'name': 'From',
              'value': 'テスト送信元 <source@gmail.com>'
            },
            {
              'name': 'Date',
              'value': 'Mon, 8 Jan 2018 10:49:26 +0900'
            },
            {
              'name': 'Message-ID',
              'value': '<CA+9tysfvhxuYO_-TGuJZNddh_ddqqLhkKOQ42B=7ZPQ32i4uLg@mail.gmail.com>'
            },
            {
              'name': 'Subject',
              'value': 'SES送信テスト'
            },
            {
              'name': 'To',
              'value': 'user1@destination.com'
            },
            {
              'name': 'Content-Type',
              'value': 'text/plain; charset="UTF-8"'
            },
            {
              'name': 'Content-Transfer-Encoding',
              'value': 'base64'
            }
          ],
          'commonHeaders': {
            'returnPath': 'source@gmail.com',
            'from': [
              '"テスト送信元" <source@gmail.com>'
            ],
            'date': 'Mon, 8 Jan 2018 10:49:26 +0900',
            'to': [
              'user1@destination.com'
            ],
            'messageId': '<CA+9tysfvhxuYO_-TGuJZNddh_ddqqLhkKOQ42B=7ZPQ32i4uLg@mail.gmail.com>',
            'subject': 'SES送信テスト'
          }
        },
        'receipt': {
          'timestamp': '2018-01-08T01:49:28.137Z',
          'processingTimeMillis': 451,
          'recipients': [
            'user1@destination.com'
          ],
          'spamVerdict': {
            'status': 'PASS'
          },
          'virusVerdict': {
            'status': 'PASS'
          },
          'spfVerdict': {
            'status': 'PASS'
          },
          'dkimVerdict': {
            'status': 'PASS'
          },
          'dmarcVerdict': {
            'status': 'PASS'
          },
          'action': {
            'type': 'Lambda',
            'functionArn': 'arn:aws:lambda:us-east-1:*******:function:ses_forward',
            'invocationType': 'Event'
          }
        }
      }
    }
  ]
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

{

'Records': [

{

'eventSource': 'aws:ses',

'eventVersion': '1.0',

'ses': {

'mail': {

'timestamp': '2018-01-08T01:49:28.137Z',

'source': 'source@gmail.com',

'messageId': 'lelpuk070j3q3ifuhhjut2mjhpnj6ruhhk0p7b81',

'destination': [

'user1@destination.com'

'headersTruncated': False,

'headers': [

{

'name': 'Return-Path',

'value': '<source@gmail.com>'

{

'name': 'Received',

'value': '**********'

{

'name': 'X-SES-Spam-Verdict',

'value': 'PASS'

{

'name': 'X-SES-Virus-Verdict',

'value': 'PASS'

{

'name': 'Received-SPF',

'value': '********'

{

'name': 'Authentication-Results',

'value': '******'

{

'name': 'X-SES-RECEIPT',

'value': '******'

{

'name': 'X-SES-DKIM-SIGNATURE',

'value': '******'

{

'name': 'Received',

'value': '******'

{

'name': 'DKIM-Signature',

'value': '******'

{

'name': 'X-Google-DKIM-Signature',

'value': '******'

{

'name': 'X-Gm-Message-State',

'value': '*******'

{

'name': 'X-Google-Smtp-Source',

'value': '******'

{

'name': 'X-Received',

'value': '******'

{

'name': 'MIME-Version',

'value': '1.0'

{

'name': 'Received',

'value': '******'

{

'name': 'From',

'value': 'テスト送信元 <source@gmail.com>'

{

'name': 'Date',

'value': 'Mon, 8 Jan 2018 10:49:26 +0900'

{

'name': 'Message-ID',

'value': '<CA+9tysfvhxuYO_-TGuJZNddh_ddqqLhkKOQ42B=7ZPQ32i4uLg@mail.gmail.com>'

{

'name': 'Subject',

'value': 'SES送信テスト'

{

'name': 'To',

'value': 'user1@destination.com'

{

'name': 'Content-Type',

'value': 'text/plain; charset="UTF-8"'

{

'name': 'Content-Transfer-Encoding',

'value': 'base64'

}

'commonHeaders': {

'returnPath': 'source@gmail.com',

'from': [

'"テスト送信元" <source@gmail.com>'

'date': 'Mon, 8 Jan 2018 10:49:26 +0900',

'to': [

'user1@destination.com'

'messageId': '<CA+9tysfvhxuYO_-TGuJZNddh_ddqqLhkKOQ42B=7ZPQ32i4uLg@mail.gmail.com>',

'subject': 'SES送信テスト'

}

'receipt': {

'timestamp': '2018-01-08T01:49:28.137Z',

'processingTimeMillis': 451,

'recipients': [

'user1@destination.com'

'spamVerdict': {

'status': 'PASS'

'virusVerdict': {

'status': 'PASS'

'spfVerdict': {

'status': 'PASS'

'dkimVerdict': {

'status': 'PASS'

'dmarcVerdict': {

'status': 'PASS'

'action': {

'type': 'Lambda',

'functionArn': 'arn:aws:lambda:us-east-1:*******:function:ses_forward',

'invocationType': 'Event'

}

]

}

本文以外の情報は渡っていそうです。

転送ではなく、メールの送信元によって処理をしたり、単純ではない処理をするときに使用するケースが考えられるのかなと思いました。

転送にはWorkMailを使用するかS3にデータを格納してそれを解析して転送するか、かなと思いますので、またそれは別途試してみたいと思います。

S3にIMAPプロトコルでアクセス、とか出来るようになると嬉しいなと思ったり。

最後までお読みいただきましてありがとうございました！

「AWS認定資格試験テキスト＆問題集　AWS認定ソリューションアーキテクト - プロフェッショナル改訂第2版」という本を書きました。

「AWS認定資格試験テキスト AWS認定クラウドプラクティショナー改訂第3版」という本を書きました。

「AWS認定資格試験テキスト　AWS認定AIプラクティショナー」という本を書きました。

「ポケットスタディ AWS認定デベロッパーアソシエイト［DVA-C02対応］」という本を書きました。

「要点整理から攻略するAWS認定ソリューションアーキテクト-アソシエイト」という本を書きました。

「AWSではじめるLinux入門ガイド」という本を書きました。

@yamamanx

開発ベンダー5年、ユーザ企業システム部門通算9年、ITインストラクター5年目でプロトタイプビルダーもやりだしたSoftware Engineerです。
質問はコメントかSNSなどからお気軽にどうぞ。
出来る限りなるべく答えます。

このブログの内容/発言の一切は個人の見解であり、所属する組織とは関係ありません。
このブログは経験したことなどの共有を目的としており、手順や結果などを保証するものではありません。
ご参考にされる際は、読者様自身のご判断にてご対応をお願いいたします。

また、勉強会やイベントのレポートは自分が気になったことをメモしたり、聞いて思ったことを書いていますので、登壇者の意見や発表内容ではありません。

- AWS AWS, ses

: Amazon ECS Workshop for AWS Summit Online

INTRODUCTION TO AMAZON ECSに手順や必要なリンクがありま …

: ads.txtをS3に配置してCloudFrontで設定する

ads.txtのダウンロード ads.txt設置してねってメールが来てました。 …

: AWS CodeStarのプロジェクトテンプレートLambda+Pythonによって生成されるもの

勉強会のデモで、AWS CodeStarのプロジェクトテンプレートLambda+ …

: CloudFront用のAWS管理プレフィックスリストを使用しました

このブログでは、CloudFrontのカスタムヘッダーとALBのルーティングを組 …

: AWSアカウントルートユーザーのMFAが使えなくなったので復旧

AWSのルートユーザーどころか、MFAが使えるログインすべてが使えなくなって焦り …

: CloudWatch Logs機密データ保護を設定しました

Amazon CloudWatch Logs を使用して機密データを保護するがリ …

: VyOSにSSMエージェントをインストールしました

VyOSにSSHでログインするのも面倒なので、SSMエージェントをインストールし …

: オンプレミスに見立てたオハイオリージョンにVyOSインスタンスを起動して東京リージョンからVPN接続

AWSクイックスタートのActive Directory Domain Serv …

: 特定AWSアカウント特定リージョンのSNSトピックを削除するLambda(Python)

やりたいこと特定アカウント内特定リージョン内のSNSトピックを全部削除したいで …

: AWS Systems Manager Session ManagerでLinuxインスタンスのRun Asサポートを有効にする

AWS Systems Manager Session Managerの設定画面 …

PREV: AWS上にMetabaseサーバーを起動してみました
NEXT: EC2のAMIとRDSのスナップショットを他のAWSアカウントに共有してブログサイトをAWSアカウント間で引っ越す

Amazon SES(Simple Email Service)でメール受信時のアクションでLambdaを実行して渡されるデータを見てみる

テスト用のLambda関数を作成

SESの受信ルール設定

テストメールを送信してみる

関連記事