RDS + VPC + Lambda + API Gateway + CloudFront + WAF + ACMでAPIを構築する

Tweet

RDSのMySQLの情報を与えられたリクエストをキーにしてjsonで返すAPIを構築してみます。
条件としてHeaderのAuthorizationキーの設定と接続元のIPアドレスを制限します。
通信はSSLを使用するのでACMで無料証明書を発行します。

Lambda用のIAMの設定

Lambda実行用にIAMロールを作成します。

ポリシーは「AWSLambdaVPCAccessExecutionRole」をアタッチします。

Lambdaの設定

事前にセキュリティグループを1つ作成しておきます。
特にInbound , Outboundの設定は必要ありません。

作成したIAMロールを設定します。

RDSと同じVPC、Subnetsを選択します。
SecurityGroupsは事前に作成していたものを設定します。

コードは割愛しますが、pythonでMySQLへの接続はpymysqlモジュールを使用しています。
ホスト名はRDSエンドポイントです。

RDSのセキュリティグループの設定

Lambdaに設定したセキュリティグループをインバウンドでMySQLタイプで設定します。

API Gatewayの設定

Lambdaの[API endpoints]から作成します。
Securityでは「Open with access key」を設定します。

API GatewayでAPIキーを設定して作成されたステージへ追加します。

APIで受けるリクエストをメソッドリクエストで設定します。

統合リクエストでマッピングテンプレートも設定しておきます。

クエリーパラメータは「”key”: “$input.params(‘key’)”,」です。
コード内ではIPアドレスの制御はしませんが、sourceIpで接続元IPアドレスを一応取得しています。

API Gatewayでは設定が終わってステージに反映するときは必ず、[アクション]-[APIのデプロイ]を実行します。
これをしなければAPIには反映されません。

WAFの設定

Web ACL name , CloudWatch metric nameを任意で設定します。

Create conditionsで[IP match conditions]と[String match conditions]を設定します。

IP match conditionsでは許可するIPアドレスを設定します。

String match conditionsではHeaderのAuthorization値を完全一致で決めます。

Create RuleでconditonにIPアドレスとString match conditionを[does]で追加します。

作成したルールをAction をAllow、Default をBlockとしてACLに追加します。

ACMのためのSESの設定

サブドメインのCNAMEにCloudFrontのDomain Nameを任意の設定して独自ドメインにしたいと思います。

※ドメイン管理者としてメールを受信できる場合はこの設定は必要ありません。

※先にCNAMEを設定するとACMの認証URL受け取りのメールのためのMXレコードが設定できなくなるのでCNAMEは最後に設定します。

[Verify a New Domain]で受信したいドメインを指定します。

TXTレコードとMXレコードの設定内容が表示されるので、レコードセットを管理しているDNSサーバで設定します。

[Create Receipt Rule]で新しいルールを作成します。
[Recipient]にドメインを入れます。(ドメイン宛のメールすべて対象とします。)

[Action]でS3バケットを選択します。
2つ目は[Stop Rule Set]として処理を終了しておきます。

ルール名を任意で設定します。

CloudFrontでのACMの設定

CloudFrontの編集画面で[Request an ACM certificate]をクリックします。

ドメイン名を入力します。

ドメイン管理者にメールが送信されます。
メールが受信できなくて前述のSESで設定している場合はS3バケットにメールが届いているのでAcceptします。

証明書が発行済になりました。

CloudFrontのAlternate Domain Names(CNAMEs)に独自ドメインを入れて、
[Custom SSL Certificate]を選択して発行済の証明書を設定します。

その他のCloudFrontの設定

作成したWAFをCloudFrontへ設定します。

Origin Settingsで、Origin Domain NameにAPI Gatewayのエンドポイントを設定します。

[Origin Protocol Policy]は[HTTPS Only]にします。

[Origin Custom Headers]でAPI Gatewayで設定したアクセスキーを設定します。
[Header Name]は[x-api-key]です。
これでAPI Gatewayの直接実行を防止します。

Behaivior Settingsで[Viewer Protocol Policy]は[HTTPS Only]にします。
[Allowed HTTP Methods]は実行許可するAPIメソッドを含むように選びます。
ここで間違えていると、「This distribution is not configured to allow the HTTP request method that was used for this request.」とかになります。

[Forward Query Strings]も[Yes]にします。
こうしとかないとクエリーストリングパラメータをAPIに渡せません。

これでWAFで許可していないIPアドレスや、Headerの設定がない場合は、「Request blocked.」になります。

@yamamanx

開発ベンダー5年、ユーザ企業システム部門通算8年目のSoftware Engineerです。
質問はコメントかSNSなどからお気軽にどうぞ。
出来る限りなるべく答えます。