Інтеграція з Microsoft Entra ID

Інтеграція з Microsoft Entra ID синхронізує користувачів організації з каталогом Microsoft. Зміни в каталозі відображаються в застосунку: новий користувач Entra ID автоматично додається до списку користувачів FlexiProject і може входити за допомогою облікового запису Microsoft, а користувач, видалений із каталогу, позначається як видалений. За наявності пакета Microsoft 365 можна також отримувати цілоденні відсутності з календаря Outlook.

Адміністратор налаштовує інтеграцію в розділі Системні налаштування > Microsoft Entra ID (див. Системні налаштування). Наступні розділи описують реєстрацію застосунку в Entra ID, підключення та синхронізацію користувачів і календарів.

Примітка: якщо організація використовує індивідуальну інтеграцію з локальним Active Directory, користувачів синхронізують лише через неї. Додаткове підключення до Microsoft Entra ID тоді вмикає лише інтеграцію з Microsoft 365 і синхронізацію календарів.

Реєстрація застосунку в Microsoft Entra ID

Перший крок — зареєструвати FlexiProject як застосунок у Microsoft Entra ID. Реєстрація дає адміністратору параметри підключення: Ідентифікатор тенанта, Ідентифікатор клієнта і Ключ клієнта. Кроки виконуються в порталі Microsoft, тож назви пунктів залежать від його поточної версії.

  1. Увійдіть в обліковий запис Microsoft 365 на office.com і відкрийте інструмент Адміністратор.
  2. У меню ліворуч виберіть Переглянути все, а в меню розширені — Microsoft Entra ID.
  3. У меню Microsoft Entra ID виберіть Реєстрація застосунків.
  4. Натисніть + Нова реєстрація. Відкриється форма реєстрації застосунку.
  5. Введіть назву застосунку, наприклад «FlexiProject», і виберіть тип облікових записів Один тенант.
  6. Надайте застосунку дозволи на читання календарів, груп і відомостей про користувачів.
  7. Натисніть Зареєструвати.

Дані підключення

Після реєстрації портал відкриває розділ Огляд. З нього беруться два значення: Ідентифікатор каталогу (ідентифікатор тенанта) і Ідентифікатор застосунку (ідентифікатор клієнта). Третє значення, ключ клієнта, потрібно ще згенерувати:

  1. Перейдіть до модуля Сертифікати й секрети в меню ліворуч.
  2. Натисніть + Новий секрет клієнта.
  3. Виберіть термін дії (рекомендовано два роки) і введіть опис, який допоможе його розпізнати.
  4. Натисніть Додати. Згенерований секрет з’явиться в списку Секрети клієнта; кнопка Копіювати в буфер обміну копіює його значення.

Примітка: коли секрет спливає, підключення перестає працювати. Тоді застосунок показує повідомлення про недійсне підключення та про те, що ключ клієнта міг втратити чинність, і потрібно ввести новий ключ (див. Створення підключення).

Створення підключення

Для підключення потрібні три параметри з порталу Microsoft: ідентифікатор тенанта, ідентифікатор клієнта і ключ клієнта (див. Реєстрація застосунку в Microsoft Entra ID).

Connection to Microsoft Entra ID window with the Tenant ID, Client ID, Client Secret and user group IDs fields highlighted

System settings, Microsoft Entra ID tab with the Add connection button highlighted

  1. Відкрийте Системні налаштування (головне меню) і перейдіть на сторінку Microsoft Entra ID.
  2. Натисніть Додати з’єднання. Відкриється вікно Підключення до Microsoft Entra ID.
  3. Заповніть поля: Ідентифікатор тенанта (ідентифікатор каталогу в Microsoft), Ідентифікатор клієнта (ідентифікатор застосунку) і Ключ клієнта (значення секрету, скопійоване в порталі).
  4. За потреби обмежте імпортованих користувачів вибраними групами — у полі Імпортувати на основі ID груп користувачів (розділіть комами) введіть ідентифікатори об’єктів груп Entra ID через кому. Приймаються лише ідентифікатори, а не назви груп. Порожнє поле означає імпорт усіх користувачів.
  5. Натисніть Зберегти. За правильних даних вікно закриється, з’явиться повідомлення Підключення до Microsoft Entra ID успішно встановлено, а на сторінці з’явиться рядок підключення. За неправильних даних з’явиться повідомлення Не вдалося підключитися до Microsoft Entra ID, а вікно залишиться відкритим.

Список підключень

Таблиця показує Ідентифікатор тенанта, Ідентифікатор клієнта, Статус (Активні, Немає зв’язку або Помилка синхронізації) і Остання синхронізація — кількість синхронізованих користувачів і час, що минув після синхронізації. Меню рядка (три крапки) містить команди Редагувати, Синхронізувати (запускає синхронізацію одразу) і Видалити. У вікні редагування поле ключа клієнта залишається порожнім, доки ви не введете новий ключ; прострочений ключ замінюють саме так.

Видалення підключення перериває синхронізацію облікових записів користувачів та їхніх статусів із Microsoft Entra ID; застосунок просить підтвердження.

Синхронізація користувачів

Після створення підключення FlexiProject періодично синхронізує користувачів. Отримуються облікові записи з адресою електронної пошти. Також доступні кнопка Синхронізувати і перемикач запрошень.

  • Новий користувач в Entra ID отримує обліковий запис у FlexiProject і стає активним користувачем (обліковий запис, вимкнений в Entra ID, не створюється).
  • Наявного користувача FlexiProject пов’язують з обліковим записом Entra ID за адресою електронної пошти.
  • Користувач, якого вже немає в каталозі, позначається у FlexiProject як Видалений і втрачає доступ.
  • У списку користувачів синхронізований користувач має іконку синхронізації біля статусу. Користувач, доданий вручну й відсутній в Entra ID, такої іконки не має (див. Список користувачів).

Якщо ввімкнено організаційну структуру, синхронізація також може будувати відділи на основі керівників з Entra ID (див. Автоматичний імпорт структури з Microsoft Entra ID).

Запрошення для користувачів Entra ID

Перемикач Запрошення електронною поштою для користувачів із Microsoft Entra ID під таблицею підключень вмикає надсилання вітального листа із запрошенням до FlexiProject кожному новому користувачеві, автоматично доданому з Entra ID. Незалежно від налаштування, решту сповіщень електронною поштою користувач починає отримувати лише після першого входу або після першої дії, яка його стосується, наприклад призначення на завдання чи згадки в коментарі (див. Сповіщення електронною поштою).

Синхронізація календаря Outlook

Підключення до Microsoft Entra ID також дає змогу записувати цілоденні відсутності користувачів із календаря Outlook (Microsoft 365) до їхньої доступності. Відсутності потрапляють до календаря доступності користувача в модулі Ресурси.

  1. Відкрийте Системні налаштування (головне меню) і перейдіть на сторінку Ресурси.
  2. Увімкніть опцію Підключення календаря Outlook. Опція видима, коли підключення до Microsoft Entra ID активне.

Цілоденні події зі статусом Вільний, які синхронізовані користувачі внесли в Outlook, зберігаються в їхній доступності. У календарі в Ресурсах вони позначені іконкою синхронізації, а такі винятки не можна редагувати. Вони зникають автоматично, коли подію видалено в Outlook або коли опцію вимкнено (див. Налаштування модуля Ресурси).