Passer de reCAPTCHA à hCaptcha
Passer de reCAPTCHA à hCaptcha est simple. Vous trouverez ci-dessous un guide étape par étape pour vous aider dans cette mise à niveau.
Vous n'avez pas besoin de mettre à jour vos rappels ou vos attributs de balise. hCaptcha est compatible API avec reCAPTCHA.
Obtenez votre clé de site hCaptcha et votre clé secrète
- Inscrivez-vous ou connectez-vous sur le tableau de bord hCaptcha
- Accédez à l'onglet Sites du tableau de bord et créez une nouvelle clé de site.
- Accédez à l'onglet Paramètres du tableau de bord et copiez votre clé secrète.
Mettre à jour l'intégration côté client
- 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>
- Remplacez le nom du paramètre:
g-recaptcha devient h-captcha
Mettre à jour l'intégration côté serveur
- Mettez à jour la clé secrète:
Utilisez la clé secrète que vous avez obtenue lors de la première étape.
- Remplacer le champ utilisé depuis le formulaire:
g-recaptcha-response devient h-captcha-response
- 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
- Inverser la consommation du score (reCAPTCHA v3 ou Enterprise vers hCaptcha Enterprise uniquement)
Les scores reCAPTCHA vont de 0,0 (bot) à 1,0 (personne). Les scores hCaptcha Enterprise sont des scores de risque et vont donc de 0,0 (aucun risque) à 1,0 (menace confirmée). Consultez la [documentation sur les scores] hCaptcha Enterprise (/enterprise/scores_and_modes) pour plus de détails. (Nécessite une connexion au compte Entreprise.) Cela signifie que vous devez inverser toutes les vérifications de score dans votre code de consommation de score.
if (score < seuil) then [atténuer]
devient
if (score >= seuil) then [atténuer]
Passer des plugins/bibliothèques
Les intégrations hCaptcha prédéfinies sont disponibles pour pratiquement toutes les plates-formes et frameworks. Quelques-uns sont liés ci-dessous :
| Plateforme/Cadre | Lien |
|---|---|
| ReactJS | react-hcaptcha |
| Angulaire | ng-hcaptcha |
| Android | SDK Android |
| iOS | SDK iOS |
| Express.js | express-hcaptcha |
| Node.js | node-hcaptcha |
| VueJS | vue-hcaptcha |
| Plugin WordPress | hcaptcha-wordpress-plugin |
| PHP | Utilisez hCaptcha avec les applications PHP |