Scribble Maps Help Center
Change language

Надання доступу через SCIM

Налаштування надання доступу користувачам через SCIM

ScribbleMaps підтримує SCIM 2.0 (System for Cross-domain Identity Management) для автоматизованого надання та скасування доступу користувачів. Це дозволяє автоматично синхронізувати користувачів із вашого постачальника ідентифікації (IdP) із ScribbleMaps, забезпечуючи синхронізацію складу команди з каталогом вашої організації.

Надання доступу через SCIM доступне на team.scribblemaps.com і є повністю безкоштовним.

Зміст

  1. Що таке SCIM?
  2. Перш ніж почати
  3. Крок 1: Увімкнути SCIM у ScribbleMaps
  4. Крок 2: Створити токен носія (Bearer Token)
  5. Крок 3: Налаштувати вашого постачальника ідентифікації
  6. Крок 4: Задати призначення продукту за замовчуванням
  7. Крок 5: Протестувати та призначити користувачів
  8. Посібники для окремих постачальників
  9. Підтримувані операції SCIM
  10. Управління життєвим циклом користувача
  11. Усунення несправностей

Що таке SCIM?

SCIM (System for Cross-domain Identity Management) — це відкритий стандарт, який дозволяє автоматично:

  • Надавати доступ користувачам - Автоматично створювати облікові записи ScribbleMaps, коли користувачів призначено у вашому IdP
  • Оновлювати користувачів - Синхронізувати інформацію про користувача (ім’я, електронну пошту)
  • Скасовувати доступ користувачам - Автоматично деактивувати облікові записи, коли користувачів видалено з вашого IdP
  • Керувати ролями - Призначати користувачам роль Адміністратор або Учасник через членство в групі

SCIM працює разом із SSO (SAML/OIDC), забезпечуючи повне управління життєвим циклом ідентифікації.

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

  • Ви маєте бути власником команди, щоб налаштувати SCIM
  • Вам потрібен доступ до консолі адміністратора вашого постачальника ідентифікації
  • Ваш IdP має підтримувати SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud тощо)
  • Ми рекомендуємо налаштувати SSO перед SCIM для найкращого досвіду користувача

Крок 1: Увімкнути SCIM у ScribbleMaps

  1. Увійдіть на team.scribblemaps.com
  2. Перейдіть до SCIM Provisioning (бокова панель зліва)
  3. Перемкніть Enable SCIM у положення ON

Примітка: вам потрібно буде створити токен носія (bearer token), перш ніж SCIM можна буде повністю увімкнути.

Крок 2: Створити токен носія (Bearer Token)

Токен носія автентифікує вашого постачальника ідентифікації у ScribbleMaps.

  1. На сторінці налаштувань SCIM натисніть Generate Token
  2. Негайно скопіюйте токен і збережіть його в безпечному місці

Важливі зауваження щодо безпеки:

  • Токен відображається лише один раз - якщо ви його втратите, доведеться створити новий
  • Ставтеся до цього токена як до пароля - будь-хто, хто має токен, може керувати користувачами вашої команди
  • Ви можете в будь-який момент відкликати та створити новий токен, якщо його скомпрометовано
  • Відкликання токена негайно зупиняє всі операції SCIM, доки не буде налаштовано новий токен

Крок 3: Налаштувати вашого постачальника ідентифікації

Використайте наведені нижче дані, щоб налаштувати ScribbleMaps як SCIM-застосунок у вашому IdP:

Налаштування Значення
SCIM Base URL https://api.scribblemaps.com/scim/v2
Метод автентифікації HTTP Header / Bearer Token
Заголовок авторизації Bearer YOUR_TOKEN_HERE
Унікальний ідентифікатор userName (адреса електронної пошти)

Довідник точок доступу SCIM

Точка доступу Призначення
/scim/v2/Users Надання доступу та керування користувачами
/scim/v2/Groups Керування роллю/членством у групі
/scim/v2/ServiceProviderConfig Можливості SCIM (виявлення)
/scim/v2/ResourceTypes Підтримувані типи ресурсів (виявлення)
/scim/v2/Schemas Схеми користувача та групи (виявлення)

Крок 4: Задати призначення продукту за замовчуванням (необов’язково)

