Руководство по настройке Clarizen One для автоматической подготовки пользователей

В этом руководстве описаны действия, которые необходимо выполнить как в Clarizen One, так и в идентификаторе Microsoft Entra для настройки автоматической подготовки пользователей. При настройке идентификатор Microsoft Entra id автоматически подготавливает и отменяет подготовку пользователей и групп в Clarizen One с помощью службы подготовки Microsoft Entra. Сведения о том, что делает эта служба, как она работает и часто задаваемые вопросы, см. в статье "Автоматизация подготовки пользователей и отмена подготовки к программному обеспечению как услуга" (SaaS) с помощью идентификатора Microsoft Entra.

Поддерживаемые возможности

• Создание пользователей в Clarizen One.
• Удаление из Clarizen One пользователей, которым уже не нужен доступ.
• Синхронизация атрибутов пользователей между идентификатором Microsoft Entra и Clarizen One.
• Подготовка групп и членства в группах в Clarizen One.
• Мы также рекомендуем настроить единый вход для Clarizen One.

Необходимые компоненты

В сценарии, описанном в этом руководстве, предполагается, что у вас уже имеется:

• Клиент Microsoft Entra.
• Одна из следующих ролей: администратор приложений, администратор облачных приложений или владелец приложения.
• Учетная запись пользователя Clarizen One с разрешениями Integration User (Пользователь интеграции) и Lite Admin (Администратор Lite).

Шаг 1. Планирование развертывания подготовки

1. Узнайте, как работает служба подготовки.
2. Определите, кто будет находиться в области подготовки.
3. Определите, какие данные необходимо сопоставить между идентификатором Microsoft Entra и Clarizen One.

Шаг 2. Настройка Clarizen One для поддержки подготовки с помощью идентификатора Microsoft Entra

1. Выберите один из следующих URL-адресов клиента в зависимости от используемых среды и центра обработки данных Clarizen One.

   • Рабочий центр обработки данных в США: https://servicesapp2.clarizen.com/scim/v2
   • Рабочий центр обработки данных в Европе: https://serviceseu1.clarizen.com/scim/v2
   • Тестовый центр обработки данных в США: https://servicesapp.clarizentb.com/scim/v2
   • Тестовый центр обработки данных в Европе: https://serviceseu.clarizentb.com/scim/v2

2. Сгенерируйте ключ API. Это значение будет введено в поле "Секретный токен" на вкладке "Подготовка" приложения Clarizen One.

Шаг 3. Добавление Clarizen One из коллекции приложений Microsoft Entra

Добавьте Clarizen One из коллекции приложений Microsoft Entra, чтобы начать управление подготовкой в Clarizen One. Если вы уже настроили единый вход в Clarizen One, можете использовать то же приложение. При начальном тестировании интеграции создайте отдельное приложение. Дополнительные сведения о добавлении приложения из коллекции см. в статье "Добавление приложения в клиент Microsoft Entra".

Шаг 4. Определение того, кто будет находиться в области подготовки

С помощью службы подготовки Microsoft Entra можно определить, кто будет подготовлен на основе назначения приложению или на основе атрибутов пользователя или группы. Если вы решили выбрать область, которая будет подготовлена для приложения на основе назначения, выполните действия, описанные в разделе "Управление назначением пользователей для приложения в идентификаторе Microsoft Entra" для назначения пользователей и групп приложению. Если вы решили указать, кто именно будет подготовлен, на основе одних только атрибутов пользователя или группы, можете использовать фильтр области, как описано в статье Подготовка приложений на основе атрибутов с использованием фильтров области.

• При назначении пользователей и групп для Clarizen One необходимо выбрать роль, отличную от роли Доступ по умолчанию. Пользователи с такой ролью исключаются из подготовки и будут помечены в журналах подготовки как не имеющие разрешений. Если в приложении доступна только эта роль, можно изменить манифест приложения, чтобы добавить другие роли.
• Начните с малого. Протестируйте небольшой набор пользователей и групп, прежде чем выполнять развертывание для всех. Если в область подготовки включены назначенные пользователи и группы, для сохранения контроля назначьте приложению одного или двух пользователей либо одну или две группы. Если в область включены все пользователи и группы, можно указать фильтр области на основе атрибутов.

Шаг 5. Настройка автоматической подготовки пользователей в Clarizen One

В этом разделе описаны инструкции по настройке службы подготовки Microsoft Entra для создания, обновления и отключения пользователей или групп в TestApp на основе назначений пользователей или групп в идентификаторе Microsoft Entra.

Настройка автоматической подготовки пользователей для Clarizen One в идентификаторе Microsoft Entra

1. Войдите в Центр администрирования Microsoft Entra как минимум администратор облачных приложений.

2. Перейдите к приложениям Identity>Applications>Enterprise.

   

3. В списке приложений выберите Clarizen One.

   

4. Выберите вкладку Подготовка.

   

