Passez de reCAPTCHA à hCaptcha

Passer de reCAPTCHA à hCaptcha est simple. Vous trouverez ci-dessous un guide étape par étape pour vous aider dans cette mise à jour.

remarque

Vous n'avez pas besoin de modifier vos fonctions de rappel ni les attributs de vos balises. hCaptcha est compatible avec l'API reCAPTCHA.

Obtenez votre clé de site et votre clé secrète hCaptcha

1. Inscrivez-vous ou connectez-vous sur the hCaptcha Dashboard
2. Accédez à l'onglet Sites du tableau de bord et créez une nouvelle clé de site.
3. Accédez à l'onglet Settings dans le tableau de bord et générez votre clé secrète en cliquant sur Generate New Secret.

Mise à jour de l'intégration côté client

1. Remplacez la balise script :

   <script src="https://www.google.com/recaptcha/api.js"
           async defer></script>

   devient

   <script src="https://js.hcaptcha.com/1/api.js"
           async defer></script>

2. Remplacez le nom du paramètre :

   g-recaptcha devient h-captcha

Mise à jour de l'intégration côté serveur

1. Mettre à jour la clé secrète :

   Utilisez la clé secrète que vous avez obtenue à la première étape.

2. Remplacer le champ utilisé à partir du formulaire :

   g-recaptcha-response devient h-captcha-response

3. Mettre à jour l'URL de vérification du site

   https://www.google.com/recaptcha/api/siteverify (ou https://www.recaptcha.net/recaptcha/api/siteverify) devient https://api.hcaptcha.com/siteverify

4. Inverser la consommation du score (reCAPTCHA v3 ou Enterprise vers hCaptcha Enterprise uniquement)

   Les scores reCAPTCHA varient de 0,0 (bot) à 1,0 (humain). Les scores hCaptcha Enterprise sont des scores de risque, et varient donc de 0,0 (aucun risque) à 1,0 (menace confirmée). Cela signifie que vous devez inverser les critères de vérification des scores dans votre code de traitement.

   If (score < threshold) Then [mitigate]

   devient

   If (score >= threshold) Then [mitigate]

Passer des plugins/libraries

Les jetons pre-built hCaptcha integrations sont disponibles pour la quasi-totalité des plateformes et frameworks. Quelques exemples sont présentés ci-dessous :

Plateforme/Framework	Lien
ReactJS	react-hcaptcha
Angulaire	ng-hcaptcha
Androïde	Android SDK
iOS	iOS SDK
Express.js	express-hcaptcha
Node.js	node-hcaptcha
VueJS	vue-hcaptcha
plugin WordPress	hcaptcha-wordpress-plugin
PHP	Use hCaptcha with PHP Apps