--- title: "Problèmes de connexion SAML SSO dans Payhawk - Payhawk Help Center" slug: "troubleshooting-saml-sso-issues-in-payhawk" description: "Si la connexion SSO SAML échoue, générez un fichier HAR et capturez la réponse SAML, puis partagez-les avec le support Payhawk pour accélérer la résolution." updated: 2026-10-26T08:26:02Z published: 2026-10-26T08:26:02Z canonical: "payhawk.com/troubleshooting-saml-sso-issues-in-payhawk" --- > ## Documentation Index > Fetch the complete documentation index at: https://payhawk.com/help/llms.txt > Use this file to discover all available pages before exploring further. # Résolution des problèmes de connexion SAML SSO dans Payhawk Si vous rencontrez des problèmes pour vous connecter à Payhawk via le Single Sign-On (SSO) basé sur SAML, ce guide vous aidera à collecter des informations de diagnostic qui peuvent accélérer le dépannage et la résolution des problèmes. La plupart des problèmes de connexion SSO surviennent lorsque les comptes d'utilisateurs ou les configurations SSO ne sont pas correctement configurés par l'administrateur de votre fournisseur d'identité (IdP) ou de Payhawk. ## Saisir les données nécessaires Les étapes suivantes vous aideront à recueillir les données nécessaires à l'identification de la cause première : . 1. [Générez un fichier HAR](/help/troubleshooting-saml-sso-issues-in-payhawk#étape-1-générez-un-fichier-har) 2. [Capturez la réponse SAML](/help/troubleshooting-saml-sso-issues-in-payhawk#étape-2-capturez-la-réponse-saml) 3. [Partagez les données de diagnostic avec Payhawk](/help/troubleshooting-saml-sso-issues-in-payhawk#étape-3-partagez-les-données-de-diagnostic-avec-le-service-dassistance-de-payhawk) ### Étape 1 : Générez un fichier HAR Un fichier HAR (HTTP Archive) capture toute l'activité du réseau pendant votre tentative de connexion, y compris les redirections, les demandes et les réponses, ce qui permet de diagnostiquer les problèmes de connectivité, de redirection ou de flux d'authentification. Pour créer le fichier nécessaire à la résolution du problème, consultez l'article [générer des fichiers HAR](/help/how-can-i-generate-a-har-file-for-troubleshooting). Vous pouvez utiliser le fichier HAR dans les cas suivants : - Lorsque votre connexion échoue sans message d'erreur . - Si vous êtes bloqué sur un écran vide ou un écran de chargement . - En cas de boucle de redirection SSO ### Étape 2 : Capturez la réponse SAML La réponse SAML est le message d'authentification envoyé par votre IdP à Payhawk. Elle contient des informations sur l'utilisateur, l'assertion et toutes les erreurs qui ont pu se produire pendant le processus d'authentification. La capture de cette réponse permet d'identifier les erreurs de configuration, les revendications manquantes ou les affirmations non valides. Vous pouvez capturer la réponse SAML de la manière suivante : - [Utilisation des outils de développement de votre navigateur](/help/troubleshooting-saml-sso-issues-in-payhawk#utilisation-des-outils-de-développement-de-votre-navigateur) - [Utilisation d'une extension de navigateur](/help/troubleshooting-saml-sso-issues-in-payhawk#utilisation-dune-extension-de-navigateur) - [Vérification des journaux de votre IdP](/help/troubleshooting-saml-sso-issues-in-payhawk#vérifiez-les-journaux-de-votre-idp) #### Utilisation des outils de développement de votre navigateur L'utilisation des outils de développement de votre navigateur est la méthode la plus fiable pour capturer une réponse SAML lors d'une connexion en direct :. 1. Ouvrez les outils de développement de votre navigateur – appuyez sur `F12` ou cliquez avec le bouton droit de la souris et sélectionnez **Inspecter**. 2. Accédez à l'onglet **Réseau**. 3. Initiez une connexion SSO à Payhawk depuis votre fournisseur d'identité. 4. Recherchez une requête `POST` à `https://id.payhawk.com/saml2/idpresponse`. 5. Cliquez sur cette demande et accédez à la section **Charge utile** ou **Données du formulaire**. 6. Localisez le paramètre `SAMLResponse`. La valeur sera une chaîne de caractères codée en Base64. 7. Copiez la chaîne Base64 entière. 8. Décodez-la à l'aide d'un décodeur Base64 en ligne, tel que [celui-ci](https://www.base64decode.org/), pour afficher le XML complet de l'assertion SAML. Vous devrez rechercher les informations suivantes dans le XML décodé :. - Le `<saml:Issuer>` doit correspondre à l'identifiant de l'entité de votre IdP. - Le `<saml:Audience>` doit correspondre à l'identifiant de l'entité Payhawk. - Le `<saml:NameID>` doit contenir l'adresse e-mail ou l'identifiant de l'utilisateur. - Tout message d'erreur ou condition non valide. #### Utilisation d'une extension de navigateur Les extensions de navigateur peuvent simplifier la capture et le décodage automatiques des messages SAML. Il est recommandé d'utiliser les extensions suivantes : . - SAML-tracer (Firefox) : [installer ici](https://addons.mozilla.org/en-US/firefox/addon/saml-tracer/). . - SAML Chrome Panel (Chrome) : [installer ici](https://chromewebstore.google.com/detail/saml-chrome-panel/paijfdbeoenhembfhkhllainmocckace). Pour utiliser l'extension du navigateur afin de résoudre le problème : 1. Installez l'extension. 2. Ouvrez le panneau d'extension (généralement dans les outils de développement ou sous forme d'icône dans la barre d'outils du navigateur). 3. Démarrez le flux de connexion SSO. 4. L'extension capturera et affichera automatiquement la demande et la réponse SAML. 5. Exportez ou copiez la réponse SAML XML décodée. #### Vérifiez les journaux de votre IdP Certains fournisseurs d'identité, tels que Microsoft Entra ID (Azure AD), Okta ou Google Workspace, fournissent des journaux de connexion détaillés qui peuvent inclure l'assertion SAML ou les réclamations envoyées à Payhawk.. Si vous utilisez Microsoft Entra ID :. 1. Connectez-vous au [Portail Azure](https://portal.azure.com). 2. Accédez à **Azure Active Directory** > **Applications d’entreprise** > **[Votre application Payhawk]**. 3. Accédez à **Journaux de connexion**. 4. Trouvez la tentative de connexion qui a échoué et cliquez pour afficher les détails. 5. Recherchez les détails du jeton SAML ou les réclamations émises. Si vous utilisez d'autres IdP, consultez la documentation officielle de votre IdP pour accéder aux journaux de connexion ou d'audit. ### Étape 3 : Partagez les données de diagnostic avec le service d'assistance de Payhawk Après avoir collecté le fichier HAR et la réponse SAML, envoyez-les à [support@payhawk.com](mailto:support@payhawk.com) ou dans le chat pour que le support Payhawk les analyse : Dans votre message, vous devez inclure les informations suivantes : . - Une description du problème (par exemple, « Échec de la connexion SSO avec l'erreur X ») - Le fichier HAR - La réponse SAML décodée en XML - Votre nom d'entreprise et l'adresse e-mail de l'utilisateur ## Problèmes SAML courants et ce qu'il faut vérifier | Problème | Cause possible | Ce qu'il faut vérifier | | --- | --- | --- | | L'ouverture de session échoue silencieusement | L'utilisateur n'est pas assigné à l'application Payhawk dans l'IdP | Vérifiez que l'utilisateur est assigné dans l'IdP (par exemple, Azure AD, Okta). | | Réponse SAML non valide | ID d'entité ou points d'extrémité mal configurés | Vérifiez que l'ID d'entité et l'URL ACS de Payhawk correspondent à votre configuration IdP. | | Utilisateur non trouvé | Inadéquation entre l'adresse e-mail et le nom de l'utilisateur | Assurez-vous que l'identifiant SAML NameID corresponde à l'adresse e-mail Payhawk de l'utilisateur. | | Erreur de certificat | Certificat de signature expiré ou non conforme | Vérifiez que le certificat IdP est à jour dans les paramètres SSO de Payhawk. | | Boucle de redirection | URL d'initiation SSO incorrecte | Confirmez que vous utilisez l'URL de connexion Payhawk SSO correcte. | ## Ressources utiles - [Comment puis-je générer un fichier HAR pour le dépannage ?](/help/how-can-i-generate-a-har-file-for-troubleshooting) - [Utilisation de l'authentification unique et configuration de SAML avec Payhawk](/help/using-sso-and-setting-up-saml-with-payhawk) - [Je ne peux pas me connecter](/help/i-cannot-log-in)