Aller au contenu
ALTCHA ALTCHA ALTCHA

Dépannage

Cette page fournit des conseils pour résoudre les problèmes courants liés aux intégrations ALTCHA. Pour commencer, activez le mode de débogage sur le widget et vérifiez les journaux dans la console du développeur.

Mode Débogage

Pour activer le mode de débogage sur le widget, utilisez l’attribut debug:

<altcha-widget
  debug
></altcha-widget>

Le mode débogage affichera des messages de journal dans la console. Ouvrez la console du développeur de votre navigateur pour visualiser ces journaux.

Problèmes Courants

Le Widget Échoue à Trouver la Solution

Problème:

Le widget signale “Échec de la vérification” et la console affiche “Impossible de trouver une solution” (avec le debug activé).

Solution:

Ce problème peut survenir en raison de :

  1. Nombre Aléatoire Supérieur au Maximum: Assurez-vous que le nombre aléatoire généré par votre serveur ne dépasse pas le nombre maximum configuré. Par défaut, le nombre maximum est de 1 000 000, mais il peut être outrepassé par le paramètre maxnumber dans la réponse du défi. Alignez la génération de nombres aléatoires de votre serveur avec ce maximum.

  2. Calcul du Défi Incorrect: Vérifiez votre implémentation côté serveur. Pour plus de détails, consultez la documentation du serveur ou les bibliothèques officielles pour des implémentations spécifiques au langage. Par exemple, vérifiez si salt=some_salt?expires=1722614680 et number=1234 génèrent un challenge SHA-256 égal à 8b1fa4ee51e9e9c8b53cd0c080ca42458accc39424a13fb51e56cfe439814d5f. Assurez-vous que tous les paramètres supplémentaires (par ex., expires) sont inclus dans l’entrée du hash.

Les Écouteurs d’Événements Ne Fonctionnent Pas

Problème:

Les événements tels que statechange ou verified ne sont pas déclenchés.

Solution:

Assurez-vous d’attacher les écouteurs d’événements après le chargement du script ALTCHA et l’initialisation du composant. Dans les frameworks modernes et les regroupeurs, assurez-vous d’importer 'altcha' dans votre application. Pour du JavaScript personnalisé, utilisez :

window.addEventListener('load', () => {
  altchaWidgetElement.addEventListener('statechange', (ev) => {
    // Gérer l'événement de changement d'état
  });
});

Problèmes de Politique de Sécurité du Contenu (CSP)

Problème:

Le widget ne se rend pas correctement, ou la console affiche des erreurs liées à CSP.

Solution:

Consultez la documentation sur la Politique de Sécurité du Contenu pour configurer correctement le CSP pour le widget.

Problèmes de Partage de Ressources en Origine Croisée (CORS)

Problème:

Le widget échoue à récupérer le défi du serveur, et des erreurs liées à CORS apparaissent dans la console.

Solution:

Ce problème survient lorsque votre site web ou application se trouve sur un domaine différent de votre serveur. Activez CORS (Partage de Ressources en Origine Croisée) sur votre serveur. Une configuration CORS de base comprend :

Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: *
Access-Control-Allow-Methods: GET, POST, OPTIONS

Pour des orientations détaillées, consultez la documentation MDN.