Dépannage de la connexion

Travaillez de haut en bas. La plupart des problèmes viennent d’un décalage d’URI de redirection, d’un mauvais type de client ou des limites cookies / stockage dans le navigateur.

---

1. Redirection et environnement (2 minutes)

• L’URL de callback dans le navigateur correspond caractère pour caractère à une URI de redirection autorisée (schéma, hôte, chemin, slash final).
• Vous testez le même environnement (app staging vs production) que celui qui correspond au client ID utilisé.
• HTTPS en production là où vous avez enregistré https:// — les callbacks http mélangés échouent silencieusement ou avec des erreurs OAuth.

---

2. Type de client et secrets

• Application navigateur uniquement : utilisez PKCE, pas un secret client en JavaScript.
• Échange côté serveur : client confidentiel + secret uniquement sur le serveur — voir Clients confidentiels côté serveur.
• Si vous avez récemment fait tourner les secrets ou changé public vs confidentiel, purgez les anciennes variables d’environnement et redéployez.

---

3. Navigateur et cookies

• Essayez la navigation privée pour écarter cookies obsolètes ou extensions.
• Safari / ITP et politiques de cookies tiers : privilégiez les redirections first-party et les modèles décrits dans Sessions, cookies et jetons.
• Pop-ups bloquées par le navigateur ou bloqueurs de pub — repassez en flux de redirection complète pour un test.

---

4. Toujours en échec ?

Rassemblez ce paquet avant Contact et assistance :

1. URL de la page (staging ou production) et navigateur + version.
2. Type d’app (SDK React, JS brut, SPA, échange serveur).
3. Message d’erreur ou code d’erreur OAuth (capture ou texte exact).
4. Si ça a déjà fonctionné et ce qui a changé (liste de redirections, domaine, déploiement).

Les propriétaires peuvent commencer par la Checklist propriétaire de site (connexion). Intégrateurs : Vue d’ensemble intégrateur.