Payhawk документацията е в процес на превод. През това време част от статиите и свързаните ресурси ще са на български, а други на английски. Благодарим за търпението!

Отстраняване на проблеми при влизане чрез SAML SSO в Payhawk

Prev Next

Ако имате проблеми с влизането в Payhawk чрез базирана на SAML еднократна идентификация (SSO), това ръководство ще ви помогне да съберете диагностична информация, която може да ускори отстраняването и разрешаването на проблема.

Повечето проблеми при влизане чрез SSO възникват, когато потребителските акаунти или конфигурациите за SSO не са правилно настроени от администратора във вашия доставчик на самоличност (IdP) или в Payhawk.

Събиране на необходимите данни

Следните стъпки ще ви помогнат да съберете необходимите данни за установяване на основната причина:

  1. Генерирайте HAR файл

  2. Заснемете отговора на SAML

  3. Споделете диагностичните данни с Payhawk

Стъпка 1: Генерирайте HAR файл

HAR (HTTP архив) файлът записва цялата мрежова активност по време на опита ви за влизане, включително пренасочвания, заявки и отговори, като по този начин помага за диагностицирането на проблеми със свързаността, пренасочването или процеса на удостоверяване. За да създадете файла, необходим за отстраняване на проблема, вижте статията за генериране на HAR файлове.

Можете да използвате HAR файла в следните случаи:  

  • Когато влизането ви е неуспешно без съобщение за грешка  

  • Ако сте блокирани на празен екран или екран за зареждане  

  • При възникване на цикъл на пренасочване при SSO  

Стъпка 2: Заснемете отговора на SAML

Отговорът на SAML е съобщението за удостоверяване, изпратено от вашия IdP към Payhawk. То съдържа информация за потребителя, твърдението и всички грешки, които може да са възникнали по време на процеса на удостоверяване.

Заснемането на този отговор помага за установяване на несъответствия в конфигурацията, липсващи искове или невалидни твърдения.

Можете да заснемете SAML отговора по следните начини:

Използване на инструментите за разработчици на браузъра

Използването на инструментите за разработчици на браузъра ви е най-надеждният метод за заснемане на SAML отговор по време на влизане в реално време:

  1. Отворете инструментите за разработчици на браузъра си – натиснете F12 или щракнете с десния бутон и изберете Проверка.

  2. Отидете в раздела Мрежа.

  3. Стартирайте SSO влизане в Payhawk от вашия доставчик на самоличност.

  4. Потърсете заявка POST към https://id.payhawk.com/saml2/idpresponse.

  5. Щракнете върху тази заявка и отидете в раздела Полезен обем или Данни от формуляра.

  6. Намерете параметъра SAMLResponse. Стойността ще бъде низ, кодиран в Base64.

  7. Копирайте целия низ в Base64.

  8. Декодирайте го с онлайн декодер за Base64, например този, за да видите пълния XML на SAML твърдението.

В декодирания XML трябва да потърсите следната информация:

  • Елементът <saml:Issuer> трябва да съответства на ID на субекта на вашия IdP.

  • Елементът <saml:Audience> трябва да съответства на ИД на обекта на Payhawk.

  • Елементът <saml:NameID> трябва да съдържа имейла или идентификатора на потребителя.

  • Всички съобщения за грешка или невалидни условия.

Използване на разширение за браузър

Разширенията за браузър могат да улеснят автоматичното заснемане и декодиране на SAML съобщения.

Няколко препоръчителни разширения са:

За да използвате разширението за браузър за отстраняване на проблема:

  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.

  2. Отидете в Azure Active Directory > Корпоративни приложения > [Вашето приложение Payhawk].

  3. Отидете в Регистрационни файлове за влизане.

  4. Намерете неуспешния опит за влизане и щракнете, за да видите подробностите.

  5. Потърсете подробности за SAML токена или издадените претенции.

Ако използвате други IdP, проверете официалната документация на вашия IdP за достъп до регистрационните файлове за влизане или одит.

Стъпка 3: Споделете диагностичните данни с eкипа за поддръжка на Payhawk

След като съберете HAR файла и SAML отговора, изпратете ги на 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.

Полезни ресурси