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

Secrets และ config — Secrets Manager vs Parameter Store, KMS และการหมุนรหัส

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

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

เป้าหมาย

เลือกที่เก็บความลับและค่าคอนฟิกให้ถูกที่ ดึงค่าเข้า Lambda/ECS อย่างปลอดภัยและไม่แพง เข้าใจว่า KMS ปกป้องอะไร และตั้งการหมุนรหัสฐานข้อมูลแบบไม่ต้องมีคนจำ

แยกให้ออกก่อน: config vs secret

ตัวอย่าง ที่เก็บ
config ไม่ลับ ชื่อตาราง, URL บริการอื่น, ขนาด page env var จาก IaC หรือ Parameter Store String
secret รหัส DB, API key ของ Stripe/LINE, signing key Secrets Manager หรือ Parameter Store SecureString
feature flag / ค่าที่เปลี่ยนบ่อยโดยไม่ deploy เปิดฟีเจอร์ให้ 10% AWS AppConfig

ห้ามใส่ secret เป็น ค่าตรงๆ ใน env var ของ Lambda/ECS task definition — ใครมีสิทธิ์ lambda:GetFunctionConfiguration หรือ ecs:DescribeTaskDefinition อ่านได้หมด และค่าจะไปโผล่ใน CloudFormation template/Terraform state

Secrets Manager vs Parameter Store

Secrets Manager Parameter Store (Standard)
ราคา ~$0.40/secret/เดือน + $0.05/10,000 API calls Standard tier ฟรี (Advanced คิดเงินต่อ parameter)
ขนาดสูงสุด 64 KB 4 KB (Advanced 8 KB)
หมุนรหัสอัตโนมัติ มี (managed rotation + Lambda rotation) ไม่มี ต้องทำเอง
แชร์ข้ามบัญชี resource policy ได้ จำกัดกว่า
replicate ข้าม region มี (สำหรับ DR) ไม่มี
เหมาะกับ รหัส DB, credential ที่ต้องหมุน config, API key ที่หมุนเองนานๆ ครั้ง, งบจำกัด

⚠️ ต้องตรวจสอบ: ราคา Parameter Store Advanced/higher throughput และขีดจำกัดจำนวน parameter ดูที่หน้า AWS Systems Manager pricing ของ region คุณ

ตัวเลขที่ต้องคิด: Lambda ที่ดึง secret ทุก invocation, 10M invocation/เดือน = 1,000 × $0.05 = $50/เดือนค่าอ่าน secret เปล่าๆ + โดน throttle ได้ → cache ไว้นอก handler หรือใช้ AWS Parameters and Secrets Lambda Extension (cache ใน local ตาม TTL)

KMS ใน 1 หน้า

  • ทั้งสองบริการเข้ารหัสด้วย KMS envelope encryption: KMS key เข้ารหัส data key → data key เข้ารหัสข้อมูล
  • AWS managed key (aws/secretsmanager, aws/ssm) — ฟรี ใช้ง่าย แต่ แก้ key policy ไม่ได้ แชร์ข้ามบัญชีไม่ได้
  • customer managed key (CMK) — ~$1/key/เดือน + ค่าเรียก API ได้ key policy ของตัวเอง แยกสิทธิ์ "ใช้ key" กับ "จัดการ key" ได้ แชร์ข้ามบัญชีได้ หมุน key material อัตโนมัติได้
  • การอ่าน secret ต้องผ่านสองด่าน: IAM ให้ secretsmanager:GetSecretValue และ สิทธิ์ kms:Decrypt บน key (ถ้าใช้ CMK) — ขาดอันไหนก็ AccessDenied
  • ลบ KMS key ต้อง schedule 7–30 วัน และเมื่อลบแล้วข้อมูลที่เข้ารหัสด้วย key นั้น กู้ไม่ได้ตลอดกาล

การหมุนรหัส (rotation)

วิธี ใช้เมื่อ
RDS/Aurora managed master password (ManageMasterUserPassword) ง่ายที่สุด — RDS สร้างและหมุน secret ใน Secrets Manager ให้เอง ไม่ต้องเขียน Lambda
Managed rotation ของ Secrets Manager สำหรับบางบริการ บริการที่ AWS รองรับ
Lambda rotation function รหัสของระบบภายนอก/ฐานข้อมูลที่ต้องมี logic เอง

