--- title: "SAML SSO с OneLogin за администратори - Payhawk Help Center" slug: "setting-up-saml-sso-with-onelogin" description: "Настройте SAML SSO между OneLogin и Payhawk: добавете конектора на Payhawk, съпоставете атрибута за имейл, назначете потребители и изпратете метаданните на IdP." updated: 2026-10-23T07:51:16Z published: 2026-10-23T07:51:16Z 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 с OneLogin [OneLogin](https://www.onelogin.com/) (вече част от One Identity) е независим доставчик на самоличност, а Payhawk е наличен като готов конектор в каталога с приложения. Тъй като конекторът вече съдържа настройките на доставчика на услуги на Payhawk, настройката се свежда основно до добавяне на приложението, потвърждаване на домейна и съпоставянето на имейли и задаване на потребителите, след което те влизат в Payhawk с идентификационните си данни за OneLogin. > [!WARNING] > Езикът за маркиране на твърдения за сигурност (SAML) не поддържа удостоверяване, инициирано от доставчика на самоличност. Потребителите ви трябва винаги да започват от страницата за вход в Payhawk. Когато двуфакторното удостоверяване (2FA) е активирано, то продължава да се прилага и еднократното влизане (SSO) не го замества. ## Преди да започнете - Необходим ви е достъп като Администратор до акаунта ви в OneLogin. - Необходими са ви права на Администратор на Payhawk, за да координирате настройката. - Подгответе домейните за удостоверяване (например `yourcompany.com`) – имейл домейните, с които потребителите ви влизат в системата. - Имейлът, който OneLogin изпраща за всеки потребител, трябва да съвпада точно с имейла на акаунта му в Payhawk. Несъответствието в имейлите води до неуспешни влизания или дублирани потребители. ## Настройки на доставчика на услуги на Payhawk Конекторът на Payhawk в каталога на OneLogin е предварително попълнен със стойностите по-долу и в повечето случаи трябва само да ги потвърдите, а не да ги въвеждате ръчно. | Настройка | Стойност | | --- | --- | | Домейн (конфигурация) | `payhawk` | | Съпоставяне на атрибути | `email` → **Имейл**, включен в SAML твърдението | | Underlying ACS URL (Основен URL адрес на услугата за приемане на твърдения) | `https://id.payhawk.com/saml2/idpresponse` | | Underlying SP Entity ID (Основен идентификатор на обект на доставчика на услуги) | `urn:amazon:cognito:sp:eu-central-1_mcW4Iwl7p` | ## Създаване и конфигуриране на SAML приложението 1. Влезте като Администратор в своя акаунт в OneLogin. 2. Навигирайте до **Applications** (Приложения) > **Add App** (Добавяне на приложение) и потърсете **Payhawk**. 3. Изберете конектора на Payhawk и оставете настройките непроменени на началния екран. Изберете **Save** (Запазване). 4. В раздела **Configuration** (Конфигурация) проверете дали **Domain** (Домейн) е зададен на **payhawk**. ## Съпоставяне на атрибута за имейл Payhawk изисква имейл адреса на потребителя в твърдението. 1. В раздела **Parameters** (Параметри) проверете дали съпоставянето на атрибута е **email** → **Имейл**. 2. Проверете дали опцията **Include in SAML assertion** (Включване в SAML твърдението) е отметната за този параметър. ## Задаване на потребители 1. Запазете приложението и го активирайте за всички потребители, които трябва да го използват (чрез роли в OneLogin или директно задаване). 2. Проверете дали имейлът на всеки зададен потребител съвпада с акаунта му в Payhawk. ## Експортиране на метаданните на доставчика на самоличност и изпращането им към Payhawk 1. От горния десен ъгъл на приложението изберете **More Actions** (Повече действия) > **SAML Metadata** (SAML метаданни), за да изтеглите метаданните на доставчика на самоличност като XML файл. Той съдържа SSO крайната точка, идентификатора на обекта и сертификата за подписване на OneLogin, необходими на Payhawk. 2. Свържете се с Мениджъра си по имплементация на Payhawk и предоставете XML файла с метаданните на доставчика на самоличност, домейна/домейните ви за удостоверяване и потвърждение за съпоставянето на атрибута за имейл. Payhawk завършва конфигурацията от страна на сървъра, след което ще получите потвърждение, когато SSO е готово за тестване. ## Тестване на влизането 1. Отидете на страницата за влизане в Payhawk. 2. Въведете корпоративен имейл адрес в домейн с активирано SSO. 3. Удостоверете се чрез OneLogin и изпълнете всяка стъпка на OneLogin Protect или такава за двуфакторно удостоверяване. 4. При успех ще се върнете в Payhawk, но вече влезли в системата. ## Отстраняване на неизправности - Пренасочване обратно към страницата за влизане или отказан достъп – Проверете дали параметърът `email` е включен в SAML твърдението и дали стойността му съвпада точно с имейла на акаунта в Payhawk. - Приложението не е зададено – Потребителят няма достъп до приложението Payhawk чрез роля в OneLogin или директно задаване. - Неуспешно влизане, инициирано от доставчика на самоличност – Това е очаквано поведение. Потребителите трябва да започват от страницата за влизане в Payhawk, а не от портала на OneLogin.