Включите Okta SAML и SCIM в airfocus

Введение в SAML SSO и SCIM

Интеграция airfocus с Okta позволяет пользователям проходить аутентификацию с помощью единого входа SAML через Okta. Единый вход позволяет администратору вашей команды airfocus определять, кто имеет доступ к airfocus, используя существующее решение для управления идентификацией (IdP). Члены вашей команды смогут беспрепятственно получать доступ к airfocus, если они авторизованы в системе IdP вашей организации.

Кроме того, наша интеграция с SCIM позволяет администраторам создавать пользователей, а также предоставлять и отзывать права доступа к ним непосредственно в Okta, без необходимости входа в airfocus.

Настройка SAML в Okta

1. Войдите в Okta.
2. Перейдите на страницу «Приложения».
3. Нажмите «Создать интеграцию приложения» , чтобы создать новое SAML-приложение в Okta.
4. Выберите SAML 2.0 в качестве способа входа в систему.
5. Нажмите «Далее».
6. Введите название для создаваемого вами приложения AirFocus.
7. Нажмите «Далее».
   
8. Настройте следующие значения: 
   • URL для единого входа: https://auth.airfocus.com/login/sso/callback/saml  
   • URI аудитории (идентификатор сущности SP): https://airfocus.com 
     • Обратите внимание: если вы находитесь в США или Азиатско-Тихоокеанском регионе и ваша учетная запись была создана после сентября 2025 года, замените "airfocus.com" в указанных выше URL-адресах на "airfocus.app".
       
9. Перейдите в раздел «Операторы атрибутов» и настройте следующие значения:
   • email = user.email
   • givenName = user.firstName
   • фамилия = пользователь.фамилия
     
10. Прокрутите страницу вниз и нажмите «Далее».
11. На странице обратной связи отметьте пункт «Это внутреннее приложение, созданное нами».
12. Нажмите «Готово».
    
13. В созданном вами приложении airfocus в Okta выберите вкладку «Назначения» .
14. Убедитесь, что вы добавили в приложение хотя бы себя в качестве разрешенного пользователя.
    • Если вы еще этого не сделали, воспользуйтесь функцией «Назначить».
15. Затем выберите вкладку « Вход в систему ».
16.  В правой части экрана прокрутите вниз при необходимости и выберите кнопку «Просмотреть инструкции по настройке SAML» . 
17. Обратите внимание на три указанных значения.
    
18. Войдите в AirFocus.
19. Перейдите на страницу конфигурации SAML в airfocus. 
20. В разделе «Поставщик» выберите «Настроить SAML SSO».
    
21. Перейдите в «Настройки Команды». 
22. Выберите вкладку «Безопасность/Единый вход» .
23. Задайте следующие значения, скопировав и вставив их из шага 17, описанного выше:
    • URL-адрес единого входа IDP: {first value from the step above}
    • Эмитент IDP: {second value from the step above}
    • Сертификат IDP X.509: {third value from the step above}
      
24. Нажмите «Тест».
25. Вас должны перенаправить на страницу входа в Okta, а оттуда обратно в airfocus, где вы увидите подтверждение того, что все прошло успешно.
    
26. При желании вы можете принудительно включить единый вход в систему для всей команды, установив флажок «Принудительно включить единый вход».
    • После включения этой функции участники смогут входить в систему только с использованием SAML SSO. Вход по электронной почте и паролю будет отключен.
      
27. Выберите «Применить».
     

Настройка Okta SCIM

Чтобы настроить Okta SCIM для вашей учетной записи:

1. Войдите в Okta. 
2. Перейдите к приложению airfocus, которое вы создали в соответствии с инструкциями по настройке Okta SAML, приведенными выше.
3. Выберите вкладку «Общие» для вашего пользовательского приложения Okta.
4. Перейдите в режим редактирования настроек приложения.
5. В разделе "Настройка" выберите "SCIM".
6. Нажмите « Сохранить ». Оставьте эту вкладку открытой, мы вернемся к ней через несколько шагов.
7. В новой вкладке войдите в airfocus.
8. Перейдите в «Настройки Команды». 
9. Выберите вкладку «Безопасность/Единый вход» .
10. Нажмите «Включить SCIM».
11. Обратите внимание на базовый URL-адрес, идентификатор команды и сгенерированный токен.
    
12. Вернитесь на вкладку Okta.
13. В Okta выберите вкладку «Подготовка ресурсов» для вашего приложения.
14. Нажмите кнопку «Редактировать» в правой части окна «Подключение SCIM».
15. Настройте следующие значения:
    • SCIM-контекстный базовый URL: базовый URL, указанный на странице управления пользователями SCIM.
    • Уникальное поле-идентификатор для пользователей: поле userName.
    • Действия по предоставлению ресурсов: отметьте все блоки.
    • Режим аутентификации: HTTP-заголовок
    • Авторизационный носитель: только что сгенерированный SCIM-токен.
      
16. Нажмите «Проверить конфигурацию» , чтобы убедиться в её работоспособности.
17. Выберите «Сохранить».
18. На вкладке «Подготовка к использованию» нажмите «Редактировать» справа от «Подготовка к использованию приложения».
19. Установите флажки в соответствующем блоке, чтобы включить функции «Создать пользователей», «Обновить атрибуты пользователей» и «Деактивировать пользователей».
20. Нажмите « Сохранить ».
    

Группы SCIM

Чтобы создать группу:

