--- title: "SAML-SSO-Anmeldeprobleme in Payhawk beheben - Payhawk Help Center" slug: "troubleshooting-saml-sso-issues-in-payhawk" description: "Wenn die Anmeldung per SAML SSO fehlschlägt, erstellen Sie eine HAR-Datei, erfassen Sie die SAML-Antwort und teilen Sie beides mit dem Payhawk Support." updated: 2026-10-26T08:26:26Z published: 2026-10-26T08:26:26Z 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. # Fehlersuche bei SAML SSO-Anmeldeproblemen in Payhawk Wenn Sie Probleme mit der Anmeldung bei Payhawk über SAML-basiertes Single Sign-On (SSO) haben, hilft Ihnen dieser Leitfaden beim Sammeln von Diagnoseinformationen, die die Fehlersuche und -behebung beschleunigen können. Die meisten SSO-Anmeldeprobleme treten auf, wenn Benutzerkonten oder SSO-Konfigurationen vom Administrator in Ihrem Identitätsanbieter (IdP) oder in Payhawk nicht ordnungsgemäß eingerichtet wurden. ## Erfassen der erforderlichen Daten Die folgenden Schritte helfen Ihnen bei der Erfassung der erforderlichen Daten zur Ermittlung der Ursache: 1. [Erstellen einer HAR-Datei](/help/troubleshooting-saml-sso-issues-in-payhawk#schritt-1-erstellen-einer-hardatei) 2. [Erfassen der SAML-Antwort](/help/troubleshooting-saml-sso-issues-in-payhawk#schritt-2-erfassen-der-samlantwort) 3. [Die Diagnosedaten an den Payhawk Support übermitteln](/help/troubleshooting-saml-sso-issues-in-payhawk#schritt-3-die-diagnosedaten-an-den-payhawk-support-übermitteln) ### Schritt 1: Erstellen einer HAR-Datei Eine HAR-Datei (HTTP-Archiv) erfasst alle Netzwerkaktivitäten während Ihres Anmeldeversuchs, einschließlich Umleitungen, Anfragen und Antworten, und hilft so bei der Diagnose von Problemen mit der Verbindung, Weiterleitungen oder dem Authentifizierungsablauf. Um die für die Fehlerbehebung benötigte Datei zu erstellen, lesen Sie den Artikel zum Thema [Erstellen von HAR-Dateien](/help/how-can-i-generate-a-har-file-for-troubleshooting). Sie können die HAR-Datei in den folgenden Fällen verwenden: - Wenn Ihre Anmeldung ohne Fehlermeldung fehlschlägt - Wenn Sie auf einem leeren Bildschirm oder einem Ladebildschirm hängen bleiben - Im Falle des Auftretens einer SSO-Umleitungsschleife ### Schritt 2: Erfassen der SAML-Antwort Die SAML-Antwort ist die Authentifizierungsnachricht, die von Ihrem IdP an Payhawk gesendet wird. Sie enthält Informationen über den Benutzer, die Authentifizierung und etwaige Fehler, die während des Authentifizierungsprozesses aufgetreten sind. Die Erfassung dieser Antwort hilft bei der Ermittlung von Konfigurationsfehlern, fehlenden Ansprüchen oder ungültigen Authentifizierungen. Sie können die SAML-Antwort auf die folgenden Arten erfassen: - [Verwendung der Entwicklerwerkzeuge Ihres Browsers](/help/troubleshooting-saml-sso-issues-in-payhawk#verwendung-der-entwicklungswerkzeuge-ihres-browsers) - [Verwendung einer Browsererweiterung](/help/troubleshooting-saml-sso-issues-in-payhawk#verwendung-einer-browsererweiterung) - [Überprüfung der Protokolle Ihres IdP](/help/troubleshooting-saml-sso-issues-in-payhawk#überprüfung-der-protokolle-ihres-idp) #### Verwendung der Entwicklungswerkzeuge Ihres Browsers Die zuverlässigste Methode zur Erfassung einer SAML-Antwort während einer Live-Anmeldung ist die Verwendung der Entwicklerwerkzeuge Ihres Browsers: 1. Öffnen Sie die Entwicklerwerkzeuge Ihres Browsers – drücken Sie `F12` oder klicken Sie mit der rechten Maustaste und wählen Sie **Prüfen**. 2. Gehen Sie zur Registerkarte **Netzwerk**. 3. Initiieren Sie eine SSO-Anmeldung bei Payhawk von Ihrem Identitätsanbieter aus. 4. Suchen Sie nach einer `POST`-Anfrage an `https://id.payhawk.com/saml2/idpresponse`. 5. Klicken Sie auf diese Anfrage und navigieren Sie zum Abschnitt **Payload** oder **Formulardaten**. 6. Suchen Sie den `SAMLResponse`-Parameter. Der Wert ist eine Base64-kodierte Zeichenfolge. 7. Kopieren Sie die gesamte Base64-Zeichenfolge. 8. Dekodieren Sie sie mit einem Online-Base64-Decoder, wie z. B. [diesen](https://www.base64decode.org/), um das vollständige SAML-Assertion-XML anzuzeigen. In der dekodierten XML-Datei müssen Sie nach den folgenden Informationen suchen: - Die `<saml:Issuer>` muss mit der Entity-ID Ihres IdP übereinstimmen. - Die `<saml:Audience>` muss mit der Entity-ID von Payhawk übereinstimmen. - Die `<saml:NameID>` muss die E-Mail-Adresse oder die Kennung des Benutzers enthalten. - Fehlermeldungen oder ungültige Bedingungen. #### Verwendung einer Browsererweiterung Browser-Erweiterungen können das automatische Erfassen und Dekodieren von SAML-Nachrichten vereinfachen. Eine Reihe von empfohlenen Erweiterungen sind: - SAML-tracer (Firefox): [Zur Installation](https://addons.mozilla.org/en-US/firefox/addon/saml-tracer/). - SAML Chrome Panel (Chrome): [Zur Installation](https://chromewebstore.google.com/detail/saml-chrome-panel/paijfdbeoenhembfhkhllainmocckace). Verwendung der Browsererweiterung zur Fehlersuche: 1. Installieren Sie die Erweiterung. 2. Öffnen Sie das Erweiterungs-Panel (normalerweise in den Entwicklerwerkzeugen oder als Symbol in der Browser-Symbolleiste). 3. Starten Sie den SSO-Anmeldevorgang. 4. Die Erweiterung erfasst die SAML-Anfrage automatisch und zeigt die SAML-Antwort an. 5. Exportieren oder kopieren Sie die entschlüsselte SAML-Antwort-XML. #### Überprüfung der Protokolle Ihres IdP Einige IdPs, wie z. B. Microsoft Entra ID (Azure AD), Okta oder Google Workspace, stellen detaillierte Anmeldeprotokolle zur Verfügung, die die SAML-Assertion oder die an Payhawk gesendeten Forderungen enthalten können. Wenn Sie Microsoft Entra ID verwenden: 1. Melden Sie sich beim [Azure Portal](https://portal.azure.com) an. 2. Gehen Sie zu **Azure Active Directory** > **Unternehmensanwendungen** > **[Ihre Payhawk-App]**. 3. Navigieren Sie zu **Anmeldeprotokolle**. 4. Suchen Sie nach dem fehlgeschlagenen Anmeldeversuch und klicken Sie, um die Details anzuzeigen. 5. Suchen Sie nach SAML-Token-Details oder ausgestellten Forderungen. Wenn Sie andere IdPs verwenden, prüfen Sie die offizielle Dokumentation Ihres IdPs für den Zugriff auf Anmelde- oder Audit-Protokolle. ### Schritt 3: Die Diagnosedaten an den Payhawk Support übermitteln Wenn Sie die HAR-Datei und die SAML-Antwort erfasst haben, senden Sie sie an [support@payhawk.com](mailto:support@payhawk.com) oder in den Chat, damit der Payhawk Support sie analysieren kann: In Ihrer Nachricht müssen Sie die folgenden Informationen angeben: - Eine Beschreibung des Problems (z. B. „SSO-Anmeldung schlägt mit Fehler X fehl“) - Die HAR-Datei - Die entschlüsselte SAML-Antwort-XML - Ihr Firmenname und Ihre Benutzer-E-Mail-Adresse ## Gängige SAML-Probleme und was zu überprüfen ist | Problem | Mögliche Ursache | Was ist zu prüfen? | | --- | --- | --- | | Fehlgeschlagene Anmeldung ohne Fehlermeldung | Benutzer nicht der Payhawk-App im IdP zugewiesen | Überprüfen Sie, ob der Benutzer im IdP zugewiesen ist (z. B. Azure AD, Okta). | | Ungültige SAML-Antwort | Falsch konfigurierte Entity-IDs oder Endpunkte | Überprüfen Sie, ob die Entity-ID und die ACS-URL von Payhawk mit Ihrer IdP-Konfiguration übereinstimmen. | | Benutzer nicht gefunden | E-Mail-Adresse oder NameID stimmen nicht überein | Stellen Sie sicher, dass die SAML NameID mit der Payhawk-E-Mail-Adresse des Benutzers übereinstimmt. | | Fehler im Zertifikat | Abgelaufenes oder falsches Signaturzertifikat | Vergewissern Sie sich, dass das IdP-Zertifikat in den Payhawk-SSO-Einstellungen auf dem neuesten Stand ist. | | Umleitungsschleife | Falsche SSO-Initiierungs-URL | Vergewissern Sie sich, dass Sie die richtige Payhawk-SSO-Anmelde-URL verwenden. | ## Nützliche Ressourcen - [Wie kann ich eine HAR-Datei zur Fehlersuche erstellen?](/help/how-can-i-generate-a-har-file-for-troubleshooting) - [Verwendung von SSO und Einrichtung von SAML mit Payhawk](/help/using-sso-and-setting-up-saml-with-payhawk) - [Ich kann mich nicht anmelden](/help/i-cannot-log-in)