5. Для параметра Режим подготовки к работе выберите значение Автоматически.

   

6. В разделе Учетные данные администратора укажите Tenant URL (URL-адрес клиента) и Secret Token (Токен секрета) из Clarizen One. Выберите "Проверить подключение", чтобы убедиться, что идентификатор Microsoft Entra может подключиться к Clarizen One. Если установить подключение не удалось, убедитесь, что у учетной записи Clarizen One есть разрешения администратора, и повторите попытку.

   

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

   

8. Выберите Сохранить.

9. В разделе "Сопоставления" выберите "Синхронизировать пользователей Microsoft Entra" с Clarizen One.

10. Просмотрите атрибуты пользователя, синхронизированные с идентификатором Microsoft Entra с Clarizen One в разделе "Сопоставление атрибутов". Атрибуты, выбранные как свойства Сопоставление, используются для сопоставления учетных записей пользователей в Clarizen One при операциях обновления. Если вы измените соответствующий целевой атрибут, обязательно убедитесь, что API Clarizen One поддерживает фильтрацию пользователей по этому атрибуту. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Атрибут	Тип
    userName	Строка
    displayName	Строка
    active	Логический
    title	Строка
    emails[type eq "work"].value	Строка
    emails[type eq "home"].value	Строка
    emails[type eq "other"].value	Строка
    preferredLanguage	Строка
    name.givenName	Строка
    name.familyName	Строка
    name.formatted	Строка
    name.honorificPrefix	Строка
    name.honorificSuffix	Строка
    addresses[type eq "other"].formatted	Строка
    addresses[type eq "work"].formatted	Строка
    addresses[type eq "work"].country	Строка
    addresses[type eq "work"].region	Строка
    addresses[type eq "work"].locality	Строка
    addresses[type eq "work"].postalCode	Строка
    addresses[type eq "work"].streetAddress	Строка
    phoneNumbers[type eq "work"].value	Строка
    phoneNumbers[type eq "mobile"].value	Строка
    phoneNumbers[type eq "fax"].value	Строка
    phoneNumbers[type eq "home"].value	Строка
    phoneNumbers[type eq "other"].value	Строка
    phoneNumbers[type eq "pager"].value	Строка
    externalId	Строка
    nickName	Строка
    локаль	Строка
    roles[primary eq "True".type]	Строка
    roles[primary eq "True".value]	Строка
    timezone	Строка
    userType	Строка
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	Строка
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber	Строка
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager	Справочные материалы
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter	Строка
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division	Строка
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division	Строка

11. В разделе "Сопоставления" выберите "Синхронизировать группы Microsoft Entra" с Clarizen One.

12. Просмотрите атрибуты группы, синхронизированные с идентификатором Microsoft Entra с Clarizen One, в разделе "Сопоставление атрибутов". Атрибуты, выбранные как свойства Сопоставление, используются для сопоставления групп в Clarizen One при операциях обновления. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Атрибут	Тип
    displayName	Строка
    externalId	Строка
    members	Справочные материалы

13. Чтобы настроить фильтры области, ознакомьтесь с инструкциями в этом учебнике.

14. Чтобы включить службу подготовки Microsoft Entra для Clarizen One, измените состояние подготовки на On в разделе "Параметры ".

    

15. Определите пользователей или группы для подготовки в Clarizen One, выбрав нужные значения в поле Область в разделе Параметры.

    

16. Когда будете готовы выполнить подготовку, нажмите кнопку Сохранить.

    

После этого начнется цикл начальной синхронизации всех пользователей и групп, определенных в поле Область в разделе Параметры. Начальный цикл занимает больше времени, чем последующие циклы, которые происходят примерно каждые 40 минут до запуска службы подготовки Microsoft Entra.

Шаг 6. Мониторинг развертывания

Завершив настройку подготовки, используйте следующие ресурсы для мониторинга развертывания.

1. Используйте журналы подготовки, чтобы определить, какие пользователи были подготовлены успешно или неудачно.
2. Используйте индикатор выполнения, чтобы узнать состояние цикла подготовки и близость его завершения.
3. Если конфигурация подготовки, вероятно, находится в неработоспособном состоянии, приложение перейдет в карантин. Дополнительные сведения о состояниях карантина см. в статье Состояние подготовки приложений в карантине.

Советы по устранению неполадок

Назначая пользователя для приложения Clarizen One из коллекции, выберите только роль Пользователь. Следующие роли являются недопустимыми:

• администратор;
• пользователь отчетов по электронной почте;
• Внешний пользователь
• финансовый пользователь;
• пользователь социальных сетей;
• суперпользователь;
• пользователь по времени и расходам.

Дополнительные ресурсы

• Управление подготовкой учетных записей пользователей для корпоративных приложений
• Что такое доступ к приложению и единый вход с помощью идентификатора Microsoft Entra?

Следующие шаги

• Сведения о просмотре журналов и получении отчетов о действиях по подготовке