ระดับ 4a · บทที่ 2/5

API Gateway และ Lambda URL — HTTP API vs REST API, auth และ CORS

⏱ 45 นาทีลองในAWS Console ↗
ข้อมูลบางส่วนอาจเปลี่ยน — ตรวจสอบก่อนใช้

บทนี้มีข้อมูลที่เปลี่ยนบ่อย (ฟีเจอร์ ราคา ชื่อเมนู) ตรวจกับเว็บทางการก่อนนำไปใช้

เป้าหมาย

เปิด Lambda ให้เรียกผ่าน HTTP ได้สามแบบ เลือกแบบที่เหมาะ (Function URL, HTTP API, REST API) ตั้ง auth ให้ปลอดภัย ตั้ง CORS ให้ browser เรียกได้เฉพาะโดเมนของเรา และจำกัด rate กันบิลบาน

สามทางสู่ HTTP

Lambda Function URL API Gateway HTTP API API Gateway REST API
คืออะไร URL ตรงของฟังก์ชันเดียว API gateway รุ่นใหม่ เบาและถูก API gateway รุ่นแรก ฟีเจอร์ครบ
ราคา ไม่มีค่าเพิ่ม (จ่ายแค่ Lambda) ~$1.00 ต่อล้าน request ~$3.50 ต่อล้าน request
route หลายเส้น → หลายฟังก์ชัน ❌ (route เองในโค้ด) ✅ ✅
auth AWS_IAM หรือ NONE IAM, JWT (Cognito/Auth0/...), Lambda authorizer IAM, Cognito, Lambda authorizer, API key + usage plan
custom domain ❌ ตรงๆ (ใช้ CloudFront หน้า) ✅ ✅
throttling ต่อ route ❌ (ใช้ reserved concurrency) ✅ ✅ + ต่อ client ด้วย usage plan
อื่นๆ response streaming CORS ในตัว, auto-deploy request validation, cache, WAF ตรง, private API

เลือกง่ายๆ: webhook/ฟังก์ชันเดียว/หลัง CloudFront → Function URL · API ทั่วไปของเว็บ/แอป → HTTP API · ต้องการ API key ขายให้ลูกค้า, WAF ตรง, validation, private API → REST API

⚠️ ต้องตรวจสอบ: ราคาและฟีเจอร์ต่าง region/เปลี่ยนได้ ดู https://aws.amazon.com/api-gateway/pricing/ และหน้า "Choose between REST APIs and HTTP APIs" ในเอกสาร

event ที่ Lambda ได้รับ (payload 2.0)

HTTP API และ Function URL ส่ง event รูปแบบเดียวกัน:

{
  "rawPath": "/hello",
  "rawQueryString": "name=dao",
  "queryStringParameters": { "name": "dao" },
  "headers": { "content-type": "application/json", "origin": "https://example.com" },
  "requestContext": { "http": { "method": "POST", "sourceIp": "203.0.113.10" } },
  "body": "{\"item\":\"latte\"}",
  "isBase64Encoded": false
}

ตอบกลับด้วย { statusCode, headers, body } — body ต้องเป็น string (ใช้ JSON.stringify)

Auth — ใครเรียกได้

วิธี ใช้เมื่อ
NONE / ไม่มี authorizer API สาธารณะจริงๆ (ต้องมี throttling และ validate input เอง)
IAM (SigV4) service-to-service ใน AWS, ข้ามบัญชี
JWT authorizer (HTTP API) ผู้ใช้ล็อกอินผ่าน Cognito/Auth0/Google — gateway ตรวจ token ให้ก่อนถึง Lambda
Lambda authorizer logic เฉพาะ เช่น ตรวจ API key จากฐานข้อมูลของเรา

Function URL แบบ NONE = ใครมี URL ก็เรียกได้และคุณจ่ายทุกครั้ง — ใส่ reserved concurrency จำกัดเพดานเสมอ

CORS ในสองนาที

  • browser ที่หน้าเว็บอยู่ https://example.com เรียก API ที่อีกโดเมน → browser ถามก่อนด้วย preflight OPTIONS แล้วดู header Access-Control-Allow-Origin
  • CORS ไม่ใช่ระบบความปลอดภัยของ API — curl/สคริปต์เรียกได้เสมอ มันแค่บอก browser ว่าหน้าเว็บโดเมนไหนอ่านผลได้
  • ตั้งที่ gateway หรือ Function URL ที่เดียว อย่าตั้งซ้ำในโค้ด Lambda ด้วย (header ซ้ำ → browser ปฏิเสธ)
  • อย่าใช้ * คู่กับ credentials (cookie) — ระบุโดเมนจริง

