Підключення Microsoft Entra

Підключіть каталог Microsoft Entra, щоб синхронізувати учасників у Klang. Надайте доступ усім синхронізованим користувачам або лише певним групам.

Замість Microsoft Entra Klang може синхронізувати дані з Okta, Google Workspace чи іншого сервісу SCIM. Кожен робочий простір одночасно використовує лише одного постачальника. Одне підключення Microsoft можуть спільно використовувати кілька робочих просторів.

Перш ніж почати

Вам знадобляться:

• У Klang: права адміністратора в робочому просторі з планом Pro або Enterprise
• У Microsoft Entra: дозвіл створювати корпоративні застосунки й налаштовувати автоматичне створення облікових записів (provisioning)

Групи необов’язкові. Сплануйте їх, якщо різні люди мають отримати різний доступ або різні ролі.

Створення застосунку в Entra

1. У центрі адміністрування Microsoft Entra перейдіть до розділу Enterprise applications
2. Натисніть New application, а потім – Create your own application
3. Назвіть застосунок Klang
4. Виберіть Integrate any other application you don’t find in the gallery (Non-gallery)
5. Натисніть Create

Отримання облікових даних у Klang

1. У Klang відкрийте Налаштування → Робочий простір → Учасники → Синхронізація учасників
2. На картці Каталог SCIM натисніть Підключити
3. Виберіть вкладку Microsoft Entra ID
4. Натисніть Зберегти, щоб створити підключення й побачити URL-адресу та токен

Klang покаже Tenant URL і токен, а також кроки, які потрібно виконати в Entra.

Токен показується лише один раз. Скопіюйте його, перш ніж закрити вікно. Якщо ви його втратите, натисніть Створити новий токен, щоб отримати новий. Зверніть увагу: старий токен одразу перестане діяти.

Якщо відображається розділ Параметри підключення, для нового налаштування залиште вибраним варіант Створити нове підключення. Щоб використати наявне підключення, натомість виберіть робочий простір, який ви адмініструєте, і натисніть Зберегти. Новий токен і повторне налаштування в постачальника не знадобляться.

Щоб згодом переглянути налаштування, відкрийте Більше параметрів (⋮) на картці підключення й виберіть Показати налаштування. URL-адреса та інструкції для постачальника залишаються доступними, але збережений токен знову показати не можна. Кнопка Закрити закриває інструкцію, не змінюючи підключення.

Додавання облікових даних в Entra

1. У новому застосунку Klang відкрийте Provisioning
2. Натисніть Connect your application
3. У полі Select authentication method залиште Bearer authentication
4. Вставте значення з Klang у поля Tenant URL і Secret token
5. Натисніть Test connection
6. Натисніть Create

Якщо перевірка не пройшла, переконайтеся, що ви скопіювали токен повністю і що Tenant URL не закінчується скісною рискою.

Вибір користувачів і груп для синхронізації

Якщо для параметра Scope вибрано Sync only assigned users and groups, Entra надсилає людей, призначених застосунку. Можна призначати як окремих користувачів, так і групи.

1. У застосунку Klang відкрийте Users and groups
2. Натисніть Add user/group і виберіть користувачів або групи для синхронізації
3. Поверніться до розділу Provisioning і натисніть Start provisioning

Першу синхронізацію Microsoft запускає за власним розкладом, і це може тривати до 40 хвилин. Подальші зміни зазвичай теж надходять протягом 40 хвилин.

Вибір учасників для цього робочого простору

Варіант Усі синхронізовані користувачі надає права учасника кожному активному користувачеві, якого надсилають через це підключення. Адміністраторами керуйте в Klang. Яких користувачів надсилати, як і раніше, визначає постачальник.

1. У розділі Синхронізація учасників знайдіть Хто отримає доступ?
2. Виберіть Усі синхронізовані користувачі або Вибрати певні групи. Якщо вибираєте певні групи, укажіть, які з них надають роль Адміністратор, а які – Учасник
3. Натисніть Показати, хто входить до вибірки, щоб переглянути людей, яких охоплює ваш вибір
4. Перевірте, чи потрібні додаткові місця, і натисніть Зберегти

Групи можуть перетинатися: у кожному робочому просторі людину враховують лише один раз. Нове підключення нікому не надає доступу, доки ви не збережете вибір.

Використання підключення в іншому робочому просторі

1. Перейдіть в інший робочий простір, який ви адмініструєте
2. Відкрийте Налаштування → Робочий простір → Учасники → Синхронізація учасників
3. На картці Каталог SCIM натисніть Підключити
4. Виберіть робочий простір, чиє підключення Microsoft потрібно використати повторно
5. Натисніть Зберегти, щоб використати це підключення
6. Виберіть, хто отримає доступ, і збережіть вибір

Щоб пов’язати робочі простори, потрібно бути адміністратором обох. Підключення спільне, тож Microsoft достатньо налаштувати один раз. Та сама група може надавати різні ролі в різних робочих просторах. Синхронізація триває, навіть якщо людина, яка створила підключення, згодом втратить права адміністратора.

Що відбувається далі

• Активні користувачі, які входять у збережений вибір, отримують доступ до цього робочого простору
• Користувачі, яких деактивовано або які більше не входять у ваш вибір, утрачають доступ, наданий через синхронізацію. Їхній вміст зберігається
• Групи адміністраторів можуть підвищувати учасників до адміністраторів. Наявні адміністратори зберігають свою роль, коли переходять до групи учасників
• Люди, які ще ніколи не входили в Klang, отримують запрошення електронною поштою

Ви й далі керуєте людьми в Entra, а Klang автоматично підхоплює зміни.

Заміна токена

На картці підключення відкрийте Більше параметрів (⋮) і виберіть Створити новий токен. Це може зробити будь-який адміністратор пов’язаного робочого простору. У вікні підтвердження перелічено всі робочі простори, яких це стосується: старий токен перестане діяти для всіх них.

У наявному застосунку Klang в Entra відкрийте Provisioning → Connectivity. Вставте новий токен у поле Secret token. Натисніть Test connection, а потім Save, щоб відновити синхронізацію.

Відключення

Натисніть Більше параметрів (⋮) → Відключити, щоб припинити синхронізацію цього робочого простору. Наявні учасники зберігають доступ, і надалі ними керують уручну, а надіслані через синхронізацію запрошення, які ще не прийнято, скасовуються. Інші пов’язані робочі простори продовжують синхронізацію. Якщо відключити останній робочий простір, спільне підключення та його токен також буде видалено.