Panduan migrasi

Migrasi dari Friendly Captcha ke CaptchaLa

Pendirian mengutamakan privasi yang sama. Pasang CaptchaLa, dapatkan SDK mudah alih, ketersediaan tanah besar China, dan cabaran sandaran yang kelihatan. Migrasi hanyalah dua perubahan fail.

FFriendly CaptchaCurrent setup~10 minCaptchaLaDrop-in target

Bagaimana rupa perubahan kod

Before — Friendly Captcha
<div class="frc-captcha" data-sitekey="YOUR_SITE_KEY"></div>
<script type="module" src="https://cdn.jsdelivr.net/npm/@friendlycaptcha/sdk/site.compat.min.js" async defer></script>
After — CaptchaLa
<button id="login-btn">Sign in</button>
<script src="https://cdn.captcha-cdn.net/captchala-loader.js"></script>
<script>
  loadCaptchala(() => Captchala.init({ appKey: 'YOUR_APP_KEY', action: 'login' })
    .onSuccess(res => onToken(res.token))
    .bindTo('#login-btn'));
</script>
Before — Friendly Captcha server verify (Node)
const res = await fetch('https://api.friendlycaptcha.com/api/v1/siteverify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    secret: process.env.FRIENDLY_SECRET,
    solution: req.body['frc-captcha-solution'],
    sitekey: process.env.FRIENDLY_SITEKEY,
  }),
})
const data = await res.json()
if (!data.success) return res.status(400).json({ error: 'bot' })
After — CaptchaLa server verify (Node)
const res = await fetch('https://apiv1.captcha.la/v1/validate', {
  method: 'POST',
  headers: {
    'X-App-Key': process.env.CAPTCHALA_APP_KEY,
    'X-App-Secret': process.env.CAPTCHALA_APP_SECRET,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ pass_token: req.body['captchala-token'] }),
})
const { data } = await res.json()
if (!data || !data.valid) return res.status(400).json({ error: 'bot' })

Langkah migrasi

  1. 1

    Daftar & dapatkan App Key + Secret anda

    Cipta akaun CaptchaLa percuma, tambah satu tapak, salin kunci anda. Tiada panggilan jualan, tiada kontrak.

  2. 2

    Tukar tag widget

    Gantikan frc-captcha dengan captchala, data-sitekey dengan data-app-key, dan script src dengan CDN kami. Skrip jenis module menjadi skrip async biasa.

  3. 3

    Kemas kini nama medan tersembunyi

    Friendly Captcha menyerahkan frc-captcha-solution; kami menyerahkan captchala-token. Namakan semula dalam pengendali borang anda jika anda membacanya mengikut nama.

  4. 4

    Kemas kini pengesahan pelayan

    Endpoint bertukar kepada apiv1.captcha.la/v1/validate. Badan membuang medan sitekey — kami mengenal pasti tapak dari appSecret anda. Bendera valid bentuk respons (data.valid) kekal sama.

  5. 5

    Lancarkan secara berperingkat

    Tukar satu borang pada satu masa. CaptchaLa wujud bersama Friendly Captcha — ia tidak berkongsi kuki atau keadaan. Kebanyakan pasukan mendapati penukaran bertambah baik sedikit kerana pengiraan POW pada peranti pengguna telah tiada.

Soalan lazim

Adakah saya akan kehilangan kisah privasi yang boleh diaudit?

Seni bina hanya-POW Friendly Captcha lebih boleh diaudit dalam erti kriptografi secara literal — benar-benar tiada apa untuk dicap-jari. CaptchaLa juga tidak mengecap-jari, tetapi seni bina kami (risiko adaptif + cabaran) lebih kompleks, menjadikan audit lebih sukar. Jika kriteria gerbang privasi anda ialah 'boleh diaudit oleh peguam privasi dengan kepakaran kriptografi,' itu perbezaan sebenar yang patut ditimbang.

Bagaimana pula dengan mudah alih?

Ini adalah salah satu kemenangan migrasi terbesar. Friendly Captcha hanya untuk web. CaptchaLa mempunyai SDK iOS, Android, dan Flutter asli — backend sama, papan pemuka sama, pengebilan sama. Lancarkan CAPTCHA dalam aplikasi mudah alih anda tanpa memilih vendor kedua.

Bagaimana pengguna saya merasai perbezaannya?

Pada telefon lama dan komputer riba spesifikasi rendah, pengiraan POW yang dijalankan Friendly Captcha di latar belakang boleh terasa — beberapa saat penggunaan CPU. CaptchaLa tidak menjalankan pengiraan berat pada peranti. Kebanyakan pengguna tidak akan perasan, namun pengguna dengan perkakasan lemah akan kurang perasan kami.