OneLogin (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.
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) |
|
Mappage d'attribut |
|
URL ACS sous-jacente |
|
ID d'entité SP sous-jacent |
|
Création et configuration de l'application SAML
Connectez-vous en tant qu'administrateur dans votre tenant OneLogin.
Accédez à Applications > Ajouter une application et recherchez Payhawk.
Sélectionnez le connecteur Payhawk et conservez les paramètres tels quels sur l'écran initial. Cliquez sur Enregistrer.
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.
Dans l'onglet Paramètres, vérifiez que le mappage d'attribut est e-mail → E-mail.
Confirmez que l'option Inclure dans l'assertion SAML est cochée pour ce paramètre.
Attribution des utilisateurs
Enregistrez l'application et activez-la pour tous les utilisateurs concernés (via les rôles OneLogin ou une attribution directe).
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
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.
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
Accédez à la page de connexion Payhawk.
Saisissez une adresse e-mail professionnelle associée à un domaine sur lequel le SSO est activé.
Authentifiez-vous via OneLogin et effectuez les étapes OneLogin Protect ou de double authentification (2FA) si nécessaire.
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-mailest 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.