ระดับ 6c · บทที่ 2/5

บอทและ Turnstile — กันบอทโดยไม่ทำร้ายผู้ใช้จริง, API และ Googlebot

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

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

เป้าหมาย

เลือกเครื่องมือกันบอทให้เหมาะกับแพลนและชนิดทราฟฟิก, ไม่เผลอบล็อก API/แอปมือถือ/webhook/Googlebot, และใส่ Turnstile ในฟอร์มสมัคร/ล็อกอิน พร้อม ตรวจ token ฝั่งเซิร์ฟเวอร์ อย่างถูกต้อง

บอทมีหลายแบบ — ไม่ใช่ทุกตัวคือศัตรู

ประเภท ตัวอย่าง ควรทำ
Verified bot ที่ดี Googlebot, Bingbot, uptime monitor ให้ผ่าน (SEO/monitoring พังถ้าบล็อก)
AI crawler บอทเก็บข้อมูลไปเทรนโมเดล ตัดสินตามนโยบายธุรกิจ (เปิด/ปิดได้ทุกแพลน)
ลูกค้าที่เป็นโปรแกรม แอปมือถือ, partner API, webhook ห้าม challenge — ยืนยันด้วย API key/mTLS/HMAC
บอทร้าย credential stuffing, scalper, scraper, สแปมฟอร์ม challenge/บล็อก + rate limit + Turnstile

Cloudflare แยกบอทยืนยันตัวตนด้วย Web Bot Auth (ลายเซ็น), IP ที่ประกาศ หรือ reverse DNS และ (ตั้งแต่ ก.ค. 2026) จัดหมวดตามพฤติกรรม (Search, Agent, Training ฯลฯ) และป้าย Direct / Intermediary ใน BotBase — ใน expression ใช้ cf.client.bot ว่าเป็น verified bot หรือไม่

เครื่องมือตามแพลน

Bot Fight Mode Super Bot Fight Mode Bot Management
แพลน Free Pro / Business Enterprise
ปรับแต่ง เปิด/ปิด ทั้งโดเมน เลือก action ต่อหมวด (definitely/likely automated, verified bots) bot score 1–99 ใช้ใน custom rule (cf.bot_management.score)
ยกเว้นบาง path/ลูกค้า ❌ ทำไม่ได้เลย (ไม่ได้รันบน Ruleset Engine) ✅ skip เฟส http_request_sbfm ✅ เขียน expression เอง
เหมาะกับ เว็บเนื้อหาล้วน ไม่มี API เว็บ + API ที่ต้องยกเว้น ระบบใหญ่ที่บอทเป็นปัญหาธุรกิจ

คำเตือนสำคัญเรื่อง Bot Fight Mode: เปิดแล้วอาจ challenge แอปมือถือ, webhook และ API client — และ custom rule skip ไม่ได้ (IP Access rule ที่ match ก่อนช่วยได้บางกรณี) ถ้าโดเมนมี API ให้แยก API ไปโดเมน/โซนอื่น หรือใช้ Super Bot Fight Mode JavaScript Detections เปิดอัตโนมัติ → ถ้ามี CSP ต้องอนุญาต /cdn-cgi/challenge-platform/ (script-src 'self')

Turnstile — CAPTCHA ที่คนแทบไม่ต้องทำอะไร

เบราว์เซอร์ ── widget รันการตรวจ ──► ได้ token (cf-turnstile-response)
     │ ส่งฟอร์ม + token
     ▼
Worker/เซิร์ฟเวอร์ ── POST siteverify(secret, token, remoteip) ──► Cloudflare ── {success, hostname, action, error-codes}

ฝั่งเซิร์ฟเวอร์คือส่วนที่ป้องกันจริง — widget อย่างเดียวไม่กันอะไร เพราะคนร้ายส่ง string อะไรมาก็ได้

กฎของ token ผล
อายุ 300 วินาที ผู้ใช้เปิดฟอร์มทิ้งไว้นาน → ต้อง refresh widget
ใช้ได้ครั้งเดียว ส่งซ้ำได้ error timeout-or-duplicate → retry siteverify ใช้ idempotency_key เดิม
ยาว ≤ 2048 ตัวอักษร ตรวจความยาวก่อนส่ง

