OneLogin (mittlerweile Teil von One Identity) ist ein herstellerneutraler Identitätsanbieter, und Payhawk wird als vorgefertigter Konnektor in dessen Anwendungskatalog bereitgestellt. Da der Konnektor bereits die Dienstanbietereinstellungen von Payhawk enthält, beschränkt sich die Einrichtung im Wesentlichen darauf, die App hinzuzufügen, die Domäne und die E-Mail-Zuordnung zu bestätigen sowie Ihre Benutzer zuzuweisen; anschließend melden sich diese mit ihren OneLogin-Anmeldeinformationen bei Payhawk an.
SAML unterstützt keine vom Identitätsanbieter (IdP) initiierte Authentifizierung. Ihre Benutzer müssen stets über die Payhawk-Anmeldeseite beginnen. Die Zwei-Faktor-Authentifizierung (2FA) gilt, sofern sie aktiviert ist, weiterhin, und SSO ersetzt diese nicht.
Bevor Sie starten
Sie benötigen Administratorrechte auf Ihren OneLogin-Tenant.
Sie benötigen Payhawk-Administratorrechte in Payhawk, um die Einrichtung zu koordinieren.
Halten Sie Ihre Authentifizierungsdomänen bereit (zum Beispiel
yourcompany.com), also die E-Mail-Domänen, mit denen sich Ihre Benutzer anmelden.Die E-Mail-Adresse, die OneLogin für jeden Benutzer versendet, muss genau mit dem im Payhawk-Konto des jeweiligen Benutzers hinterlegten E-Mail-Konto übereinstimmen. Nicht übereinstimmende E-Mail-Adressen führen zu fehlgeschlagenen Anmeldungen oder doppelten Benutzerkonten.
Einstellungen für Payhawk-Dienstanbieter (SP)
Der Payhawk-Konnektor im OneLogin-Katalog ist bereits mit den unten aufgeführten Werten vorbelegt, sodass Sie diese in den meisten Fällen lediglich bestätigen müssen, anstatt sie einzugeben.
Einstellung | Wert |
|---|---|
Domain (Konfiguration) |
|
Attributzuordnung |
|
Zugrunde liegende ACS-URL |
|
Zugrunde liegende SP-Entitäts-ID |
|
SAML-Anwendung erstellen und konfigurieren
Melden Sie sich als Administrator in Ihrem OneLogin-Tenant an.
Navigieren Sie zu Anwendungen > Anwendung hinzufügen und suchen Sie nach Payhawk.
Wählen Sie den Payhawk-Konnektor aus und belassen Sie die Einstellungen auf dem Startbildschirm unverändert. Wählen Sie Speichern.
Stellen Sie auf der Registerkarte Konfiguration sicher, dass die Domain auf Payhawk festgelegt ist.
E-Mail-Attribut zuordnen
Payhawk benötigt die E-Mail-Adresse der Person in der Assertion.
Stellen Sie auf der Registerkarte Parameter sicher, dass die Attributzuordnung email → E-Mail lautet.
Bestätigen Sie, dass für diesen Parameter In SAML-Assertion einschließen aktiviert ist.
Benutzer zuweisen
Speichern Sie die Anwendung und aktivieren Sie sie für alle Personen, die sie nutzen sollen (über OneLogin-Rollen oder direkte Zuweisung).
Stellen Sie sicher, dass die E-Mail-Adresse jeder zugewiesenen Person mit ihrem Payhawk-Konto übereinstimmt.
IdP-Metadaten exportieren und an Payhawk senden
Wählen Sie oben rechts in der Anwendung Weitere Aktionen > SAML-Metadaten aus, um die IdP-Metadaten als XML-Datei herunterzuladen. Diese enthält den OneLogin-SSO-Endpunkt, die Entität und das Signaturzertifikat, die Payhawk benötigt.
Wenden Sie sich an Ihren Payhawk Implementation Manager und übermitteln Sie die XML-Datei mit den IdP-Metadaten, Ihre Authentifizierungsdomains sowie die Bestätigung der Attributzuordnung E-Mail.
Payhawk führt die Backend-Konfiguration durch und bestätigt Ihnen, sobald SSO zum Testen bereit ist.
Anmeldung testen
Gehen Sie zur Anmeldeseite.
Geben Sie eine geschäftliche E-Mail-Adresse in einer SSO-fähigen Domain ein.
Authentifizieren Sie sich mit OneLogin und führen Sie alle Schritte für OneLogin Protect oder die Zwei-Faktor-Authentifizierung durch.
Nach erfolgreicher Anmeldung kehren Sie angemeldet zurück.
Fehlerbehebung
Sie werden zurück zur Anmeldeseite geleitet oder der Zugriff wird verweigert – bitte überprüfen Sie, ob der Parameter
E-Mailin der SAML-Assertion enthalten ist und dessen Wert exakt mit der E-Mail-Adresse des Payhawk-Kontos übereinstimmt.Anwendung nicht zugewiesen – dem Benutzer steht die Payhawk-App weder über eine OneLogin-Rolle noch durch eine direkte Zuweisung zur Verfügung.
Die von einem Identitätsanbieter (IdP) initiierte Anmeldung schlägt fehl – das ist zu erwarten. Benutzer müssen von der Payhawk-Anmeldeseite aus starten, nicht vom OneLogin-Portal.