Scribble Maps центар за помоћ
Промени језик

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 токен
  5. Корак 3: Конфигуришите свој провајдер идентитета
  6. Корак 4: Поставите подразумевано додељивање производа
  7. Корак 5: Тестирајте и доделите кориснике
  8. Водичи за поједине провајдере
  9. Подржане SCIM операције
  10. Управљање животним циклусом корисника
  11. Решавање проблема

Шта је SCIM?

SCIM (System for Cross-domain Identity Management) је отворени стандард који вам омогућава да аутоматски:

  • Провизионишете кориснике - Аутоматски креирајте ScribbleMaps налоге када се корисници доделе у вашем IdP-у
  • Ажурирате кориснике - Одржавајте информације о корисницима (име, е-пошта) синхронизованим
  • Деактивирате кориснике - Аутоматски деактивирајте налоге када се корисници уклone из вашег 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 токен пре него што SCIM може бити у потпуности омогућен.

Корак 2: Генеришите Bearer токен

Bearer токен потврђује идентитет вашег провајдера идентитета код ScribbleMaps-а.

  1. На страници SCIM подешавања кликните Генериши токен
  2. Одмах копирајте токен и чувајте га на сигурном месту

Важне безбедносне напомене:

  • Токен се приказује само једном - ако га изгубите, мораћете да генеришете нови
  • Третирајте овај токен као лозинку - свако ко поседује токен може да управља корисницима вашег тима
  • Токен можете опозвати и поново генерисати у било ком тренутку ако је компромитован
  • Опозивање токена одмах заустављa све SCIM операције док се не конфигурише нови токен

Корак 3: Конфигуришите свој провајдер идентитета

Користите следеће податке да бисте конфигурисали ScribbleMaps као SCIM апликацију у вашем IdP-у:

Подешавања Вредност
SCIM Base URL https://api.scribblemaps.com/scim/v2
Метод аутентификације HTTP заглавље / Bearer токен
Заглавље Authorization 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. Изаберите производ:
    • Ништа - Корисници се креирају без производа (додељује се касније ручно)
    • Viewer - Приступ само за приказ
    • Pro Basic - Стандардне функције уређивања
    • Pro Business - Приступ свим функцијама
  3. Кликните Сачувај

Белешка: Корисницима ће бити додељен производ само ако су места доступна. Ако нема доступних места, корисник се креира, али остаје недодељен.

Корак 5: Тестирајте и доделите кориснике

  1. У свом провајдеру идентитета користите функцију Test Connection да бисте проверили SCIM повезивање
  2. Доделите тест корисника апликацији ScribbleMaps у вашем IdP-у
  3. Проверите да ли се корисник појављује у листи чланова вашег ScribbleMaps тима
  4. Када се потврди, доделите додатне кориснике или групе по потреби

Водичи за поједине провајдере

Okta

  1. У Okta Admin Console идите на 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: Налепите свој ScribbleMaps SCIM токен
  6. Кликните Test API Credentials да бисте проверили
  7. Идите на Provisioning > To App и омогућите:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Идите на картицу Assignments да доделите кориснике или групе

Microsoft Entra ID (Azure AD)

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

OneLogin

  1. У OneLogin Admin-у идите на 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: Налепите свој ScribbleMaps SCIM токен
  5. Идите на картицу Provisioning и омогућите провизионисање
  6. Идите на картицу Users да доделите кориснике

JumpCloud

  1. У JumpCloud Admin-у идите на SSO Applications
  2. Кликните + да додате нову апликацију
  3. Изаберите Custom SCIM
  4. Конфигуришите:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Налепите свој ScribbleMaps SCIM токен
    • 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"

  • Проверите да ли је bearer токен исправан и да није опозван
  • Уверите се да је токен прослеђен у заглављу Authorization као Bearer YOUR_TOKEN
  • Проверите да ли је токен истекао (ако је постављен рок важења)
  • Генеришите нови токен ако је потребно

"409 Conflict" - Корисник већ постоји

  • Корисник са том е-поштом већ постоји у вашем тиму
  • Ако је постојећи корисник био деактивиран, SCIM ће га аутоматски поново активирати
  • Проверите да ли у вашем IdP-у постоје дуплиране адресе е-поште

"400 Bad Request" - Недостаје обавезно поље

  • Уверите се да је userName (е-пошта) укључен у захтев
  • Проверите да ли је формат е-поште исправан
  • Проверите конфигурацију мапирања атрибута у вашем IdP-у

Корисници су креирани, али производ није додељен

  • Проверите да ли је у SCIM подешавањима конфигурисан подразумевани производ
  • Проверите да ли имате доступна места за подразумевани производ
  • Корисницима се производи могу ручно доделити у Подешавањима тима

Промене корисника се не синхронизују

  • Неки IdP-ови синхронизују по распореду (нпр. на сваких 40 минута за Azure AD)
  • Покушајте да форсирате ручну синхронизацију у свом IdP-у
  • Проверите да ли је SCIM и даље омогућен и да ли је токен важећи

Тест повезивања не успева

  • Проверите да ли је SCIM Base URL тачно https://api.scribblemaps.com/scim/v2
  • Уверите се да нема косих црта на крају или словних грешака
  • Проверите да ли ваша мрежа/заштитни зид дозвољава одлазни HTTPS ка api.scribblemaps.com
     

Потребна вам је помоћ?

Ако имате проблема са SCIM провизионисањем, обратите се нашем тиму за подршку и наведите:

  • Назив вашег тима
  • Провајдер идентитета који користите
  • Све поруке о грешкама из логова провизионисања вашег IdP-а
  • Снимке екрана ваше SCIM конфигурације (са сакривеним токеном)

Овде смо да вам помогнемо да конфигуришете SCIM провизионисање за вашу организацију.

Последње ажурирање