ตรวจให้ครบ: success === true และ hostname เป็นโดเมนของเรา และ action ตรงกับฟอร์ม (กัน token จากฟอร์มอื่น/เว็บอื่นมาใช้) widget มี 3 โหมด: managed (แนะนำ — ส่วนใหญ่ไม่ต้องคลิก), non-interactive, invisible

test keys (ใช้ได้ทุกโดเมนรวม localhost — ห้ามใช้ใน production)

sitekey secret
ผ่านเสมอ 1x00000000000000000000AA 1x0000000000000000000000000000000AA
ไม่ผ่านเสมอ 2x00000000000000000000AB 2x0000000000000000000000000000000AA
token ถูกใช้แล้ว — 3x0000000000000000000000000000000AA

ลองเลย 🧪

ทดลอง A — ฟอร์มสมัครสมาชิกบน Worker พร้อม Turnstile

npm create cloudflare@latest -- signup-turnstile   # Hello World example → Worker only → TypeScript → Deploy: No
cd signup-turnstile

เพิ่มใน wrangler.jsonc:

"vars": {
  "TURNSTILE_SITEKEY": "1x00000000000000000000AA",
  "EXPECTED_HOSTNAME": ""
}

สร้าง .dev.vars (ไฟล์นี้อยู่ใน .gitignore ของ C3 แล้ว — ตรวจด้วย git check-ignore .dev.vars):

echo 'TURNSTILE_SECRET=1x0000000000000000000000000000000AA' > .dev.vars
git check-ignore .dev.vars

src/index.ts:

interface Env {
  TURNSTILE_SITEKEY: string;
  TURNSTILE_SECRET: string;
  EXPECTED_HOSTNAME: string;
}

type Siteverify = { success: boolean; "error-codes": string[]; hostname?: string; action?: string };

const page = (sitekey: string) => `<!doctype html>
<html lang="th"><head><meta charset="utf-8"><title>สมัครสมาชิก</title>
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script></head>
<body><form method="POST" action="/signup">
  <input name="email" type="email" required placeholder="[email protected]">
  <div class="cf-turnstile" data-sitekey="${sitekey}" data-action="signup"></div>
  <button>สมัคร</button>
</form></body></html>`;

async function verify(env: Env, token: string, ip: string): Promise<Siteverify> {
  const idempotency_key = crypto.randomUUID();
  for (let attempt = 1; attempt <= 2; attempt++) {
    try {
      const res = await fetch("https://challenges.cloudflare.com/turnstile/v0/siteverify", {
        method: "POST",
        headers: { "content-type": "application/json" },
        body: JSON.stringify({ secret: env.TURNSTILE_SECRET, response: token, remoteip: ip, idempotency_key }),
      });
      if (res.ok) return await res.json<Siteverify>();
    } catch {
      // เน็ตสะดุด → ลองอีกครั้งด้วย idempotency_key เดิม (token ไม่ถูกนับว่าใช้ซ้ำ)
    }
  }
  return { success: false, "error-codes": ["internal-error"] };
}

export default {
  async fetch(request, env): Promise<Response> {
    const url = new URL(request.url);
    if (request.method === "GET" && url.pathname === "/") {
      return new Response(page(env.TURNSTILE_SITEKEY), { headers: { "content-type": "text/html; charset=utf-8" } });
    }
    if (request.method === "POST" && url.pathname === "/signup") {
      const form = await request.formData();
      const token = String(form.get("cf-turnstile-response") ?? "");
      if (!token || token.length > 2048) return new Response("กรุณายืนยันว่าไม่ใช่บอท", { status: 400 });
      const ip = request.headers.get("CF-Connecting-IP") ?? "";
      const r = await verify(env, token, ip);
      const hostOk = !env.EXPECTED_HOSTNAME || r.hostname === env.EXPECTED_HOSTNAME;
      const actionOk = !env.EXPECTED_HOSTNAME || r.action === "signup";   // ตรวจเข้มเมื่อใช้ key จริง
      if (!r.success || !hostOk || !actionOk) {
        console.warn({ event: "turnstile_fail", codes: r["error-codes"], hostname: r.hostname, action: r.action });
        return new Response("ยืนยันไม่ผ่าน ลองใหม่อีกครั้ง", { status: 403 });
      }
      // ...สร้างบัญชีจริงตรงนี้ (และ rate limit ต่อ IP/อีเมลเพิ่มอีกชั้น)
      return new Response("สมัครสำเร็จ", { status: 201 });
    }
    return new Response("not found", { status: 404 });
  },
} satisfies ExportedHandler<Env>;
npx wrangler dev

