--- title: "SAML-SSO mit OneLogin für die Verwaltung - Payhawk Help Center" slug: "setting-up-saml-sso-with-onelogin" description: "Fügen Sie den fertigen Payhawk-Connector in OneLogin hinzu, bestätigen Sie Domain und E-Mail-Attribut, weisen Sie Benutzer zu und senden Sie die IdP-Metadaten." updated: 2026-10-23T07:51:14Z published: 2026-10-23T07:51:14Z 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. # SAML SSO mit OneLogin einrichten [OneLogin](https://www.onelogin.com/) (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. > [!WARNING] > 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) | `Payhawk` | | Attributzuordnung | `email` → **E-Mail**, in der SAML-Assertion enthalten | | Zugrunde liegende ACS-URL | `https://id.payhawk.com/saml2/idpresponse` | | Zugrunde liegende SP-Entitäts-ID | `urn:amazon:cognito:sp:eu-central-1_mcW4Iwl7p` | ## SAML-Anwendung erstellen und konfigurieren 1. Melden Sie sich als Administrator in Ihrem OneLogin-Tenant an. 2. Navigieren Sie zu **Anwendungen** > **Anwendung hinzufügen** und suchen Sie nach **Payhawk**. 3. Wählen Sie den Payhawk-Konnektor aus und belassen Sie die Einstellungen auf dem Startbildschirm unverändert. Wählen Sie **Speichern**. 4. 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. 1. Stellen Sie auf der Registerkarte **Parameter** sicher, dass die Attributzuordnung **email** → **E-Mail** lautet. 2. Bestätigen Sie, dass für diesen Parameter **In SAML-Assertion einschließen** aktiviert ist. ## Benutzer zuweisen 1. Speichern Sie die Anwendung und aktivieren Sie sie für alle Personen, die sie nutzen sollen (über OneLogin-Rollen oder direkte Zuweisung). 2. Stellen Sie sicher, dass die E-Mail-Adresse jeder zugewiesenen Person mit ihrem Payhawk-Konto übereinstimmt. ## IdP-Metadaten exportieren und an Payhawk senden 1. 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. 2. 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 1. Gehen Sie zur Anmeldeseite. 2. Geben Sie eine geschäftliche E-Mail-Adresse in einer SSO-fähigen Domain ein. 3. Authentifizieren Sie sich mit OneLogin und führen Sie alle Schritte für OneLogin Protect oder die Zwei-Faktor-Authentifizierung durch. 4. 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-Mail` in 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.