Создать SAML-приложение в Yandex Identity Hub для интеграции с Пассворк
Пассворк
Чтобы пользователи вашей организации могли аутентифицироваться в Пассворк с помощью технологии единого входа по стандарту SAML
Управлять SAML-приложениями может пользователь, которому назначена роль organization-manager.samlApplications.admin или выше.
Чтобы предоставить пользователям вашей организации доступ в Пассворк:
- Создайте SAML-приложение в Yandex Identity Hub.
- Настройте интеграцию Yandex Identity Hub с Пассворк.
- Убедитесь в корректной работе приложения.
Создайте приложение
- Войдите в сервис Yandex Identity Hub
. - На панели слева выберите
Приложения. - В правом верхнем углу страницы нажмите
Создать приложение и в открывшемся окне:-
Выберите метод единого входа SAML (Security Assertion Markup Language).
-
В поле Имя задайте имя создаваемого приложения:
passwork-app. -
(Опционально) В поле Описание задайте описание приложения.
-
(Опционально) Добавьте метки:
- Нажмите Добавить метку.
- Введите метку в формате
ключ: значение. - Нажмите Enter.
-
Нажмите Создать приложение.
-
Сохраните настройки поставщика удостоверений
На открывшейся странице с информацией о вновь созданном SAML-приложении passwork-app скопируйте и сохраните настройки, необходимые для установления отношений доверия между поставщиком удостоверений и поставщиком услуг на стороне Пассворк:
-
В блоке Конфигурация поставщика удостоверений (IdP) скопируйте и сохраните значения следующих полей:
- Issuer / IdP EntityID;
- Login URL;
- Logout URL.
-
В блоке Сертификат приложения нажмите кнопку Скачать сертификат, чтобы скачать сертификат вашего SAML-приложения.
Сохраненные значения понадобятся позднее при настройке интеграции на стороне Пассворк.
Настройте интеграцию
Чтобы настроить интеграцию Пассворк с созданным SAML-приложением в Yandex Identity Hub, выполните настройки на стороне Пассворк и на стороне Yandex Identity Hub.
Настройте SAML-приложение на стороне Пассворк
Примечание
Настройку SAML-приложения в Пассворк может выполнять пользователь с ролью администратора или владельца аккаунта.
-
Аутентифицируйтесь в аккаунте Пассворк от имени владельца или администратора.
-
В верхней части экрана нажмите Настройки и пользователи и в появившемся списке выберите Настройки SSO. В открывшемся окне:
-
В блоке Общие настройки включите опции:
- Включить SSO;
- Автоматически подтверждать новых пользователей из SSO.
-
В блоке Атрибуты пользователя укажите имена атрибутов пользователей:
- в поле Атрибут для электронной почты —
emailaddress; - в поле Атрибут для полного имени —
fullname.
- в поле Атрибут для электронной почты —
-
В блоке Поставщик удостоверений → Пассворк укажите скопированные ранее (в приложении
passwork-app) и сохраненные значения настроек:- в поле Идентификатор (Entity ID) укажите значение из поля Issuer / IdP EntityID приложения
passwork-app; - в поле URL ответа (URL службы обработчика утверждений) — значение из поля Login URL;
- в поле URL выхода — значение из поля Logout URL;
- в поле Сертификат вставьте содержимое скачанного в приложении
passwork-appсертификата.
- в поле Идентификатор (Entity ID) укажите значение из поля Issuer / IdP EntityID приложения
-
-
В блоке Пассворк → Поставщик удостоверений скопируйте и сохраните значения настроек, необходимые для установления отношений доверия между поставщиком удостоверений и поставщиком услуг на стороне Yandex Identity Hub:
- Идентификатор (Entity ID);
- URL ответа (URL службы обработчика утверждений);
- URL выхода.
-
Нажмите кнопку Сохранить настройки, чтобы сохранить заданные параметры единого входа.
Настройте SAML-приложение на стороне Yandex Identity Hub
- Войдите в сервис Yandex Identity Hub
. - На панели слева выберите
Приложения и выберите созданное ранее SAML-приложениеpasswork-app. - Справа сверху нажмите
Редактировать и в открывшемся окне:- В поле SP EntityID укажите значение, скопированное ранее из поля Идентификатор (Entity ID) на стороне Пассворк.
- В поле ACS URL — значение, скопированное из поля URL ответа (URL службы обработчика утверждений).
- В поле SP Logout URL — значение, скопированное из поля URL выхода.
- Нажмите Сохранить.
Добавьте пользователей в SAML-приложение Yandex Identity Hub
Чтобы пользователи вашей организации могли аутентифицироваться в Пассворк с помощью SAML-приложения Yandex Identity Hub, необходимо явно добавить в это приложение нужных пользователей и/или группы пользователей:
Примечание
Управлять пользователями и группами, добавленными в SAML-приложение, может пользователь, которому назначена роль organization-manager.samlApplications.userAdmin или выше.
- Войдите в сервис Yandex Identity Hub
. - На панели слева выберите
Приложения и выберите нужное приложение. - Перейдите на вкладку Пользователи и группы.
- Нажмите
Добавить пользователей. - В открывшемся окне выберите нужных пользователей или группы пользователей.
- Нажмите Добавить.
Убедитесь в корректной работе приложения
Чтобы убедиться в корректной работе SAML-приложения и интеграции с Пассворк, выполните аутентификацию в Пассворк от имени одного из добавленных в приложение пользователей. Для этого:
-
В браузере перейдите по адресу вашего экземпляра Пассворк (например,
https://my-domain.passwork-cloud.ru). -
Если вы уже авторизованы в Пассворк, выйдите из профиля.
-
На странице аутентификации Пассворк нажмите Войти через SSO.
-
На странице аутентификации Yandex Cloud укажите адрес электронной почты и пароль пользователя. Пользователь должен быть добавлен в приложение или состоять в группе, добавленной в приложение.
Если вы аутентифицируетесь от имени пользователя с аккаунтом на Яндексе, пройдите аутентификацию в Яндекс ID удобным вам способом.
-
Задайте мастер-пароль для нового пользователя, добавляемого в Пассворк.
-
Убедитесь, что вы аутентифицировались в Пассворк. В результате новый пользователь появится в настройках вашего экземпляра Пассворк, и вы сможете настраивать для него права на просмотр и управление секретами.