กลยุทธ์ใน Lambda rotation:

  • single user — เปลี่ยนรหัสของ user เดิม มีช่วงสั้นๆ ที่ connection ใหม่อาจใช้รหัสเก่า
  • alternating users — สลับใช้ 2 user (app_a/app_b) ไม่มีช่วงล็อก เหมาะกับระบบที่ downtime ไม่ได้
  • แอปต้อง อ่าน secret ใหม่เมื่อ login ล้มเหลว (หรือ TTL cache สั้นกว่ารอบหมุน) ไม่งั้นหมุนแล้วแอปพัง

ลองเลย 🧪

aws sso login --profile dev
export AWS_PROFILE=dev AWS_REGION=ap-southeast-1

ทดลอง A — Parameter Store: config กับ SecureString

aws ssm put-parameter --name /notes/dev/page-size --type String --value 20
aws ssm put-parameter --name /notes/dev/line-token --type SecureString --value "fake-token-123"
aws ssm get-parameters-by-path --path /notes/dev --query "Parameters[].[Name,Type,Value]" --output table
aws ssm get-parameter --name /notes/dev/line-token --with-decryption --query Parameter.Value --output text

ผลที่ควรเห็น: ในตาราง line-token เป็นข้อความเข้ารหัสยาวๆ (AQICAH...) ส่วนคำสั่งสุดท้ายได้ fake-token-123 — การถอดรหัสต้องขอ --with-decryption อย่างชัดเจน และ CloudTrail บันทึกทุกครั้ง

ทดลอง B — Secrets Manager + IAM แบบเจาะจง secret เดียว (⚠️ secret คิด ~$0.40/เดือนแบบ prorate — ลบตอนจบ)

SECRET_ARN=$(aws secretsmanager create-secret --name notes/dev/db \
  --description "lab secret 5a-05" \
  --secret-string '{"username":"app","password":"change-me-lab-only"}' \
  --query ARN --output text)
echo $SECRET_ARN
aws secretsmanager get-secret-value --secret-id notes/dev/db --query SecretString --output text
aws secretsmanager describe-secret --secret-id notes/dev/db --query "[Name,RotationEnabled,KmsKeyId]" --output text

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

arn:aws:secretsmanager:ap-southeast-1:123456789012:secret:notes/dev/db-AbCdEf
{"username":"app","password":"change-me-lab-only"}
notes/dev/db	None	None

(KmsKeyId เป็น None = ใช้ AWS managed key aws/secretsmanager) — สังเกตท้าย ARN มี ตัวอักษรสุ่ม 6 ตัว ดังนั้น IAM policy ควรใช้ notes/dev/db-?????? ไม่ใช่ notes/dev/db* (ซึ่งจะไปตรงกับ notes/dev/db-admin ด้วย)

policy ที่ให้ Lambda อ่านได้เฉพาะ secret นี้ (เอาไปแปะ role ของ function)

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": "secretsmanager:GetSecretValue",
    "Resource": "arn:aws:secretsmanager:ap-southeast-1:[ACCOUNT_ID]:secret:notes/dev/db-??????"
  }]
}

ใน CDK ไม่ต้องเขียนเอง: secret.grantRead(fn) และส่งแค่ ชื่อ/ARN ผ่าน env var

ทดลอง C — โค้ด Lambda ที่ cache secret อย่างถูกต้อง (Node.js 22)

const { SecretsManagerClient, GetSecretValueCommand } = require("@aws-sdk/client-secrets-manager");
const sm = new SecretsManagerClient({});
let cached, fetchedAt = 0;
const TTL_MS = 5 * 60 * 1000;   // สั้นกว่ารอบหมุนรหัสมาก

async function getDbCreds(force = false) {
  if (!force && cached && Date.now() - fetchedAt < TTL_MS) return cached;
  const r = await sm.send(new GetSecretValueCommand({ SecretId: process.env.DB_SECRET_ARN }));
  cached = JSON.parse(r.SecretString);
  fetchedAt = Date.now();
  return cached;
}

