【AWS + Swift】 API Gateway + Lambda + SNS でEメール通知機能を実装してみた。

Hanagasaki

2022年1月11日 20:22

はじめに

本記事は、API Gateway + Lambda + SNSを使用したEメール通知機能の実装を紹介します。
以下、使用した各サービスの概要を簡単に説明します。

API Gateway

Amazon API Gateway は、あらゆる規模の REST、HTTP、および WebSocket API を作成、公開、維持、モニタリング、およびセキュア化するための AWS のサービスです。

【Amazon API Gateway とは何ですか?】
https://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/welcome.html

Lambda

Lambda はサーバーをプロビジョニングしたり管理しなくてもコードを実行できるコンピューティングサービスです。

【AWS Lambda とは】
https://docs.aws.amazon.com/ja_jp/ja_jp/lambda/latest/dg/welcome.html

SNS

Amazon Simple Notification Service (Amazon SNS) は、配信者から受信者 (または生産者から消費者) へのメッセージ配信を提供するマネージドサービスです。発行者は、論理アクセスポイントおよび通信チャネルであるトピックにメッセージを送信することで、受信者と非同期的に通信します。クライアントは、Amazon Kinesis Data Firehose、Amazon SQS、AWS Lambda、HTTP、E メール、モバイルプッシュ通知、モバイルテキストメッセージ (SMS) などのサポートされたエンドポイントを使用して SNS トピックにサブスクライブし発行されたメッセージを受信できます。

【Amazon SNS とは】
https://docs.aws.amazon.com/ja_jp/sns/latest/dg/welcome.html

使用環境

●　OS：macOS Big Sur 11.3.1
●　Xcode：12.5
●　Swift：5.4
●　Postman

実装

AWS側

１、AWSマネジメントコンソールのページへ飛ぶ。
URL ⇨ https://aws.amazon.com/jp/console/

２、検索欄に「API Gateway」と入力し、一覧から【API Gateway】を押下する。

３、【APIを作成】ボタンを押下する。

４、APIタイプ選択一覧の【REST API】を選択する。

５、各項目を下記の画像の様に設定し、【APIの作成】を押下する。

６、リソース設定画面の【アクション】⇨【リソースの作成】の順にリソース作成画面に遷移し、リソース名を入力する。

７、【アクション】⇨【メソッドの作成】⇨【POST】⇨【✅】の順に選択する。

８、検索欄に「Lambda」と入力し、一覧から【Lambda】を押下する。

９、【関数の作成】を押下する。

１０、各項目を下記の画像の様に設定し、【関数の作成】を押下する。

１１、検索欄に「IAM」と入力し、一覧から【IAM】を押下する。

１２、IAM画面の【アクセス管理】⇨【ロール】⇨【ロールを作成】の順に押下する。

１３、【Lambda】⇨【次のステップ：アクセス権限】の順に押下する。

１４、検索欄から「SNS」を入力し、【AmazonSNSFullAccess】を選択する。

１５、【次のステップ:確認】を押下する。

１６、ロール名を入力し、【ロールの作成】を押下する。

１７、検索欄に「Lambda」と入力し、一覧から【Lambda】を押下する。

１８、【設定】⇨【編集】の順に、編集画面に遷移する。

１９、IAMで作成したロールを選択し、【保存】を押下する。

２０、実行するコードを書き換えを行う。

２１、検索欄に「SNS」と入力し、一覧から【Simple Notification Service】を押下する。

２２、【トピックの作成】を押下し、トピック作成画面に遷移する。

２３、【タイプ】はスタンダードを選択を行い、【名前】、【表示名】を好きなものを入力し、トピックを作成する。

２４、【サブスクリプションの作成】を押下し、サブスクリプション作成画面に遷移する。

２５、【プロトコル】にはEメール選択を行い、【エンドポイント】には送信先メールアドレスを入力し、サブスクリプションを作成する。

２６、サブスクリプション作成後、入力したメールアドレス宛にサブスクリプション認証許可通知が届くので、【Confirm subscription】を押下する。
押下後、認証が完了するためサブスクリプション詳細画面で【ステータス】が「確認済み」なっているか確認する。

２７、検索欄に「API Gateway」と入力し、一覧から【API Gateway】を押下する。

２８、【Lambda関数】に作成したLambda関数を選択し、【保存】を押下する。

２９、検索欄に「SNS」と入力し、一覧から【Simple Notification Service】を押下する。

３０、作成したトピックの詳細画面で表示されているARNをコピーする。

３１、検索欄に「Lambda」と入力し、一覧から【Lambda】を押下する。

３２、トピック詳細画面でコピーしたARNをペーストする。

３３、検索欄に「API Gateway」と入力し、一覧から【API Gateway】を押下する。

３４、【アクション】⇨【APIのデプロイ】の順にデプロイ実行画面に遷移する。

３５、下記の画像の様に設定を行い、【デプロイ】を押下する。

３６、生成されたURLをコピーする。

３７、コピーしたURLをPostmanを使用して、APIを叩く。

３８、指定したメールアドレスに通知が届く。

Xcode側

コード

import UIKit

class ViewController: UIViewController {
    
    @IBOutlet weak var sendBtn: UIButton! {
        didSet {
            sendBtn.layer.borderColor = UIColor.blue.cgColor
            sendBtn.layer.borderWidth = 1
        }
    }
    
    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    @IBAction func sendMessageAction(_ sender: Any) {
        EmailMessageSendApi()
    }
    
    private func EmailMessageSendApi() {
        
        var params = Dictionary<String,String>()
        params["username"] = "Hanagasaki"
        params["email"] = "sample@gmail.com"
        params["contact"] = "123456789"
        
        let request = NSMutableURLRequest(url: NSURL(string: "https://rf6u8jsv1a.execute-api.ap-northeast-1.amazonaws.com/test/user")! as URL,
                                          cachePolicy: .useProtocolCachePolicy,
                                          timeoutInterval: 10.0)
        request.httpMethod = "POST"
        
        do {
            request.httpBody = try JSONSerialization.data(withJSONObject: params, options: [])
        } catch let error as NSError {
            print(error.localizedDescription)
        }
        
        let session = URLSession.shared
        let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
            do {
                let json = try JSONSerialization.jsonObject(with: data!, options: JSONSerialization.ReadingOptions.allowFragments)
                print(json)
            }
            catch let error as NSError {
                print(error.localizedDescription)
            }
        })
        dataTask.resume()
    }
}

送信結果

おわりに

API Gateway + Lambda + SNSでモバイル端末にEメール通知する機能について、紹介しました。
次はCognito（認証機能）について、学習しようと思います。