API Gateway + Lambda + DynamoDB Serverless API 架構

概要

此架構以 API Gateway 作為 API 的入口、由 Lambda 執行處理、並將資料儲存於 DynamoDB。

在本專案中,此架構被用作儲存聯絡表單送出內容的 API。

由於不需要常駐伺服器,因此非常適合小型 Web 應用程式或個人開發的 MVP。

架構圖

flowchart TD
    User[使用者]
    Frontend[Frontend S3 + CloudFront]
    APIGW[API Gateway HTTP API]
    Lambda[AWS Lambda contact-submit]
    DDB[(DynamoDB ContactsTable)]
    CW[CloudWatch Logs]
    IAM[IAM Role]
    Budget[AWS Budgets]

User -->|表單輸入| Frontend
Frontend -->|POST /contact| APIGW
APIGW -->|Lambda Proxy Integration| Lambda
Lambda -->|PutItem| DDB
Lambda -->|輸出記錄| CW
IAM -.執行權限.-> Lambda
IAM -.僅允許 PutItem.-> DDB
Budget -.費用監控.-> APIGW
Budget -.費用監控.-> Lambda
Budget -.費用監控.-> DDB
```

此架構可達成的功能

使用的 AWS 服務

通訊流程

1. 使用者填寫聯絡表單
2. 前端驗證必填欄位與字數
3. 前端呼叫 API Gateway 的 POST /contact
4. API Gateway 透過 Lambda Proxy Integration 呼叫 Lambda
5. Lambda 解析 JSON
6. Lambda 確認 honeypot
7. Lambda 驗證姓名、電子郵件、主旨、內文
8. 若無問題,則對 DynamoDB 執行 PutItem
9. Lambda 將最小限度的記錄輸出至 CloudWatch Logs
10. 透過 API Gateway 將結果回傳至前端

設計重點

可用性

API Gateway、Lambda、DynamoDB 皆為託管服務,因此個人 MVP 無須管理執行個體即可構成 API。

像聯絡表單 API 這類低頻率的處理,特別適合 Serverless 架構。

安全性

不可只信任前端的輸入檢查,Lambda 端也必須再次進行驗證。

CORS 限制為正式環境前端的 Origin。

Lambda 的 IAM Role 僅授予目標 DynamoDB 資料表的 dynamodb:PutItem 與 CloudWatch Logs 輸出權限。

成本

API Gateway、Lambda、DynamoDB 採用按用量計費。

若為低頻率的聯絡 API,此架構容易壓低固定費用。

但是,垃圾投稿或 Bot 存取會導致請求數增加而提高費用,因此需要考量 honeypot、字數限制以及未來導入速率限制。

運作

在 CloudWatch Logs 中,輸出 requestId、處理結果與錯誤類型。

不可將電子郵件全文或聯絡本文全文寫入記錄。

SAA 考試重點

• API Gateway + Lambda 是 Serverless API 的代表性組合
• DynamoDB 是與 Serverless 架構相容性高的 NoSQL 資料庫
• Lambda 執行角色採用最小權限
• 理解 CORS 設定與驗證方式
• 透過 CloudWatch Logs 確認 Lambda 的記錄
• 不需 VPC 連線的 Lambda 可透過不建立 NAT Gateway 來降低成本

此架構的注意事項

• 正式環境的 CORS 不可使用 *
• 不可將 AWS 存取金鑰或機密資訊放入 Lambda 環境變數
• 不可將聯絡本文輸出至 CloudWatch Logs
• DynamoDB 資料表名稱與允許 Origin 應透過環境變數切換
• 不可僅以前端的驗證為依據
• 若使用 API Gateway 的預設 URL,應在 README 明確記載正式環境 URL 的管理方式

相關用語

• API Gateway
• AWS Lambda
• Amazon DynamoDB
• Amazon CloudWatch
• IAM

相關比較

• RDS 與 DynamoDB 的差異
• CloudWatch、CloudTrail 與 AWS Config 的差異

在本專案中的角色

API Gateway + Lambda + DynamoDB 是在個人開發 MVP 中,以最小幅度新增動態處理的基本架構。

在本專案中,僅將聯絡表單 API 化,而用語、題目、文章與架構圖則以靜態檔案方式提供,藉此壓低成本與實作範圍。