Подключение Sentry¶

Sentry — это платформа для мониторинга и отслеживания ошибок в приложениях. Она помогает разработчикам выявлять, анализировать и исправлять ошибки в реальном времени, улучшая качество программного обеспечения.

Базовая версия продукта не поддерживает аутентификацию через OpenID Connect. Чтобы реализовать эту функцию, можно использовать дополнительное решение — sentry-auth-oidc. Это специальный провайдер, который обеспечивает интеграцию OpenID Connect с Sentry и позволяет настроить единый вход (SSO) в системе.

Шаг 1. Создание приложения в Trusted ID¶

1. Авторизуйтесь или зарегистрируйтесь Trusted ID.

2. Создайте приложение. Подробнее о создании приложений читайте в инструкции.

   

3. Перейдите в настройки приложения. Скопируйте значения полей Идентификатор (Client_id) и Секретный ключ (client_secret).

   

Шаг 2. Установка sentry-auth-oidc¶

1. Для установки провайдера выполните консольную команду:

   $ pip install sentry-auth-oidc
   

   или создайте Shell-скрипт с содержимым

   #!/bin/bash
   set -euo pipefail
   apt-get update
   pip install sentry-auth-oidc
   

   и запустите его из каталога <путь к Sentry>/sentry/.

2. После установки провайдера отредактируйте файл конфигурации Sentry sentry.conf.py. В файле конфигурации добавьте блок переменных с параметрами OIDC_CLIENT_ID и OIDC_CLIENT_SECRET, скопированными из приложения Trusted ID.

   #################
   # OIDC #
   #################
   
   #SENTRY_MANAGED_USER_FIELDS = ('email', 'first_name', 'last_name', 'password', )
   
   OIDC_CLIENT_ID = "client id из приложения Trusted ID"
   OIDC_CLIENT_SECRET = "client secret из приложения Trusted ID"
   OIDC_SCOPE = "openid email profile"
   OIDC_DOMAIN = "https://<адрес Trusted ID>/api/oidc"
   OIDC_ISSUER = "имя модуля для выставления разрешений"
   

   После этого запустите скрипт, который лежит в корне проекта Sentry install.sh, дождитесь исполнения скрипта и запустите проект.

3. Перейдите в панель администратора Sentry по адресу https://<путь к Sentry>/settings/sentry/ и выберите раздел Auth. Далее выберите приложение Trusted.ID.

   

Выставите все необходимые настройки и сохраните изменения. После этого будет включена авторизация с помощью Trusted.ID, а вход по логину/паролю будет отключен.

Подключение Sentry по протоколу OpenID Connect доступно только с версии продукта Trusted ID 3.2. В предыдущих версиях этот функционал недоступен.

После всех настроек переходим по адресу установки Sentry и наблюдаем приветственный диалог: