Réglages du User-Agent dans l'extension CaptchaAI

Périmètre sûr : ce guide s'applique uniquement à vos propres applications, à vos environnements de QA, de préproduction ou de production, ou à des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne concerne pas l'automatisation de sites tiers que vous ne contrôlez pas.

Le champ User-Agent de l'extension CaptchaAI détermine l'identité que votre navigateur annonce pendant qu'il résout un défi CAPTCHA. Bien réglé, il reste cohérent d'une session à l'autre et votre workflow tourne sans surprise en CI ; mal réglé, il change à chaque exécution et multiplie les rejets de token après résolution.

L'objectif : faire de l'extension un maillon reproductible de votre navigateur, pas un réglage ponctuel qui casse à la première montée de version.

Ce que règle réellement le User-Agent

Le User-Agent n'est pas un détail cosmétique. Il accompagne chaque requête, il est journalisé côté serveur et il fait partie du contexte que la page associe à votre session. Quatre éléments doivent rester stables ensemble : l'état du compte, le profil du navigateur, le type de CAPTCHA sélectionné par l'extension et le comportement après résolution. C'est là que naît la plupart de la charge de support autour de l'extension.

Aligner le User-Agent sur le profil du navigateur

Un profil de navigateur porte des cookies, un stockage local et un User-Agent. Si l'extension présente une chaîne qui contredit le profil réellement utilisé, la page reçoit des signaux incohérents et le token peut être refusé alors même que la résolution a réussi. La règle : un profil, un User-Agent, sans changement en cours de session.

Exemple concret : une équipe de QA à Lyon exécute ses tests de checkout sur un worker hébergé chez Scaleway (région Paris). En figeant le User-Agent dans le profil du worker et en le versionnant avec la configuration, elle a supprimé des rejets intermittents propres à la préproduction. Côté RGPD, une chaîne User-Agent peut être journalisée : ne consignez que le strict nécessaire au diagnostic.

Configuration, étape par étape

1. Choisissez le profil de navigateur dédié à ce workflow, puis ouvrez les réglages de l'extension CaptchaAI.
2. Renseignez la clé API CaptchaAI depuis un secret CI ou un coffre — jamais en clair dans le profil.
3. Fixez le User-Agent une seule fois, cohérent avec le profil, et notez-le dans votre configuration versionnée.
4. Sélectionnez le type de CAPTCHA attendu par la page ; gardez le même couple envoi/interrogation pour toutes les familles.
5. Vérifiez que le token est appliqué dans la même session que celle qui a déclenché le défi.

Liste de contrôle avant intégration

• Le périmètre reste limité à vos propres applications ou à des sources autorisées.
• La clé CaptchaAI est stockée dans un secret CI ou un coffre, jamais dans le profil ni le code source.
• Le User-Agent est figé, cohérent avec le profil, et versionné avec la configuration.
• Le token est appliqué dans la même session que le défi.
• Une stratégie de retry idempotent, avec backoff exponentiel borné, couvre les erreurs transitoires.

Vérifier le solde et instrumenter les appels

Ces points validés, contrôlez le solde du compte avant chaque campagne. Cet appel côté client, extrait de votre propre suite de tests, suffit :

import os
import requests

API_KEY = os.environ['CAPTCHAAI_KEY']

def get_balance() -> float:
    resp = requests.post(
        'https://api.captchaai.com/getBalance',
        json={'clientKey': API_KEY},
        timeout=15,
    )
    resp.raise_for_status()
    return float(resp.json().get('balance', 0))

Quel que soit le langage, instrumentez ensuite les appels CAPTCHA : durée d'obtention du token, code retour HTTP, identifiant de tâche et taille de la file d'attente. Séparez les journaux par environnement et corrélez-les à un identifiant de traçage unique (OpenTelemetry) pour rejouer un incident.

FAQ

Faut-il modifier le User-Agent par défaut de l'extension ?

Seulement si votre workflow l'exige. Ce qui compte n'est pas la valeur exacte, mais sa cohérence : une chaîne stable, alignée sur le profil, vaut mieux qu'un User-Agent « réaliste » qui change à chaque exécution.

Le User-Agent influence-t-il le taux de réussite de la résolution ?

Pas la résolution elle-même, mais l'acceptation du token en aval. Un User-Agent qui contredit le profil, ou qui varie en cours de session, est une cause fréquente de rejet après résolution.

Quels types de CAPTCHA l'extension prend-elle en charge ?

Les familles reCAPTCHA v2 et v3, Cloudflare Turnstile et Challenge, GeeTest v3, ainsi que les CAPTCHA image/OCR et en grille ; CaptchaFox (bêta), Friendly Captcha (bêta) et Lemin (bêta) en complément. hCaptcha et FunCaptcha ne sont pas pris en charge.

Comment garder un User-Agent cohérent en CI ?

Stockez-le dans la configuration versionnée du profil, avec la clé API. La facturation de CaptchaAI reposant sur les threads — BASIC ($15/mois, 5 threads) —, vous pouvez multiplier les workers de test sans coût par résolution, à condition que chaque profil garde son User-Agent.

Guides connexes

• Démarrage rapide CaptchaAI
• QA CAPTCHA en environnements autorisés
• Tester l'endpoint API sur vos formulaires
• Intégration CAPTCHA dans votre CI
• Résoudre reCAPTCHA v2 via l'API

Faites de l'extension CaptchaAI un maillon reproductible de vos tests. – Obtenez votre clé CaptchaAI.