1. Убедитесь, что в вашем приложении Okta включены группы SCIM (это делается на шаге 5 раздела «Настройка SCIM» выше).
2. В Okta перейдите на вкладку «Группы каталогов».
3. Нажмите «Добавить группу».
4. Укажите имя и, при желании, описание.
5. Выберите «Сохранить».
6. Выберите группу на вкладке «Группы каталога» в Okta.
7. Внутри группы перейдите на вкладку «Приложения».
8. Нажмите «Назначить приложения».
9. Справа от "airfocus" выберите "Назначить ".
10. Нажмите «Сохранить и вернуться назад».
11. Нажмите «Готово».

Назначьте пользователей из группы SCIM в Okta, используя один из следующих способов:

• На вкладке «Люди» нажмите «Назначить людей» и сделайте это для каждого человека отдельно.
• На вкладке «Группы» введите названия групп Okta, которые вы хотите объединить в одну группу.

После назначения пользователей в группу SCIM выполните следующие действия для синхронизации с airfocus:

1. Перейдите в приложение airfocus в Okta.
2. Выберите вкладку « Группы push-уведомлений» .
3. Выберите раскрывающийся список «Группы push-уведомлений» .
4. В раскрывающемся списке выберите «Найти группы по имени».
5. Введите название вашей группы и выделите её. 
6. Нажмите «Сохранить».

Теперь в Okta и airfocus он должен отображаться как «Активный».

Роли пользователей

В Airfocus есть три роли пользователей: Участник, Редактор и Администратор. Эти роли можно настроить через Okta, но для этого потребуется небольшая дополнительная настройка, поскольку Okta не предоставляет роли по умолчанию. Для корректной работы необходимо создать роли для профилей пользователей Okta, затем для профилей пользователей приложения airfocus в Okta, а затем сопоставить их друг с другом.

Для настройки ролей пользователей:

1. Войдите в Okta.
2. Перейдите в каталог. 
3. В выпадающем меню выберите «Редактор профиля».
4. Щелкните на профиль пользователя (по умолчанию) для Okta.
5. Выберите «Добавить атрибут».
6. Создайте роль участника со следующими данными. Эти значения чувствительны к регистру.
   • Тип данных: логическое значение
   • Отображаемое имя: Участник
   • Название переменной: contributor
   • Оставьте для пользователя права доступа «Только для чтения».
7. Нажмите «Сохранить и добавить еще один».
8. Создайте роль «Редактор» со следующими данными. Эти значения чувствительны к регистру.
   • Тип данных: логическое значение
   • Отображаемое имя: Редактор
   • Имя переменной: editor
9. Нажмите «Сохранить и добавить еще один».
10. Создайте роль администратора со следующими данными. Эти значения чувствительны к регистру.
    • Тип данных: логическое значение
    • Отображаемое имя: Администратор
    • Имя переменной: administrator
11. Нажмите «Сохранить».
12. Вернитесь на страницу редактора профиля.
13. Выберите профиль пользователя airfocus .
14. Выберите «Добавить атрибут».
15. Создайте роль участника со следующими данными. Эти значения чувствительны к регистру.
    • Тип данных: строка
    • Отображаемое имя: Участник
    • Название переменной: contributor
    • Внешнее имя: roles.^[type=='contributor'].value
    • Внешнее пространство имен: urn:ietf:params:scim:schemas:core:2.0:User
16. Нажмите «Сохранить и добавить еще один».
17. Создайте роль «Редактор» со следующими данными. Эти значения чувствительны к регистру.
    • Тип данных: строка
    • Отображаемое имя: Редактор
    • Имя переменной: editor
    • Внешнее имя: roles.^[type=='editor'].value
    • Внешнее пространство имен: urn:ietf:params:scim:schemas:core:2.0:User
18. Нажмите «Сохранить и добавить еще один».
19. Создайте роль администратора со следующими данными. Эти значения чувствительны к регистру.
    • Тип данных: строка
    • Отображаемое имя: Администратор
    • Имя переменной: administrator
    • Внешнее имя: roles.^[type=='admin'].value
    • Внешнее пространство имен: urn:ietf:params:scim:schemas:core:2.0:User
20. Нажмите «Сохранить».
21. В разделе «Атрибуты» выберите «Сопоставления».
22. В верхней части страницы выберите Okta User to airfocus .
23. Прокрутите страницу вниз и в правом столбце найдите строки с новыми атрибутами роли.
    • Слева от поля «участник» введите: (user.contributor == true) ? 'участник' : ''
    • Слева от слова «редактор» введите: (user.editor == true) ? 'редактор' : ''
    • Слева от слова «администратор» введите: (user.administrator) == true) ? 'admin' : ''
      • Примечание: кавычки в конце каждого утверждения — это две одинарные кавычки, а не одна двойная.
        
24. Нажмите «Сохранить сопоставления».
25. Выберите «Применить обновления».

Чтобы назначить пользователю роли, выполните следующие действия:

1. Войдите в Okta.
2. Перейдите в каталог.
3. В выпадающем меню выберите «Люди».
4. Выберите пользователя, которому вы хотите назначить роль.
5. Нажмите вкладку «Профиль» .
6. Нажмите кнопку «Редактировать» в правом верхнем углу.
7. Назначьте соответствующую(ие) роль(и) пользователя(ей).
   • Если пользователю в Okta назначено несколько ролей, airfocus будет использовать самую высокую из предоставленных ролей (самая высокая — Администратор, затем Редактор, а затем Участник).
   • "Undefined" и "false" по сути одно и то же. Неважно, какой вариант вы выберете, если вы не хотите, чтобы этот человек занимал эту должность. Если для всех ролей установлено значение «не определено», пользователь по умолчанию будет иметь роль «Участник».
8. Выберите «Сохранить».

Теперь в AirFocus должна отображаться роль пользователя.

Оставьте отзыв об этой статье