exports.handler = async () => {
  const creds = await getDbCreds();
  // ถ้า login DB ล้มเหลวเพราะรหัสผิด → เรียก getDbCreds(true) แล้วลองใหม่ 1 ครั้ง
  return { statusCode: 200, body: JSON.stringify({ user: creds.username }) }; // ห้ามคืน password
};

ทดลอง D — ดูว่าใครอ่าน secret (CloudTrail อาจใช้เวลาหลายนาทีกว่า event จะขึ้น)

aws cloudtrail lookup-events \
  --lookup-attributes AttributeKey=EventName,AttributeValue=GetSecretValue \
  --max-results 5 --query "Events[].[EventTime,Username]" --output table

ทดลอง E (เลือกทำ) — CMK และ key policy ⚠️ KMS key คิด ~$1/เดือน และลบทันทีไม่ได้ (ขั้นต่ำ 7 วัน)

KEY_ID=$(aws kms create-key --description "notes lab key" --query KeyMetadata.KeyId --output text)
aws kms create-alias --alias-name alias/notes-lab --target-key-id "$KEY_ID"
aws kms enable-key-rotation --key-id "$KEY_ID"
aws ssm put-parameter --name /notes/dev/cmk-test --type SecureString --key-id alias/notes-lab --value "x"
aws kms get-key-rotation-status --key-id "$KEY_ID" --query KeyRotationEnabled

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

เก็บกวาด

aws ssm delete-parameters --names /notes/dev/page-size /notes/dev/line-token /notes/dev/cmk-test
aws secretsmanager delete-secret --secret-id notes/dev/db --force-delete-without-recovery
# ถ้าทำทดลอง E (หา KEY_ID จาก alias ก่อนลบ alias เผื่อเปิดเทอร์มินัลใหม่):
KEY_ID=${KEY_ID:-$(aws kms describe-key --key-id alias/notes-lab --query KeyMetadata.KeyId --output text)}
aws kms delete-alias --alias-name alias/notes-lab
aws kms schedule-key-deletion --key-id "$KEY_ID" --pending-window-in-days 7

--force-delete-without-recovery ใช้ในแล็บเท่านั้น — ใน prod ใช้ recovery window (ค่าเริ่มต้น 30 วัน) เผื่อลบผิด ถ้าพัง: delete-parameters ไม่ error ถ้าไม่มีบาง parameter (เช่น ไม่ได้ทำทดลอง E) — ชื่อนั้นจะอยู่ใน InvalidParameters ของผลลัพธ์ · AccessDeniedException ... kms:Decrypt → role มีสิทธิ์อ่าน secret แต่ไม่มีสิทธิ์ใช้ CMK

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

อาการ สาเหตุ / แก้
รหัส DB โผล่ใน cdk.out/CloudFormation template ส่ง secret เป็นค่าใน env var หรือ unsafeUnwrap() — ส่งแค่ ARN แล้วให้โค้ดดึงเอง หรือใช้ ECS secrets (ดึงตอน start task)
บิล Secrets Manager API พุ่ง / throttling ดึงทุก invocation — cache นอก handler หรือใช้ Lambda extension
หมุนรหัสแล้วแอปพังทั้งระบบ แอป cache รหัสเก่าตลอดอายุ container — TTL สั้น + refetch เมื่อ auth fail, หรือใช้ alternating users
policy secret:notes/dev/db* ให้สิทธิ์เกิน ตรงกับ secret อื่นที่ขึ้นต้นเหมือนกัน — ใช้ -??????
แชร์ secret ข้ามบัญชีไม่ได้ ใช้ AWS managed key อยู่ — เปลี่ยนเป็น CMK + resource policy ทั้ง secret และ key
ลบ KMS key แล้ว backup เก่าเปิดไม่ได้ ข้อมูลผูกกับ key ตลอดไป — ใช้ disable-key ก่อนเพื่อดูผลกระทบ แทนการ schedule deletion ทันที

สรุปจำง่าย

config ไม่ลับ → env/Parameter Store, secret → Secrets Manager (หมุนได้) หรือ SecureString (ถูก) — env var ใส่แค่ ARN ไม่ใส่ค่า — cache secret นอก handler — อ่านได้ต้องผ่าน IAM + KMS — DB ใช้ managed master password — ลบ key คือข้อมูลหายถาวร