--- title: "SSO SAML avec OneLogin pour les administrateurs - Payhawk Help Center" slug: "setting-up-saml-sso-with-onelogin" description: "Ajoutez le connecteur Payhawk prêt à l'emploi dans OneLogin, confirmez le domaine et l'attribut e-mail, affectez les utilisateurs et envoyez les métadonnées." updated: 2026-10-23T07:51:13Z published: 2026-10-23T07:51:13Z canonical: "payhawk.com/setting-up-saml-sso-with-onelogin" --- > ## 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. # Configuration du SSO SAML avec OneLogin [OneLogin](https://www.onelogin.com/) (désormais intégré à One Identity) est un fournisseur d'identité neutre, et Payhawk est disponible en tant que connecteur prêt à l'emploi dans son catalogue d'applications. Ce connecteur intègre déjà les paramètres du fournisseur de services de Payhawk, ce qui simplifie la configuration : il suffit d'ajouter l'application, de confirmer le domaine et le mappage de l'e-mail, puis d'attribuer vos utilisateurs. Ces derniers pourront ensuite se connecter à Payhawk avec leurs identifiants OneLogin. > [!WARNING] > SAML ne prend pas en charge l'authentification initiée par le fournisseur d'identité (IdP). Vos utilisateurs doivent toujours commencer par la page de connexion Payhawk. L'authentification à deux facteurs (2FA), lorsqu'elle est activée, reste applicable, et l'authentification unique (SSO) ne la remplace pas. ## Avant de commencer - Vous devez disposer d'un accès administrateur à votre tenant OneLogin. - Vous devez disposer des droits d'administrateur Payhawk sur Payhawk pour coordonner la configuration. - Préparez vos domaines d'authentification (par exemple, `votreentreprise.com`), c'est-à-dire les domaines de messagerie utilisés par vos utilisateurs pour se connecter. - L'adresse e-mail que OneLogin envoie à chaque utilisateur doit correspondre exactement à celle associée à son compte Payhawk. Toute divergence entre ces deux adresses entraîne des échecs de connexion ou la création de doublons. ## Paramètres du fournisseur de services (SP) Payhawk Le connecteur Payhawk dans le catalogue OneLogin est prérempli avec les valeurs ci-dessous. Dans la plupart des cas, il vous suffit de les confirmer plutôt que de les saisir manuellement. | Paramètre | Valeur | | --- | --- | | Domaine (Configuration) | `payhawk` | | Mappage d'attribut | `e-mail` → **E-mail**, inclus dans l'assertion SAML | | URL ACS sous-jacente | `https://id.payhawk.com/saml2/idpresponse` | | ID d'entité SP sous-jacent | `urn:amazon:cognito:sp:eu-central-1_mcW4Iwl7p` | ## Création et configuration de l'application SAML 1. Connectez-vous en tant qu'administrateur dans votre tenant OneLogin. 2. Accédez à **Applications** > **Ajouter une application** et recherchez **Payhawk**. 3. Sélectionnez le connecteur Payhawk et conservez les paramètres tels quels sur l'écran initial. Cliquez sur **Enregistrer**. 4. Dans l'onglet **Configuration**, vérifiez que le **Domaine** est défini sur **payhawk**. ## Mappage de l'attribut e-mail La plateforme requiert l'adresse e-mail de l'utilisateur dans l'assertion. 1. Dans l'onglet **Paramètres**, vérifiez que le mappage d'attribut est **e-mail** → **E-mail**. 2. Confirmez que l'option **Inclure dans l'assertion SAML** est cochée pour ce paramètre. ## Attribution des utilisateurs 1. Enregistrez l'application et activez-la pour tous les utilisateurs concernés (via les rôles OneLogin ou une attribution directe). 2. Vérifiez que l'adresse e-mail de chaque utilisateur attribué correspond à son compte sur la plateforme. ## Exportation des métadonnées IdP et envoi sur Payhawk 1. En haut à droite de l'application, sélectionnez **Autres actions** > **Métadonnées SAML** pour télécharger les métadonnées IdP sous forme de fichier XML. Ce fichier contient le point de terminaison SSO OneLogin, l'identifiant d'entité et le certificat de signature requis par Payhawk. 2. Contactez votre responsable d'implémentation Payhawk et fournissez-lui le fichier XML contenant les métadonnées de l'IdP, votre ou vos domaine(s) d'authentification, ainsi que la confirmation du mappage de l'attribut e-mail. La plateforme finalise la configuration backend et confirme lorsque le SSO est prêt à être testé. ## Test de la connexion 1. Accédez à la page de connexion Payhawk. 2. Saisissez une adresse e-mail professionnelle associée à un domaine sur lequel le SSO est activé. 3. Authentifiez-vous via OneLogin et effectuez les étapes OneLogin Protect ou de double authentification (2FA) si nécessaire. 4. Si l'opération aboutit, vous serez redirigé(e) vers Payhawk en tant qu'utilisateur connecté. ## Dépannage - Redirection vers la page de connexion ou accès refusé : vérifiez que le paramètre `e-mail` est inclus dans l'assertion SAML et que sa valeur correspond exactement à l'adresse e-mail du compte Payhawk. - Application non attribuée : l'utilisateur ne dispose pas de l'accès à l'application via un rôle OneLogin ou une attribution directe. - La connexion initiée par le fournisseur d'identité (IdP) échoue : ce comportement est attendu. Les utilisateurs doivent démarrer depuis la page de connexion Payhawk, et non depuis le portail OneLogin.