ลองเลย 🧪

อยู่ในโควตาฟรี/ค่าใช้จ่ายระดับเศษสตางค์ — เก็บกวาดท้ายบท

export AWS_PROFILE=learn   # profile SSO ที่ตั้งไว้ในระดับ 2
export AWS_REGION=ap-southeast-1
aws sso login
export ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
mkdir -p api-lab && cd api-lab

ทดลอง A — ฟังก์ชันที่เข้าใจ HTTP event

cat > trust.json <<'EOF'
{ "Version": "2012-10-17",
  "Statement": [{ "Effect": "Allow", "Principal": { "Service": "lambda.amazonaws.com" }, "Action": "sts:AssumeRole" }] }
EOF
aws iam create-role --role-name lab-api-role --assume-role-policy-document file://trust.json > /dev/null
aws iam attach-role-policy --role-name lab-api-role \
  --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
sleep 10

cat > index.mjs <<'EOF'
const json = (statusCode, data) => ({
  statusCode,
  headers: { "content-type": "application/json; charset=utf-8" },
  body: JSON.stringify(data),
});

export const handler = async (event) => {
  const method = event.requestContext?.http?.method;
  const path = event.rawPath;
  if (method === "GET" && path === "/hello") {
    return json(200, { message: `สวัสดี ${event.queryStringParameters?.name ?? "คุณ"}` });
  }
  if (method === "POST" && path === "/orders") {
    let body;
    try { body = JSON.parse(event.body ?? ""); } catch { return json(400, { error: "body ต้องเป็น JSON" }); }
    if (typeof body.item !== "string" || body.item.length > 50) return json(400, { error: "item ไม่ถูกต้อง" });
    return json(201, { orderId: crypto.randomUUID(), item: body.item });
  }
  return json(404, { error: "not found" });
};
EOF
zip -q fn.zip index.mjs
aws lambda create-function --function-name lab-api-fn --runtime nodejs24.x --architectures arm64 \
  --handler index.handler --zip-file fileb://fn.zip --memory-size 256 --timeout 5 \
  --role arn:aws:iam::$ACCOUNT_ID:role/lab-api-role --query FunctionArn --output text
aws lambda wait function-active-v2 --function-name lab-api-fn

ทดลอง B — Function URL (ต้องเพิ่มสิทธิ์ 2 ข้อ)

FURL=$(aws lambda create-function-url-config --function-name lab-api-fn --auth-type NONE \
  --cors '{"AllowOrigins":["https://example.com"],"AllowMethods":["GET","POST"],"AllowHeaders":["content-type"]}' \
  --query FunctionUrl --output text)
curl -s -o /dev/null -w "ก่อนเพิ่มสิทธิ์: %{http_code}\n" "${FURL}hello"

aws lambda add-permission --function-name lab-api-fn --statement-id url-invoke-url \
  --action lambda:InvokeFunctionUrl --principal '*' --function-url-auth-type NONE > /dev/null
aws lambda add-permission --function-name lab-api-fn --statement-id url-invoke-fn \
  --action lambda:InvokeFunction --principal '*' --invoked-via-function-url > /dev/null
sleep 5
curl -s "${FURL}hello?name=dao"; echo
curl -s -X POST "${FURL}orders" -H 'content-type: application/json' -d '{"item":"latte"}'; echo
curl -s -X POST "${FURL}orders" -H 'content-type: application/json' -d 'not-json'; echo

ผลที่ควรเห็น:

ก่อนเพิ่มสิทธิ์: 403
{"message":"สวัสดี dao"}
{"orderId":"5f0c...","item":"latte"}
{"error":"body ต้องเป็น JSON"}

→ auth type NONE ไม่ได้แปลว่าเปิดเอง ต้องมี resource policy ครบสองข้อ (CLI ไม่สร้างให้ ต่างจาก console)

จำกัดเพดานความเสียหาย:

aws lambda put-function-concurrency --function-name lab-api-fn --reserved-concurrent-executions 5

⚠️ ถ้าบัญชีใหม่มี concurrency รวมต่ำ คำสั่งนี้อาจถูกปฏิเสธเพราะต้องเหลือ unreserved ขั้นต่ำ — ข้ามได้ (ดู quota ด้วย aws lambda get-account-settings)

ทดลอง C — HTTP API แบบ quick create + CORS

API_ID=$(aws apigatewayv2 create-api --name lab-http-api --protocol-type HTTP \
  --target arn:aws:lambda:$AWS_REGION:$ACCOUNT_ID:function:lab-api-fn \
  --cors-configuration '{"AllowOrigins":["https://example.com"],"AllowMethods":["GET","POST"],"AllowHeaders":["content-type"]}' \
  --query ApiId --output text)
