Ако имате проблеми с влизането в Payhawk чрез базирана на SAML еднократна идентификация (SSO), това ръководство ще ви помогне да съберете диагностична информация, която може да ускори отстраняването и разрешаването на проблема.
Повечето проблеми при влизане чрез SSO възникват, когато потребителските акаунти или конфигурациите за SSO не са правилно настроени от администратора във вашия доставчик на самоличност (IdP) или в Payhawk.
Събиране на необходимите данни
Следните стъпки ще ви помогнат да съберете необходимите данни за установяване на основната причина:
Стъпка 1: Генерирайте HAR файл
HAR (HTTP архив) файлът записва цялата мрежова активност по време на опита ви за влизане, включително пренасочвания, заявки и отговори, като по този начин помага за диагностицирането на проблеми със свързаността, пренасочването или процеса на удостоверяване. За да създадете файла, необходим за отстраняване на проблема, вижте статията за генериране на HAR файлове.
Можете да използвате HAR файла в следните случаи:
Когато влизането ви е неуспешно без съобщение за грешка
Ако сте блокирани на празен екран или екран за зареждане
При възникване на цикъл на пренасочване при SSO
Стъпка 2: Заснемете отговора на SAML
Отговорът на SAML е съобщението за удостоверяване, изпратено от вашия IdP към Payhawk. То съдържа информация за потребителя, твърдението и всички грешки, които може да са възникнали по време на процеса на удостоверяване.
Заснемането на този отговор помага за установяване на несъответствия в конфигурацията, липсващи искове или невалидни твърдения.
Можете да заснемете SAML отговора по следните начини:
Използване на инструментите за разработчици на браузъра
Използването на инструментите за разработчици на браузъра ви е най-надеждният метод за заснемане на SAML отговор по време на влизане в реално време:
Отворете инструментите за разработчици на браузъра си – натиснете
F12или щракнете с десния бутон и изберете Проверка.Отидете в раздела Мрежа.
Стартирайте SSO влизане в Payhawk от вашия доставчик на самоличност.
Потърсете заявка
POSTкъмhttps://id.payhawk.com/saml2/idpresponse.Щракнете върху тази заявка и отидете в раздела Полезен обем или Данни от формуляра.
Намерете параметъра
SAMLResponse. Стойността ще бъде низ, кодиран в Base64.Копирайте целия низ в Base64.
Декодирайте го с онлайн декодер за Base64, например този, за да видите пълния XML на SAML твърдението.
В декодирания XML трябва да потърсите следната информация:
Елементът
<saml:Issuer>трябва да съответства на ID на субекта на вашия IdP.Елементът
<saml:Audience>трябва да съответства на ИД на обекта на Payhawk.Елементът
<saml:NameID>трябва да съдържа имейла или идентификатора на потребителя.Всички съобщения за грешка или невалидни условия.
Използване на разширение за браузър
Разширенията за браузър могат да улеснят автоматичното заснемане и декодиране на SAML съобщения.
Няколко препоръчителни разширения са:
SAML-tracer (Firefox): инсталирайте оттук.
SAML Chrome Panel (Chrome): инсталирайте оттук.
За да използвате разширението за браузър за отстраняване на проблема:
Инсталирайте разширението.
Отворете панела на разширението (обикновено в инструментите за разработчици или като икона в лентата с инструменти на браузъра).
Стартирайте процеса на SSO влизане.
Разширението автоматично ще заснеме и покаже SAML заявката и отговора.
Експортирайте или копирайте декодирания XML на SAML отговора.
Проверка на регистрационните файлове на вашия IdP
Някои IdP, като Microsoft Entra ID (Azure AD), Okta или Google Workspace, предоставят подробни регистрационни файлове за влизане, които може да включват SAML твърдението или претенциите, изпратени до Payhawk.
Ако използвате Microsoft Entra ID:
Влезте в портала Azure.
Отидете в Azure Active Directory > Корпоративни приложения > [Вашето приложение Payhawk].
Отидете в Регистрационни файлове за влизане.
Намерете неуспешния опит за влизане и щракнете, за да видите подробностите.
Потърсете подробности за 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. |