Soft ID et suivi des referrals dans l'extension CaptchaAI

Périmètre sûr : Ce guide s'applique exclusivement à 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 décrit ni l'automatisation de sites tiers, ni le contournement de protections, ni l'évasion d'anti-bot.

Le soft ID est l'identifiant que vous attachez à vos appels CaptchaAI pour rattacher chaque résolution à une intégration, un client ou un environnement précis.

Pour une agence qui livre plusieurs intégrations, ce marquage transforme un flux opaque en données d'attribution : vous ventilez la consommation par client et vous isolez les régressions par projet. L'extension se pilote alors comme un workflow de navigateur reproductible, pas comme un simple bouton.

Ce que le soft ID apporte à une agence

Une agence multi-clients doit répondre à une question simple : quelle résolution appartient à quel projet ? Le soft ID, identifiant optionnel joint à chaque tâche, répond sur trois plans :

• Facturation : la consommation se ventile par client.
• Diagnostic : un pic d'appels pointe l'intégration responsable.
• Suivi des referrals : chaque résolution reste reliée à sa source, sans tableau de bord parallèle.

Attacher le soft ID à chaque appel

1. Capturez les entrées exactes du défi sur votre page : sitekey, URL de page, action.
2. Soumettez la tâche à l'API avec le soft ID du client concerné.
3. Interrogez le résultat à intervalle régulier, avec un plafond de tentatives borné.
4. Injectez le token dans la même session que celle qui a déclenché le défi : même contexte de navigateur.
5. Tracez la latence et l'acceptation en aval, ventilées par soft ID.

Gérer la clé API et les secrets

La clé CaptchaAI vit dans un coffre (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault) ou dans un secret CI, jamais dans le code source ; le déploiement la monte en variable d'environnement au runtime. Le soft ID, lui, n'est pas un secret : vous le versionnez avec votre configuration, sous une convention de nommage stable.

Exemple : vérifier le solde avant d'attribuer les résolutions

Vérifiez le solde du compte avant d'attribuer des résolutions. Exemple tiré de votre suite de tests :

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))

Observabilité et suivi par environnement

Séparez les journaux par environnement — développement, préproduction, production — et corrélez-les à votre traçage distribué (OpenTelemetry). Avec le soft ID dans ce contexte, vous rejouez un scénario complet depuis un seul identifiant. Suivez ensuite trois indicateurs, tous ventilés par soft ID :

• Taux de réussite du solveur par famille de CAPTCHA : une baisse localisée trahit un paramètre d'entrée incorrect.
• Acceptation en aval du token : un token résolu n'est pas un workflow réussi ; l'écart entre les deux courbes est le signal utile.
• Latence de première résolution, médiane comme traîne (p95), pour dimensionner vos timeouts.

Liste de contrôle avant la mise en production

• 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 code.
• Le soft ID suit une convention de nommage stable et accompagne chaque appel.
• Un retry idempotent à backoff borné couvre les erreurs transitoires.

Dépannage

FAQ

Qu'est-ce que le soft ID dans l'extension CaptchaAI ?

C'est un identifiant d'attribution optionnel que vous joignez à vos tâches pour en marquer l'origine. Il n'est pas secret : son rôle est de relier chaque résolution à un client ou un environnement.

Comment attribuer les résolutions à chaque client ?

Adoptez une convention de nommage stable pour le soft ID, puis :

• appliquez-la à tous les appels d'un même client ;
• regroupez métriques et journaux par cet identifiant ;
• lisez la consommation par client sans construire de tableau de bord parallèle.

Ce guide couvre-t-il l'automatisation de sites tiers ?

Non. Tous les exemples portent sur vos propres applications ou sur des environnements de test autorisés par écrit. Si une source externe est en jeu, validez d'abord ses conditions d'utilisation et votre base juridique.

Guides connexes

• Le guide de démarrage rapide CaptchaAI
• Tester les CAPTCHA en environnements autorisés
• Tester l'endpoint API sur vos formulaires
• Intégrer la résolution CAPTCHA à votre CI
• Résoudre reCAPTCHA v2 via l'API

Fiabilisez vos workflows CAPTCHA de manière méthodique et traçable. – Obtenez votre clé CaptchaAI.