Ви можете автоматично призначати ліцензію на продукт користувачам, коли їм надається доступ через SCIM:

  1. На сторінці налаштувань SCIM знайдіть Default Product Assignment
  2. Виберіть продукт:
    • Немає - Користувачів створено без продукту (призначити вручну пізніше)
    • Глядач - Доступ лише для перегляду
    • Pro Basic - Стандартні функції редагування
    • Pro Business - Повний доступ до функцій
  3. Натисніть Зберегти

Примітка: продукт буде призначено користувачам лише за наявності доступних місць. Якщо вільних місць немає, користувача буде створено, але не призначено.

Крок 5: Протестувати та призначити користувачів

  1. У вашого постачальника ідентифікації скористайтеся функцією Test Connection, щоб перевірити з’єднання SCIM
  2. Призначте тестового користувача до застосунку ScribbleMaps у вашому IdP
  3. Переконайтеся, що користувач з’явився у списку учасників вашої команди ScribbleMaps
  4. Після підтвердження призначте додаткових користувачів або групи за потреби

Посібники для окремих постачальників

Okta

  1. У консолі адміністратора Okta перейдіть до Applications > Browse App Catalog
  2. Знайдіть "SCIM 2.0 Test App (Header Auth)" або створіть власний SCIM-застосунок
  3. Перейдіть на вкладку Provisioning > Configure API Integration
  4. Позначте Enable API integration
  5. Налаштуйте:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Вставте ваш SCIM-токен ScribbleMaps
  6. Натисніть Test API Credentials, щоб перевірити
  7. Перейдіть до Provisioning > To App і увімкніть:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Перейдіть на вкладку Assignments, щоб призначити користувачів або групи

Microsoft Entra ID (Azure AD)

  1. У порталі Azure перейдіть до Microsoft Entra ID > Enterprise Applications
  2. Виберіть ваш застосунок ScribbleMaps (або створіть новий)
  3. Перейдіть до Provisioning > Get Started
  4. Задайте Provisioning Mode у значення Automatic
  5. У розділі Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Вставте ваш SCIM-токен ScribbleMaps
  6. Натисніть Test Connection, щоб перевірити
  7. Налаштуйте Mappings для атрибутів користувача
  8. Задайте Provisioning Status у значення On
  9. Перейдіть до Users and groups, щоб призначити користувачів

OneLogin

  1. В адмінці OneLogin перейдіть до Applications > Add App
  2. Знайдіть "SCIM Provisioner with SAML (SCIM v2 Core)" або подібний
  3. Перейдіть на вкладку Configuration
  4. Налаштуйте:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Вставте ваш SCIM-токен ScribbleMaps
  5. Перейдіть на вкладку Provisioning і увімкніть надання доступу
  6. Перейдіть на вкладку Users, щоб призначити користувачів

JumpCloud

  1. В адмінці JumpCloud перейдіть до SSO Applications
  2. Натисніть +, щоб додати новий застосунок
  3. Виберіть Custom SCIM
  4. Налаштуйте:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Вставте ваш SCIM-токен ScribbleMaps
    • Authentication: Bearer Token
  5. Натисніть Test Connection
  6. Налаштуйте відповідність атрибутів
  7. Призначте групи користувачів до застосунку

Підтримувані операції SCIM

Операції з користувачами

Операція Метод Підтримується Опис
List Users GET /Users Так Отримати всіх користувачів із пагінацією та фільтруванням
Get User GET /Users/{id} Так Отримати конкретного користувача за ID
Create User POST /Users Так Надати доступ новому користувачу
Replace User PUT /Users/{id} Так Повне оновлення атрибутів користувача
Update User PATCH /Users/{id} Так Часткове оновлення атрибутів користувача
Delete User DELETE /Users/{id} Так Деактивувати користувача (м’яке видалення)

Операції з групами

Операція Метод Підтримується Опис
List Groups GET /Groups Так Повертає групи ролей Адміністратор та Учасник
Get Group GET /Groups/{id} Так Отримати групу зі списком учасників
Update Group PATCH /Groups/{id} Так Додавати/видаляти учасників із груп ролей
Create Group POST /Groups Ні Не підтримується (ролі фіксовані)

Підтримувані атрибути користувача

