--- title: "Проблеми при влизане чрез SAML SSO в Payhawk - Payhawk Help Center" slug: "troubleshooting-saml-sso-issues-in-payhawk" description: "Съберете HAR файл и SAML отговора, когато влизането чрез SAML SSO е неуспешно, и ги споделете с поддръжката на Payhawk, за да се разреши проблемът по-бързо." updated: 2026-11-17T12:50:22Z published: 2026-11-17T12:50:22Z 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. # Отстраняване на проблеми при влизане чрез SAML SSO в Payhawk Ако имате проблеми с влизането в Payhawk чрез базирана на SAML еднократна идентификация (SSO), това ръководство ще ви помогне да съберете диагностична информация, която може да ускори отстраняването и разрешаването на проблема. Повечето проблеми при влизане чрез SSO възникват, когато потребителските акаунти или конфигурациите за SSO не са правилно настроени от администратора във вашия доставчик на самоличност (IdP) или в Payhawk. ## Събиране на необходимите данни Следните стъпки ще ви помогнат да съберете необходимите данни за установяване на основната причина: 1. [Генерирайте HAR файл](/help/troubleshooting-saml-sso-issues-in-payhawk#step-1-generate-a-har-file) 2. [Заснемете отговора на SAML](/help/troubleshooting-saml-sso-issues-in-payhawk#step-2-capture-the-saml-response) 3. [Споделете диагностичните данни с Payhawk](/help/troubleshooting-saml-sso-issues-in-payhawk#step-3-share-the-diagnostic-data-with-payhawk-support) ### Стъпка 1: Генерирайте HAR файл HAR (HTTP архив) файлът записва цялата мрежова активност по време на опита ви за влизане, включително пренасочвания, заявки и отговори, като по този начин помага за диагностицирането на проблеми със свързаността, пренасочването или процеса на удостоверяване. За да създадете файла, необходим за отстраняване на проблема, вижте статията за [генериране на HAR файлове](/help/how-can-i-generate-a-har-file-for-troubleshooting). Можете да използвате HAR файла в следните случаи: - Когато влизането ви е неуспешно без съобщение за грешка - Ако сте блокирани на празен екран или екран за зареждане - При възникване на цикъл на пренасочване при SSO ### Стъпка 2: Заснемете отговора на SAML Отговорът на SAML е съобщението за удостоверяване, изпратено от вашия IdP към Payhawk. То съдържа информация за потребителя, твърдението и всички грешки, които може да са възникнали по време на процеса на удостоверяване. Заснемането на този отговор помага за установяване на несъответствия в конфигурацията, липсващи искове или невалидни твърдения. Можете да заснемете SAML отговора по следните начини: - [Чрез инструментите за разработчици на браузъра си](/help/troubleshooting-saml-sso-issues-in-payhawk#using-your-browser-developer-tools) - [Чрез разширение за браузър](/help/troubleshooting-saml-sso-issues-in-payhawk#using-a-browser-extension) - [Чрез проверка на регистрационните файлове на вашия IdP](/help/troubleshooting-saml-sso-issues-in-payhawk#checking-your-idps-logs) #### Използване на инструментите за разработчици на браузъра Използването на инструментите за разработчици на браузъра ви е най-надеждният метод за заснемане на SAML отговор по време на влизане в реално време: 1. Отворете инструментите за разработчици на браузъра си – натиснете `F12` или щракнете с десния бутон и изберете **Проверка**. 2. Отидете в раздела **Мрежа**. 3. Стартирайте SSO влизане в Payhawk от вашия доставчик на самоличност. 4. Потърсете заявка `POST` към `https://id.payhawk.com/saml2/idpresponse`. 5. Щракнете върху тази заявка и отидете в раздела **Полезен обем** или **Данни от формуляра**. 6. Намерете параметъра `SAMLResponse`. Стойността ще бъде низ, кодиран в Base64. 7. Копирайте целия низ в Base64. 8. Декодирайте го с онлайн декодер за Base64, например [този](https://www.base64decode.org/), за да видите пълния XML на SAML твърдението. В декодирания XML трябва да потърсите следната информация: - Елементът `<saml:Issuer>` трябва да съответства на ID на субекта на вашия IdP. - Елементът `<saml:Audience>` трябва да съответства на ИД на обекта на Payhawk. - Елементът `<saml:NameID>` трябва да съдържа имейла или идентификатора на потребителя. - Всички съобщения за грешка или невалидни условия. #### Използване на разширение за браузър Разширенията за браузър могат да улеснят автоматичното заснемане и декодиране на SAML съобщения. Няколко препоръчителни разширения са: - SAML-tracer (Firefox): [инсталирайте оттук](https://addons.mozilla.org/en-US/firefox/addon/saml-tracer/). - SAML Chrome Panel (Chrome): [инсталирайте оттук](https://chromewebstore.google.com/detail/saml-chrome-panel/paijfdbeoenhembfhkhllainmocckace). За да използвате разширението за браузър за отстраняване на проблема: 1. Инсталирайте разширението. 2. Отворете панела на разширението (обикновено в инструментите за разработчици или като икона в лентата с инструменти на браузъра). 3. Стартирайте процеса на SSO влизане. 4. Разширението автоматично ще заснеме и покаже SAML заявката и отговора. 5. Експортирайте или копирайте декодирания XML на SAML отговора. #### Проверка на регистрационните файлове на вашия IdP Някои IdP, като Microsoft Entra ID (Azure AD), Okta или Google Workspace, предоставят подробни регистрационни файлове за влизане, които може да включват SAML твърдението или претенциите, изпратени до Payhawk. Ако използвате Microsoft Entra ID: 1. Влезте в [портала Azure](https://portal.azure.com). 2. Отидете в **Azure Active Directory** > **Корпоративни приложения** > **[Вашето приложение Payhawk]**. 3. Отидете в **Регистрационни файлове за влизане**. 4. Намерете неуспешния опит за влизане и щракнете, за да видите подробностите. 5. Потърсете подробности за SAML токена или издадените претенции. Ако използвате други IdP, проверете официалната документация на вашия IdP за достъп до регистрационните файлове за влизане или одит. ### Стъпка 3: Споделете диагностичните данни с eкипа за поддръжка на Payhawk След като съберете HAR файла и SAML отговора, изпратете ги на [support@payhawk.com](mailto:support@payhawk.com) или в чата, за да може екипът за поддръжка на Payhawk да ги анализира: В съобщението си трябва да включите следната информация: - Описание на проблема (например „SSO влизането е неуспешно с грешка X“) - HAR файлът - Декодираният XML на SAML отговора - Името на вашата компания и имейлът на потребителя ## Често срещани SAML проблеми и какво да проверите | Проблем | Възможна причина | Какво да проверите | | --- | --- | --- | | Влизането е неуспешно без известие | Потребителят не е назначен към приложението Payhawk в IdP | Проверете дали потребителят е назначен в IdP (например Azure AD, Okta). | | Невалиден SAML отговор | Неправилно конфигурирани идентификатори на субекти или крайни точки | Проверете дали идентификаторът на субекта и URL адресът на ACS съответстват на конфигурацията ви в IdP. | | Потребителят не е намерен | Несъответствие в имейла или NameID | Уверете се, че NameID за SAML съответства на имейла на потребителя в Payhawk. | | Грешка в сертификата | Изтекъл или несъответстващ сертификат за подписване | Проверете дали сертификатът на IdP е актуален в настройките за SSO. | | Цикъл на пренасочване | Неправилен URL адрес за иницииране на SSO | Уверете се, че използвате правилния URL адрес за вход в Payhawk чрез SSO. | ## Полезни ресурси - [Как мога да генерирам HAR файл за отстраняване на неизправности?](/help/how-can-i-generate-a-har-file-for-troubleshooting) - [Използване на SSO и настройване на SAML](/help/using-sso-and-setting-up-saml-with-payhawk) - [Не мога да вляза](/help/i-cannot-log-in)