aws lambda add-permission --function-name lab-api-fn --statement-id apigw-invoke \
  --action lambda:InvokeFunction --principal apigateway.amazonaws.com \
  --source-arn "arn:aws:execute-api:$AWS_REGION:$ACCOUNT_ID:$API_ID/*" > /dev/null
API=$(aws apigatewayv2 get-api --api-id $API_ID --query ApiEndpoint --output text)

curl -s "$API/hello?name=api"; echo
curl -s -i -X OPTIONS "$API/orders" -H "Origin: https://example.com" \
  -H "Access-Control-Request-Method: POST" | grep -i access-control-allow-origin
curl -s -i -X OPTIONS "$API/orders" -H "Origin: https://evil.example" \
  -H "Access-Control-Request-Method: POST" | grep -i access-control-allow-origin || echo "(ไม่มี header = browser จะบล็อก)"

ผลที่ควรเห็น:

{"message":"สวัสดี api"}
access-control-allow-origin: https://example.com
(ไม่มี header = browser จะบล็อก)

→ quick create สร้าง route $default, integration แบบ proxy และ stage $default ที่ auto-deploy ให้ในคำสั่งเดียว · --source-arn จำกัดให้เฉพาะ API นี้เรียกฟังก์ชันได้

ทดลอง D — throttling กันโดนยิง

aws apigatewayv2 update-stage --api-id $API_ID --stage-name '$default' \
  --default-route-settings ThrottlingBurstLimit=2,ThrottlingRateLimit=1 > /dev/null
sleep 5
for i in $(seq 1 10); do curl -s -o /dev/null -w "%{http_code} " "$API/hello"; done; echo

ผลที่ควรเห็น (ตัวเลขสลับกันได้):

200 200 429 429 200 429 429 429 429 429

→ เกินเพดานได้ 429 Too Many Requests จาก gateway โดยไม่ปลุก Lambda (ไม่เสียค่า Lambda)

ภาคต่อ (อ่านอย่างเดียว) — JWT authorizer กับ Cognito

aws apigatewayv2 create-authorizer --api-id $API_ID --name cognito-jwt \
  --authorizer-type JWT --identity-source '$request.header.Authorization' \
  --jwt-configuration '{"Audience":["[app client id]"],"Issuer":"https://cognito-idp.ap-southeast-1.amazonaws.com/[user pool id]"}'

แล้วผูก authorizer กับ route ที่ต้องล็อกอิน — gateway ปฏิเสธ token ผิด/หมดอายุด้วย 401 ก่อนถึงโค้ดเรา

เก็บกวาด

aws apigatewayv2 delete-api --api-id $API_ID
aws lambda delete-function-url-config --function-name lab-api-fn
aws lambda delete-function --function-name lab-api-fn
aws logs delete-log-group --log-group-name /aws/lambda/lab-api-fn
aws iam detach-role-policy --role-name lab-api-role \
  --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
aws iam delete-role --role-name lab-api-role
cd .. && rm -rf api-lab

กับดักที่เจอบ่อย

อาการ สาเหตุ / แก้
Function URL ได้ 403 ทั้งที่ auth NONE ขาด permission lambda:InvokeFunctionUrl หรือ lambda:InvokeFunction (ต้องมีทั้งคู่)
HTTP API ได้ {"message":"Internal Server Error"} API Gateway ไม่มีสิทธิ์เรียก Lambda (ลืม add-permission) หรือ Lambda คืน body ที่ไม่ใช่ string
browser ขึ้น CORS error แต่ curl ปกติ origin ไม่ตรงทุกตัวอักษร (https://, www, port) หรือ header ซ้ำจากโค้ด + gateway
ส่ง Authorization header แล้ว CORS พัง ไม่ได้ใส่ authorization ใน AllowHeaders
request ยาวแล้วได้ 503/504 integration timeout ของ gateway (ราว 30 วินาที) — งานยาวให้ตอบ 202 แล้วทำต่อแบบ async (บท 03)
บิล Lambda พุ่งจาก URL สาธารณะ ไม่มี throttling/reserved concurrency — ตั้งเพดาน ใช้ CloudFront + WAF หน้า

สรุปจำง่าย

ฟังก์ชันเดียว/webhook → Function URL — API ทั่วไป → HTTP API — ต้องการ API key/WAF/validation → REST API — auth ที่ gateway ก่อนถึงโค้ด — CORS ตั้งที่เดียวและไม่ใช่ความปลอดภัย — ตั้ง throttling และ reserved concurrency เสมอ