# Настройка SSO

*Время чтения: 5 минут*

{% hint style="info" %}
**SSO** (Single sign-on или Технология единого входа) — метод аутентификации (регистрации/входа), который позволяет пользователям безопасно аутентифицироваться сразу в нескольких приложениях и сайтах, используя один набор учетных данных. 

В **Reezonly Space** реализована возможность использовать SSO и в данной статье мы расскажем как это работает. 
{% endhint %}

## Как добавить SSO в Reezonly Space

Вы можете настроить параметры SSO на вкладке **Авторизация -> Настройки авторизации -> Форма входа -> SSO** (Рис. №1)

<figure><img src="https://291055316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3Ys5RYQvMMCdr8qMKQR%2Fuploads%2FkihulMXfhdH12ZB2GBXf%2Fimage.png?alt=media&#x26;token=192cdeb4-c394-451e-ba7c-5ef4e9b14cb7" alt=""><figcaption><p>Рис. №1</p></figcaption></figure>

Добавить SSO можно следующим образом (Рис. №2):&#x20;

<figure><img src="https://291055316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3Ys5RYQvMMCdr8qMKQR%2Fuploads%2F8DcuJ93S6O9hygm1DW1i%2F%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D1%8C-2024-10-21-181926.gif?alt=media&#x26;token=5a3cad44-328a-4960-9e4b-ebeb8a811b5a" alt="" width="563"><figcaption><p>Рис. №2</p></figcaption></figure>

1. Кликните на кнопку **SSO** в разделе **Форма входа**
2. В открывшемся окне нажмите кнопку **+Добавить**
3. В открывшемся окне **Добавить способ входа** внесите данные в поля и нажмите **Далее**: &#x20;
   1. **Название** (ваше внутреннее название метода входа по SSO)
   2. **Провайдер SSO**. С помощью выпадающего списка выберите сервис, через который будет происходить аутентификация. Для входа доступны следующие сервисы: Oauth2 (ваше собственное подключение), Yandex, Mail.ru, Google, GitHub, Facebook, Live & Linkedin. После выбора провайдера вам необходимо заполнить следующие поля:&#x20;
      1. **client\_id -** это уникальный идентификатор приложения, используемый для аутентификации в системе SSO. Обычно состоит из 32–64 символов и выдается провайдером SSO  при регистрации приложения.
      2. **client\_secret -** это секретный ключ, который используется вместе с Client ID для безопасной аутентификации приложения в системе SSO. Обычно состоит из 32–128 символов и выдается провайдером SSO при регистрации приложения.
      3. **Внешний User ID** - это уникальный номер для сервиса, который подключается к SSO-провайдеру.  Чаще всего это число, например, 1. **Используется только для способа Oauth2.**
      4. **URL авторизации** - это адрес, на который перенаправляется пользователь для входа в систему через SSO. Этот URL предоставляется вашим провайдером SSO и используется для запуска процесса аутентификации. **Используется только для способа Oauth2.**
      5. **URL получения токена** - это адрес, на который ваше приложение отправляет запрос после успешной авторизации пользователя, чтобы получить токен доступа. Этот URL предоставляется провайдером SSO и используется для обмена авторизационным кодом на токен. **Используется только для способа Oauth2.**
      6. **URL получения информации о пользователе** - это адрес, на который ваше приложение отправляет запрос для получения данных о пользователе после получения токена доступа. Этот URL предоставляется провайдером SSO и используется для получения профиля пользователя. **Используется только для способа Oauth2.**
   3. **URL редиректа после авторизации** (страница, на которую будет перенаправлен пользователь после входа по SSO)
4. В следующем окне выберите данные, которые вы хотите забирать из сервиса SSO и нажмите **Далее**:&#x20;
   1. В выпадающем списке выберите ключи поля профиля Reezonly Space
   2. В появившихся значениях введите ключи из выбранного сервиса SSO. После авторизации, в поля профиля Reezonly Space будут добавлены эти значения из ключей сервиса SSO
5. На следующей странице Настройте стиль кнопки введите значения и нажмите **Готово**:
   1. **Название** (название кнопки для пользователя)
   2. **Цвет**. Выберите в цветовой палитре цвет кнопки для пользователя&#x20;
   3. **Иконка**. С помощью данной кнопки вы можете загрузить иконки для более эстетичного оформления&#x20;

После добавления способа **SSO**, будет автоматически сгенерирован **URI** (это строка, которая однозначно идентифицирует ваш Space в интернете).&#x20;

**URI** необходимо вписывать в настройки вашего приложения на стороне провайдера SSO. Он указывает, куда отправить пользователя после авторизации. При использовании, ваше приложение должно проверять, что перенаправление происходит на этот URI, чтобы предотвратить возможные атаки и обеспечить безопасность.

Как узнать URI в Reezonly Space:&#x20;

1. В списке SSO кликните на нужный вам способ&#x20;
2. В открывшемся окне перейдите в раздел **Параметры протокола,** где вы и найдете параметр **URI**

<figure><img src="https://291055316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3Ys5RYQvMMCdr8qMKQR%2Fuploads%2FET5BkorlFoDKkDptYPmJ%2Fimage.png?alt=media&#x26;token=733f9d57-e8dc-44bb-b3cc-150bc400bfee" alt="" width="278"><figcaption></figcaption></figure>

{% hint style="success" %}
После того, как вы нажмете кнопку **Готово**, добавленный способ входа через SSO будет работать через 5 минут.&#x20;
{% endhint %}

{% hint style="info" %}
Значения для полей SSO (client\_id и т.д.) вы можете узнать у провайдера SSO
{% endhint %}

### Как редактировать параметры добавленного SSO

Для редактирования параметра SSO выполните следующие действия:&#x20;

<figure><img src="https://291055316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3Ys5RYQvMMCdr8qMKQR%2Fuploads%2FXBe1tpXPI5eNkTfdqDyQ%2F%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D1%8C-2024-10-21-182638.gif?alt=media&#x26;token=67ace56e-c032-41ce-88e5-28f06ea5b5f8" alt="" width="293"><figcaption></figcaption></figure>

1. Кликните на **"...**" и выберите **Редактировать**
2. Внесите нужные изменения в настроенных ранее парамтерах&#x20;
3. Кликните на кнопку **Сохранить**

### Выключение и удаление добавленного SSO

Для отключения способа аутентификации вы можете переключить нужный тумблер в списке всех SSO (Рис. №3):

<figure><img src="https://291055316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3Ys5RYQvMMCdr8qMKQR%2Fuploads%2FZnivCmIqKBzce0YXTcvw%2Fimage.png?alt=media&#x26;token=0fbea41c-0272-455a-9ca5-4ef2e8428480" alt="" width="284"><figcaption><p>Рис. №3</p></figcaption></figure>

Удалить нужный способ аутентификации по SSO вы можете следующим образом (Рис. №4):&#x20;

<figure><img src="https://291055316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3Ys5RYQvMMCdr8qMKQR%2Fuploads%2FqKoZuDNrxRy0S3ZdkypW%2F%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D1%8C-2024-10-21-182234.gif?alt=media&#x26;token=1e8b726b-a614-444f-a8df-796473c45b86" alt="" width="297"><figcaption><p>Рис. №4</p></figcaption></figure>

1. Кликните на кнопку "..." в правой части строки способа SSO&#x20;
2. Выберите **Удалить**&#x20;
3. Подтвердите удаление на открывшейся странице

{% hint style="info" %}
В этой статье мы рассказали вам о работе с  SSO на платформе Reezonly Space. Информацию о другой функциональности платформы вы можете узнать в следующих статьях базы знаний.&#x20;
{% endhint %}