Guide de migration

Migrer d'Arkose FunCAPTCHA vers CaptchaLa

Allégez le poids du SDK, mettez fin au contrat entreprise, conservez une défense adaptative contre les bots. La migration se résume à un remplacement de script et un changement d'endpoint de vérification.

AArkose / FunCAPTCHACurrent setup~10 minCaptchaLaDrop-in target

À quoi ressemble le changement de code

Avant — Arkose / FunCAPTCHA
<script src="https://YOUR_PUBLIC_KEY.arkoselabs.com/v2/YOUR_PUBLIC_KEY/api.js" data-callback="onSuccess" async defer></script>
<script>
  function onSuccess(token) {
    document.getElementById('arkose-token').value = token
  }
</script>
<input type="hidden" id="arkose-token" name="arkose-token" />
Après — 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>
Avant — vérification serveur Arkose (Node)
const res = await fetch('https://verify-api.arkoselabs.com/api/v4/verify/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    private_key: process.env.ARKOSE_PRIVATE_KEY,
    session_token: req.body['arkose-token'],
  }),
})
const data = await res.json()
if (data.session_details?.solved !== true) return res.status(400).json({ error: 'bot' })
Après — vérification serveur CaptchaLa (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' })

Étapes de migration

  1. 1

    Inscrivez-vous et récupérez votre App Key + Secret

    Créez un compte CaptchaLa gratuit. Contrairement à Arkose, aucun PoC ni achat — la tarification est publiée et en libre-service. Le palier gratuit couvre les premiers tests.

  2. 2

    Retirez le SDK Arkose et le câblage du callback

    Supprimez la balise script Arkose, la fonction de callback et le champ caché que vous renseignez depuis le callback. CaptchaLa utilise un simple div d'emplacement — sans câblage de callback.

  3. 3

    Ajoutez le widget CaptchaLa

    Insérez notre div et notre balise script à l'emplacement du widget Arkose. Le champ de token caché est renseigné automatiquement sous le nom captchala-token ; vous ne le gérez pas manuellement.

  4. 4

    Mettez à jour la vérification serveur

    Remplacez le contrôle session_details.solved d'Arkose par notre indicateur valid (data.valid). L'endpoint devient apiv1.captcha.la/v1/validate. Le corps devient du JSON au lieu de form-urlencoded.

  5. 5

    Planifiez la fin du contrat

    Les contrats Arkose sont généralement annuels avec reconduction automatique. Notez la fenêtre de résiliation de votre contrat et donnez le préavis au service juridique / achats. La plupart des équipes font tourner les deux solutions en parallèle pendant 30 jours durant la transition.

Questions fréquentes

Vais-je perdre en précision de détection des bots en changeant ?

Pour la plupart des charges de travail, aucune différence mesurable. Les challenges d'Arkose sont volontairement plus difficiles que les nôtres par défaut, mais la population de bots qu'ils attrapent et celle que nous attrapons se recoupent largement pour un trafic produit typique. Si vous êtes à l'échelle de Roblox / Microsoft avec des adversaires nommés, la réponse est plus nuancée — parlons-en d'abord.

Comment gérer le chevauchement de contrat ?

Faites tourner les deux côte à côte durant la transition. Le formulaire A garde Arkose ; le formulaire B passe à CaptchaLa. Comparez la conversion + le taux de bots. La plupart des équipes constatent que le taux de bots reste stable et que la friction utilisateur baisse. Mettez ensuite Arkose hors service au renouvellement du contrat.

Et la télémétrie de risque / les tableaux de bord analytiques d'Arkose ?

CaptchaLa dispose de son propre tableau de bord avec une télémétrie comparable — taux de challenge, taux de réussite, distribution des scores de risque, répartition géographique. La présentation vous semblera familière si vous venez d'Arkose Insights.