Comment résoudre les problèmes de connexion à l’application ? (Assistance technique)

Dépannage des échecs d'authentification

1. Vérifiez que l'adresse du portefeuille ou l'adresse e-mail utilisée lors de l'inscription correspond exactement à ce qui est stocké dans le système : le respect de la casse et les espaces de fin provoquent souvent des incompatibilités silencieuses.

2. Confirmez que la version de l'application est à jour ; Les versions existantes peuvent ne pas prendre en charge les algorithmes de signature de jetons JWT plus récents ou les points de terminaison OAuth 2.1.

3. Vérifiez si l'horloge de l'appareil est synchronisée avec les serveurs NTP ; un décalage temporel supérieur à cinq minutes invalide les jetons d’accès de courte durée émis par les fournisseurs d’identité blockchain.

4. Inspectez les autorisations du navigateur ou du système d'exploitation mobile, en particulier « Autoriser les notifications » et « Actualisation de l'application en arrière-plan », car certains flux d'authentification décentralisés reposent sur des poignées de main de type défi-réponse basées sur le push.

Récupération à partir d'erreurs de signature de portefeuille

1. Lorsque MetaMask ou Phantom affiche « Signature rejetée », assurez-vous que le réseau connecté correspond à celui attendu par la configuration frontale de la dApp : les disparités entre le réseau principal et le réseau de test déclenchent des abandons immédiats de session.

2. Effacer les noms occasionnels de signature mis en cache stockés dans IndexedDB ; les compteurs obsolètes empêchent les mécanismes de protection contre la relecture de valider de nouvelles demandes de connexion.

3. Désactivez temporairement les ponts de portefeuille matériel : si Ledger Live ou Trezor Suite est en cours d'exécution, son énumération USB peut interférer avec les séquences de négociation WebUSB requises pour l'authentification par enclave sécurisée.

Analyse des journaux du service d'identité backend

1. Recherchez les réponses HTTP 401 contenant « invalid_signature_format » : cela indique que le frontend a transmis une structure de données mal formée de type EIP-712 au fournisseur de signature.

2. Recherchez les entrées marquées avec « nonce_mismatch » dans les journaux du microservice AuthZ ; cela signale soit une réutilisation occasionnelle côté client, soit une mauvaise configuration du backend Redis TTL.

3. Suivez les identifiants de corrélation entre les services de connexion au portefeuille, de vérification d'identité et de gestion de session pour isoler l'endroit où la charge utile JWT est dépourvue des revendications requises telles que « sub », « iss » ou « chain_id ».

Gestion des conflits de sessions inter-chaînes

1. Si vous vous connectez via Polygon ID tout en maintenant une session Ethereum active, le gestionnaire de session peut rejeter le nouveau contexte en raison de restrictions en matière de cookies au niveau du domaine. Le passage aux cookies d'authentification basés sur le sous-domaine résout ce problème.

2. Les portefeuilles multi-chaînes comme Trust Wallet injectent parfois des fournisseurs window.ethereum contradictoires ; forcer la sélection explicite du fournisseur via window.ethereum.request({ method: 'wallet_switchEthereumChain' }) avant le lancement de l'authentification empêche les conditions de concurrence.

3. Évitez de mélanger les connexions d'abstraction de compte ERC-4337 avec les EOA dans le même magasin de sessions : leurs schémas de signature (userOperation vs personal_sign) sont incompatibles au niveau de la couche de validation de session.

Foire aux questions

Q : Pourquoi l'application affiche-t-elle « Informations d'identification invalides » même après avoir saisi la phrase de départ correcte ? R : Les phrases de départ ne sont jamais transmises aux serveurs ; ce message signifie généralement que la vérification de l'adresse du portefeuille dérivé par rapport au contrat d'identité en chaîne a échoué : vérifiez si le contrat du vérificateur déployé correspond à l'ID de chaîne dans la demande de connexion.

Q : Puis-je me connecter à l’aide d’un Ledger Nano X sur iOS Safari ? R : Oui, mais uniquement si WebUSB est désactivé et que la dApp utilise WalletConnect v2 à la place : iOS bloque l'accès USB direct, le couplage basé sur QR devient donc obligatoire pour l'intégration du portefeuille matériel.

Q : Qu'est-ce qui cause l'expiration de la session immédiatement après une signature réussie ? R : Cela se produit lorsque le backend émet un cookie de session avec SameSite=Strict mais que le frontend initie le flux d'authentification à partir d'une iframe tierce : le passage à SameSite=Lax ou l'émission de JWT sans état dans les en-têtes HTTP évitent le problème.

Q : Pourquoi la connexion biométrique échoue-t-elle sur Android 13+ avec « Échec de l'opération Keystore » ? R : StrongBox Keymaster d'Android applique des exigences d'attestation plus strictes ; l'application doit déclarer android:allowBackup='false' et utiliser KeyGenParameterSpec.Builder.setIsStrongBoxBacked(true) lors de la génération de clé.