เปิด http://localhost:8787 เห็น widget แบบทดสอบ กดสมัคร → สมัครสำเร็จ · ทดสอบด้วย curl ด้วย dummy token:

curl -s -X POST http://localhost:8787/signup -d "[email protected]" -d "cf-turnstile-response=XXXX.DUMMY.TOKEN.XXXX" -w " %{http_code}\n"
curl -s -X POST http://localhost:8787/signup -d "[email protected]" -w " %{http_code}\n"

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

สมัครสำเร็จ 201
กรุณายืนยันว่าไม่ใช่บอท 400

เปลี่ยน .dev.vars เป็น secret 2x…AA แล้วรันใหม่ → ยืนยันไม่ผ่าน ลองใหม่อีกครั้ง 403 และใน terminal เห็น turnstile_fail · ลอง 3x…AA → error code timeout-or-duplicate

ทดลอง B — ใช้ key จริงบนโดเมนของคุณ

  1. แดชบอร์ดบัญชี › Turnstile › Add widget → ชื่อ signup, hostname = โดเมนของคุณ, mode Managed → ได้ sitekey + secret
  2. ตั้งค่า (secret ไม่อยู่ในไฟล์ใดๆ):
npx wrangler secret put TURNSTILE_SECRET

แก้ vars ใน wrangler.jsonc: "TURNSTILE_SITEKEY": "[sitekey จริง]", "EXPECTED_HOSTNAME": "signup.[your-domain.example]" แล้วผูก custom domain ตามระดับ 4c

npx wrangler deploy

ส่งฟอร์มจากเบราว์เซอร์ → สำเร็จ · ส่ง token เดิมซ้ำด้วย curl (คัดลอกจาก DevTools › Network) → 403 พร้อม timeout-or-duplicate ใน log 3. ดูสถิติ challenge/solve ใน Turnstile › signup › Analytics

ทดลอง C — ไม่บล็อก Googlebot ในกฎประเทศ (ต่อจากบท 01) แก้กฎ /admin เป็น expression นี้ แล้วสังเกตใน Security Events ว่า verified bot ไม่โดน challenge:

starts_with(lower(http.request.uri.path), "/admin") and ip.src.country ne "TH" and not cf.client.bot

เก็บกวาด: npx wrangler delete · ลบ widget ทดลองใน Turnstile ถ้าไม่ใช้ · ตรวจว่า .dev.vars ไม่ถูก commit (git log --all -- .dev.vars ต้องว่าง)

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

อาการ สาเหตุ / แก้
ใส่ widget แล้วสแปมยังเข้า ไม่ได้เรียก siteverify ฝั่งเซิร์ฟเวอร์ — widget ไม่ใช่การป้องกัน
ผู้ใช้ส่งฟอร์มช้าแล้วโดนปฏิเสธ token หมดอายุ 300 วิ — ใช้ callback expired-callback/refresh widget ก่อนส่ง
retry siteverify แล้วได้ timeout-or-duplicate token ใช้ได้ครั้งเดียว — ส่ง idempotency_key เดิมตอน retry
แอปมือถือ/webhook พังหลังเปิด Bot Fight Mode BFM challenge ทุกอย่างที่ดูเป็นอัตโนมัติและ skip ไม่ได้ — แยกโดเมน API หรือใช้ Super Bot Fight Mode
หน้าเว็บ error เรื่อง CSP หลังเปิด BFM JavaScript Detections ถูกฉีด script — อนุญาต /cdn-cgi/challenge-platform/ ใน CSP
เว็บหายจาก Google บล็อก/challenge verified bot — ใส่ not cf.client.bot ในกฎ
ใช้ test key บน production ผ่านทุก request = ไม่มีการป้องกัน — แยก key ตาม environment และตรวจ hostname

สรุปจำง่าย

บอทดีต้องผ่าน (cf.client.bot), ลูกค้าที่เป็นโปรแกรมยืนยันด้วย key ไม่ใช่ challenge — Bot Fight Mode skip ไม่ได้ ระวัง API — Turnstile ต้องตรวจ siteverify ฝั่งเซิร์ฟเวอร์ เช็ก success + hostname + action — token 300 วิ ใช้ครั้งเดียว retry ใช้ idempotency_key — test key เฉพาะ dev