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認定デベロッパーアソシエイト［DVA-C02対応］」という本を書きました。

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

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

@yamamanx

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

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

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

- AWS AWS, ses

: macOSにAWS Schema Conversion Toolをインストール

環境 macOS BigSur バージョン11.5(20G71) MacBook …

: S3をトリガーにしたときのLambdaのリソースベースポリシー

LambdaのトリガーでS3を設定したとき、自動的にLambdaのリソースベース …

: Amazon S3アクセスポイント経由からアクション可能なポリシー

S3アクセスポイントを使うことで、複雑で長いバケットポリシーを避け、アクセスポイ …

: Redmineの添付ファイルをS3に同期する

RedmineをAWS上で構築するデザインを考えていて、せっかくなので冗長化しよ …

: AWS Toolkit for Eclipseで「Error Message: Unable to find a region via the region provider chain. Must provide an explicit region in the builder or setup environment to supply a region.」

AWS Toolkit for Eclipseをセットアップ(2021年版)の環 …

: S3バケットポリシーですべてDenyにしてしまったらルートユーザーの出番

特定のConditionsを指定して、それ以外はすべて拒否するS3バケットポリシ …

: EC2 Image BuilderでRocket.ChatのAMIを作って起動テンプレートを更新しました

EC2 Image Builderの練習をしようと思い、Rocket.Chatの …

: 「雲勉第1回【勉強会：新技術好き!】AWSマネージドサービス勉強会」に行ってきました

「雲勉第1回【勉強会：新技術好き!】AWSマネージドサービス勉強会」に行ってき …

: RDSスナップショットのS3エクスポート結果確認

RDSのスナップショットをS3へエクスポートが日本語マネジメントコンソールでもで …

: Amazon Location Service入門ワークショップ-マップの操作

関連記事 Amazon Location Service入門ワークショップの前提 …

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

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

テスト用のLambda関数を作成

SESの受信ルール設定

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

ad

ad

関連記事