Провізіонінг SCIM

Завдяки SCIM 2.0 твій identity provider, наприклад Microsoft Entra ID або Okta, керує користувачами exoCortex замість тебе: коли ти наймаєш людину, користувача створюється, коли вона змінює посаду — оновлюється, коли залишає компанію — деактивується.

Як під’єднати identity provider

1. В exoCortex Core відкрий Identity → SCIM і згенеруй токен SCIM. Скопіюй його одразу: він показується лише один раз.
2. У своєму identity provider додай застосунок із провізіонінгом SCIM 2.0 і вкажи:
   • Базова URL-адреса: https://exocortex-api.ai-exo-cortex.com/scim/v2
   • Автентифікація: bearer-токен — токен, згенерований на кроці 1.
3. Запусти перевірку з’єднання з identity provider, потім признач застосунку користувачів і групи, які треба синхронізувати.

Токен належить одному тенанту: identity provider бачить і керує лише користувачами цього тенанта.

Що підтримує exoCortex

Функція	Підтримка
Користувачі: створення, читання, заміна, оновлення (PATCH), видалення	так
Групи: створення, читання, оновлення (PATCH), видалення	так
Фільтри	так, наприклад userName eq "[email protected]", також з and; до 200 результатів
Сортування	так
Пакетні операції (bulk)	ні
Зміна пароля	ні: пароль вибирає користувач
ETag	ні

Атрибути користувача

exoCortex використовує стандартні атрибути схеми користувача SCIM:

• userName: ідентифікатор користувача, зазвичай корпоративна email-адреса;
• externalId: ідентифікатор користувача у твоєму identity provider;
• name.givenName і name.familyName, displayName;
• emails, де основну адресу позначено як primary;
• active: якщо false, користувача деактивовано;
• title і userType, якщо є.

Як деактивувати й видалити користувача

Коли користувач залишає компанію, identity provider деактивує його запитом PATCH, що встановлює active у false:

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [{ "op": "replace", "path": "active", "value": false }]
}

Запит DELETE до користувача вилучає його з провізіонінгу (deprovisioning).

Помилки

Ендпоінти SCIM відповідають документами помилок SCIM (RFC 7644). 401 означає, що токена немає або він недійсний, відкликаний чи прострочений: згенеруй новий токен і онови його в identity provider.