---
type: how-to
title: Migrasi dari Cloudflare Turnstile
summary: "Tukar Cloudflare Turnstile dengan Caputchin dengan perubahan minimal: bentuk widget-klien-plus-verify-server yang sama memetakan hampir satu-lawan-satu, dan seperti Turnstile hasilnya adalah lolos/gagal yang bersih, inilah sebelum-dan-sesudah."
---

Caputchin memakai model dua-bagian yang sama dengan Cloudflare Turnstile, sebuah widget di halaman yang menghasilkan token, dan pemeriksaan sisi-server yang memastikannya, jadi migrasi sebagian besar adalah tukar mekanis, bukan penulisan-ulang. Turnstile adalah yang paling dekat dari penyedia umum ke Caputchin, karena keduanya mengembalikan lolos/gagal otoritatif ketimbang skor risiko, jadi tak ada ambang untuk disetel-ulang. Panduan ini memberi sebelum-dan-sesudah untuk tiap potongan.

Jika kamu belum membuat akun Caputchin dan kunci situs, lakukan [buat akunmu](/docs/getting-started/create-your-account) dulu; kamu akan butuh **public key** (`cpt_pub_...`) untuk halaman dan **secret** (`cpt_sec_...`) untuk backend-mu, pemisahan yang sama dengan site key dan secret key Turnstile.

## Model mental tak berubah

```mermaid
flowchart LR
  A["Widget di halamanmu"] -->|token| B["Formulir / permintaanmu"]
  B -->|token| C["Backend-mu"]
  C -->|secret + token| D["Endpoint siteverify"]
  D -->|success?| C
```

Semua yang sudah kamu bangun di sekitar Turnstile, render widget, kumpulkan token, POST ke servermu, verifikasi sebelum memercayai permintaan, tetap. Hanya nama dan endpoint yang berubah.

## 1. Tukar cuplikan klien

| | Turnstile | Caputchin |
|---|---|---|
| Skrip | `<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer>` | `<script src="https://cdn.jsdelivr.net/npm/@caputchin/widget@3/dist/widget.js">` |
| Elemen | `<div class="cf-turnstile" data-sitekey="...">` | `<caputchin-widget sitekey="cpt_pub_...">` |
| Field token di formulir | `cf-turnstile-response` (disuntik-otomatis) | `caputchin-token` (disuntik-otomatis) |
| Membaca token di JS | `turnstile.getResponse()` | `detail.token` [event `pass`](/docs/references/widget-methods-and-events) |

Seperti Turnstile, widget Caputchin **menyuntik-otomatis sebuah field token tersembunyi** ke formulir tempat ia berada, jadi jika formulirmu sudah melakukan POST biasa, kamu hanya mengubah elemen dan nama field yang dibaca backend-mu. Lihat [tambahkan widget](/docs/getting-started/add-the-widget) untuk penyiapan klien lengkap dan [pilihan CDN vs npm](/docs/integration-guides/cdn).

## 2. Tukar verify server

Di sinilah keduanya paling dekat, bentuk permintaan dan respons sejajar hampir field demi field.

| | Turnstile | Caputchin |
|---|---|---|
| Endpoint | `POST https://challenges.cloudflare.com/turnstile/v0/siteverify` | `POST https://verify.caputchin.com/v1/siteverify` |
| Field permintaan | `secret`, `response` | `secret`, `response` (identik) |
| Respons | `{ success, challenge_ts, hostname, "error-codes", action, cdata }` | `{ success, challenge_ts, hostname, error-codes }` |
| Aturan kepercayaan | bertindak hanya jika `success === true` | bertindak hanya jika `success === true` (identik) |

Di kebanyakan stack satu-satunya perubahan pada kode verifikasimu adalah URL dan nilai secret; keduanya sudah bercabang pada `success`, jadi tak ada ambang skor untuk dipindahkan. Turnstile juga menerima JSON untuk panggilan verify, persis seperti Caputchin, jadi bentuk body terbawa tak berubah. Referensi permintaan/respons penuh, termasuk kode galat, ada di [verifikasi token di backend-mu](/docs/integration-guides/verify-on-your-backend); cuplikan framework ada di [contoh backend](/docs/integration-guides/backend-examples).

Jika integrasi Turnstile-mu membaca `action` atau `cdata` dari respons, perhatikan Caputchin tak punya padanan langsung; itu adalah label khusus-Turnstile yang kamu setel pada widget. Metadata analog Caputchin (game mana yang dimainkan, skornya) hidup di blok `platform` respons dan hanya informasional.

## Apa yang terbawa, dan apa yang jadi lebih baik

- **Tetap lolos/gagal yang bersih.** Kamu menjaga aturan kepercayaan paling sederhana, `if (success)`, tanpa probabilitas atau ambang untuk dipelihara.
- **Sikap privasi yang menjadi alasanmu memilih Turnstile, tetap.** Caputchin tak mengumpulkan IP, User-Agent, sidik jari, atau telemetri perilaku; protokol tak punya tempat untuk menaruh pengenal pengunjung. Lihat [filosofi](/docs/understanding-caputchin/philosophy).
- **Game opsional.** Alih-alih tantangan tak-kasatmata atau terkelola, kamu bisa mengubah verifikasi menjadi game pendek yang sungguh dimainkan pengunjungmu, dan ia bagian yang bertahan melawan pemecah AI. Lihat [tambahkan game](/docs/getting-started/add-a-game).
- **CSP ketat tetap ketat.** Caputchin berjalan di bawah Content-Security-Policy yang rapat; kamu mengizinkan beberapa origin ketimbang melonggarkan kebijakanmu. Lihat [bagaimana Caputchin men-sandbox game](/docs/understanding-caputchin/game-sandboxing#the-csp-you-set-on-your-own-page).

## Hal yang sering terlewat

- **Dua key, dua rumah.** Public key (`cpt_pub_...`) masuk ke halaman; secret (`cpt_sec_...`) tetap hanya di sisi-server, persis disiplin Turnstile. Jangan kirim secret ke peramban.
- **Token sekali-pakai.** Seperti Turnstile, sebuah token terverifikasi sekali. Jangan cache atau putar-ulang ia.
- **Ubah nama field yang dibaca backend-mu.** Field tersembunyinya `caputchin-token`, bukan `cf-turnstile-response`, kelewatan satu-baris yang umum.
- **Tanpa `action` / `cdata`.** Jika kamu bercabang pada itu, pindahkan logika itu ke tempat lain; Caputchin tak membawanya.

## Lihat juga

- [Tambahkan widget](/docs/getting-started/add-the-widget): penyiapan klien lengkap.
- [Verifikasi token di backend-mu](/docs/integration-guides/verify-on-your-backend): referensi `siteverify` otoritatif.
- [Contoh backend](/docs/integration-guides/backend-examples): panggilan verify di tiap bahasa.
- [Tambahkan game](/docs/getting-started/add-a-game): ubah verifikasi menjadi game.