Атрибут SCIM Поле ScribbleMaps Обов’язково
userName Адреса електронної пошти Так
externalId Зовнішній ідентифікатор IdP Ні
name.givenName Ім’я Ні
name.familyName Прізвище Ні
displayName Відображуване ім’я Ні
active Стан облікового запису Ні
emails[].value Адреса електронної пошти Ні

Підтримувані фільтри

Фільтр Приклад
Фільтр за електронною поштою userName eq "[email protected]"
Фільтр за зовнішнім ID externalId eq "12345"
Фільтр за станом active eq true

Управління життєвим циклом користувача

Коли користувачу надається доступ

  1. У ScribbleMaps створюється новий обліковий запис учасника команди
  2. Інформація про користувача (ім’я, електронна пошта) заповнюється з вашого IdP
  3. Якщо налаштовано продукт за замовчуванням і доступні місця, ліцензія призначається автоматично
  4. Користувач може одразу увійти через SSO (якщо налаштовано)

Коли дані користувача оновлюються

  1. Атрибути користувача (ім’я, відображуване ім’я) оновлюються відповідно до вашого IdP
  2. Зміни електронної пошти синхронізуються (якщо користувач не прив’язав свій обліковий запис)

Коли користувачу скасовується доступ

  1. Обліковий запис користувача деактивується (м’яке видалення)
  2. Усі ліцензії на продукти знімаються, звільняючи місця
  3. Усі активні сеанси негайно анулюються
  4. Користувач більше не може увійти
  5. Дані користувача та карти зберігаються (не видаляються)
  6. Обліковий запис можна повторно активувати, якщо користувачу знову надано доступ

Керування ролями через групи

ScribbleMaps надає дві групи ролей через SCIM:

ID групи Роль Дозволи
admin Адміністратор Керувати налаштуваннями команди, користувачами та оплатою
member Учасник Стандартний доступ учасника команди

Щоб призначити користувачу роль адміністратора, додайте його до групи admin через SCIM PATCH. Роль власника не можна змінити через SCIM.

Усунення несправностей

Поширені проблеми

"401 Unauthorized" або "Invalid token"

  • Переконайтеся, що токен носія правильний і не був відкликаний
  • Переконайтеся, що токен передається в заголовку Authorization як Bearer YOUR_TOKEN
  • Перевірте, чи не закінчився термін дії токена (якщо термін було встановлено)
  • За потреби створіть новий токен

"409 Conflict" - Користувач уже існує

  • Користувач із такою електронною поштою вже існує у вашій команді
  • Якщо наявного користувача було деактивовано, SCIM автоматично повторно активує його
  • Перевірте наявність дублікатів адрес електронної пошти у вашому IdP

"400 Bad Request" - Відсутнє обов’язкове поле

  • Переконайтеся, що userName (електронна пошта) включено до запиту
  • Перевірте, що формат електронної пошти дійсний
  • Перевірте конфігурацію зіставлення атрибутів у вашому IdP

Користувачів створено, але продукт не призначено

  • Перевірте, чи налаштовано продукт за замовчуванням у налаштуваннях SCIM
  • Переконайтеся, що у вас є доступні місця для продукту за замовчуванням
  • Користувачам можна призначити продукти вручну в Team Settings

Зміни користувача не синхронізуються

  • Деякі IdP синхронізуються за розкладом (наприклад, кожні 40 хвилин для Azure AD)
  • Спробуйте примусово запустити синхронізацію вручну у вашому IdP
  • Переконайтеся, що SCIM все ще увімкнено, а токен дійсний

Тестове з’єднання не вдається

  • Переконайтеся, що SCIM Base URL точно відповідає https://api.scribblemaps.com/scim/v2
  • Переконайтеся, що немає зайвих скісних рисок наприкінці або помилок
  • Перевірте, що ваша мережа/брандмауер дозволяє вихідний HTTPS-трафік до api.scribblemaps.com
     

Потрібна допомога?

Якщо у вас виникають проблеми з наданням доступу через SCIM, зверніться до нашої команди підтримки з такою інформацією:

  • Назва вашої команди
  • Постачальник ідентифікації, яким ви користуєтеся
  • Будь-які повідомлення про помилки з журналів надання доступу вашого IdP
  • Знімки екрана вашої конфігурації SCIM (із прихованим токеном)

Ми готові допомогти вам налаштувати надання доступу через SCIM для вашої організації.

Last updated