Создать SAML-приложение в Yandex Identity Hub для интеграции с Sentry
Sentry
Чтобы пользователи вашей организации могли аутентифицироваться в Sentry с помощью технологии единого входа по стандарту SAML
Управлять SAML-приложениями может пользователь, которому назначена роль organization-manager.samlApplications.admin или выше.
Примечание
Для интеграции с помощью SAML для вашего экземпляра Sentry должен быть настроен публичный домен и корректный SSL-сертификат.
Чтобы дать доступ пользователям вашей организации в Sentry:
Создайте приложение в Identity Hub
- Войдите в сервис Yandex Identity Hub
. - На панели слева выберите
Приложения. - В правом верхнем углу страницы нажмите
Создать приложение и в открывшемся окне:-
Выберите метод единого входа SAML (Security Assertion Markup Language).
-
В поле Имя задайте имя создаваемого приложения:
sentry-app. -
(Опционально) В поле Описание задайте описание приложения.
-
(Опционально) Добавьте метки:
- Нажмите Добавить метку.
- Введите метку в формате
ключ: значение. - Нажмите Enter.
-
Нажмите Создать приложение.
-
- Сохраните значение поля Metadata URL, оно понадобится на следующем шаге.
Настройте интеграцию
Настройте SAML-приложение на стороне Yandex Identity Hub
Найдите слаг организации
Для настройки эндпоинтов вам понадобится слаг организации (Organization Slug), по умолчанию имеет значение sentry. Чтобы найти слаг вашей организации:
- Войдите в Sentry.
- В меню слева нажмите кнопку Settings.
- Во вкладке Organization выберите пункт General Settings.
- Скопируйте значение поля Organization Slug.
Настройте эндпоинты поставщика услуг
- Войдите в сервис Yandex Identity Hub
. - На панели слева выберите
Приложения и выберите нужное SAML-приложение. - Справа сверху нажмите
Редактировать и в открывшемся окне:- В поле SP EntityID вставьте значение
<адрес_инстанса_sentry>/saml/metadata/<слаг_организации>/. - В поле ACS URL вставьте значение
<адрес_инстанса_sentry>/saml/acs/<слаг_организации>/. - (Опционально) В поле SP Logout URL вставьте значение
<адрес_инстанса_sentry>/saml/sls/<слаг_организации>/. - Нажмите Сохранить.
- В поле SP EntityID вставьте значение
Настройте аутентификацию на стороне Sentry
- Войдите в Sentry под пользователем с правами владельца организации.
- В меню слева нажмите кнопку Settings.
- Во вкладке Organization выберите пункт Auth.
- В списке провайдеров выберите SAML2.
- Нажмите Configure.
- В поле Metadata URL введите адрес файла с метаданными, скопированный ранее.
- Нажмите Get metadata.
- В разделе Map Identity Provider Attributes заполните поля:
- В поле IdP User ID введите
fullname. - В поле User Email введите
emailaddress. - (Опционально) В поле First Name введите
givenname. - (Опционально) В поле Last Name введите
surname.
- В поле IdP User ID введите
- Нажмите Save Settings.
Добавьте пользователя
Чтобы пользователи вашей организации могли аутентифицироваться в Sentry с помощью SAML-приложения Identity Hub, необходимо явно добавить в SAML-приложение нужных пользователей и/или группы пользователей.
Примечание
Управлять пользователями и группами, добавленными в SAML-приложение, может пользователь, которому назначена роль organization-manager.samlApplications.userAdmin или выше.
-
Добавьте пользователей в приложение:
Интерфейс Cloud Center- Войдите в сервис Yandex Identity Hub
. - На панели слева выберите
Приложения и выберите нужное приложение. - Перейдите на вкладку Пользователи и группы.
- Нажмите
Добавить пользователей. - В открывшемся окне выберите нужного пользователя или группу пользователей.
- Нажмите Добавить.
- Войдите в сервис Yandex Identity Hub
Убедитесь в корректной работе приложения
Чтобы убедиться в корректной работе SAML-приложения и интеграции с Sentry, выполните аутентификацию в Sentry от имени одного из добавленных в приложение пользователей. Для этого:
- В браузере перейдите по адресу вашего экземпляра Sentry.
- На странице аутентификации нажмите Login with SAML2.
- На странице аутентификации Yandex Cloud укажите почту и пароль пользователя. Пользователь должен быть добавлен в приложение или состоять в группе, добавленной в приложение. Также у пользователя должна быть указана почта.
- Убедитесь, что вы аутентифицировались в Sentry.