Scribble Maps-ы æххуысы центр
Æвзаг баивын

SCIM Provisioning

SCIM-ы пайдагӕнджыты провизионинг сфӕтк кӕнын

ScribbleMaps дӕтты SCIM 2.0 (System for Cross-domain Identity Management) пайдагӕнджыты автоматон провизионинг ӕмӕ деп провизионинг кӕнынӕн. Уый ныфс дарын кӕны, цӕмӕй дӕ Identity Provider (IdP)-ӕй пайдагӕнджытӕ автоматон ScribbleMaps-мӕ синхронизаци кӕной ӕмӕ командӕйы уӕнгтӕ дӕ организацийы директорийимӕ синхронизацийы баззайой.

SCIM провизионинг ис team.scribblemaps.com-ы ӕмӕ уый ӕххӕстӕй пaхуыгӕнӕг у.

Мӕнӕй ис

  1. Цы у SCIM?
  2. Раздӕр ӕмӕ райдайай
  3. Къахдзӕф 1: ScribbleMaps-ы SCIM бацӕттӕ кӕн
  4. Къахдзӕф 2: Bearer Token Саразын
  5. Къахдзӕф 3: Дӕ Identity Provider Сфӕтк кӕнын
  6. Къахдзӕф 4: Райдайӕн продукты бабӕрӕг кӕнын
  7. Къахдзӕф 5: Тестирование ӕмӕ пайдагӕнджыты сӕвӕрын
  8. Провайдеры хуыйнаг Разамындтытӕ
  9. Хъӕугӕ SCIM Операцитӕ
  10. Пайдагӕнӕджы цардуагыл Разамынд
  11. Фӕлтау ӕмӕ рӕдыдтытӕ уӕйгӕнын

Цы у SCIM?

SCIM (System for Cross-domain Identity Management) у ивгъуыд ӕппӕт стандарт, уый дӕ автоматон ӕнцой кӕны:

  • Пайдагӕнджыты провизионинг - Автоматон саразын ScribbleMaps аккаунттӕ, куы пайдагӕнджытӕ дӕ IdP-ы сӕвӕрдзысты
  • Пайдагӕнджыты Ног кӕнын - Пайдагӕнӕджы информаци (ном, Электрон пост) синхронизацийы дарын
  • Пайдагӕнджыты деп провизионинг - Автоматон аккаунттӕ деактивировать кӕнын, куы пайдагӕнджытӕ дӕ IdP-ӕй схафын вӕййынц
  • Ролтӕ Разамынд - Пайдагӕнджыты Admin кӕнӕ Member ролтӕм сӕвӕрын къордты уӕнгдзинадӕй

SCIM кусы SSO (SAML/OIDC)-имӕ иумӕ, цӕмӕй ӕххӕст identity цардуаг разамынд раттой.

Раздӕр ӕмӕ райдайай

  • Ды хъуамӕ уай Team Owner, цӕмӕй SCIM сфӕтк кӕнай
  • Дӕм хъуамӕ уа дӕ Identity Provider-ы админ консолмӕ бацӕуын
  • Дӕ IdP хъуамӕ хъӕугӕ кӕна SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud ӕмӕ ӕндӕртӕ)
  • Мах дӕм хъусын кӕнӕм, цӕмӕй SSO SCIM-ӕй раздӕр сфӕтк кӕнай, зындгонд пайдагӕнӕджы ӕрвылбон ныфсӕй

Къахдзӕф 1: ScribbleMaps-ы SCIM бацӕттӕ кӕн

  1. Бацу team.scribblemaps.com
  2. Бацӕуын SCIM Provisioning (галиу фарс панель)
  3. Ивын Enable SCIM ON-мӕ

Фиппаинаг: Дӕ хъӕуы bearer token саразын, раздӕр ӕмӕ SCIM ӕххӕстӕй бацӕттӕ уа.

Къахдзӕф 2: Bearer Token Саразын

Bearer token дӕ Identity Provider ScribbleMaps-ы размӕ аутентификаци кӕны.

  1. SCIM ӕвӕрдтытӕ фарсыл, ныкъхъырцы кӕн Generate Token
  2. Токен ӕвидигъӕ рафыссын ӕмӕ йӕ ӕдасдзинадӕй бавӕрын

Ӕгъдау ӕдасдзинады фиппаинӕгтӕ:

  • Токен кӕстӕр иу хатт равдисы - куы йӕ фесафай, ног саразын хъӕуы
  • Ацы токен спайда кӕн паролы хуызы - кӕцыфӕнды, кӕмӕн ис токен, уый хъӕуы дӕ командӕйы пайдагӕнджытӕ разамынд кӕнын
  • Ды йӕ дӕ цӕугӕйы каст кӕнӕй ног саразын, кӕд ын хъӕуы
  • Токены ссыгъдӕг кӕнын кӕны ӕппӕт SCIM операцитӕ ӕвдисын, ног токен сфӕтк кӕнынмӕ

Къахдзӕф 3: Дӕ Identity Provider Сфӕтк кӕнын

Спайда кӕн ацы дӕтты ScribbleMaps SCIM ӕрвылбон уагӕй дӕ IdP-ы сфӕтк кӕнынӕн:

Ӕвӕрдтытӕ Аргъ
SCIM Бындурон URL https://api.scribblemaps.com/scim/v2
Аутентификацийы Метод HTTP Сӕйраг хай / Bearer Token
Authorization Сӕйраг хай Bearer YOUR_TOKEN_HERE
Сæрмагонд Идентификатор userName (электрон посты адрис)

SCIM Endpoints Справочник

Endpoint Нысан
/scim/v2/Users Пайдагӕнджыты провизионинг ӕмӕ Разамынд
/scim/v2/Groups Роль/къорды уӕнгтӕй Разамынд
/scim/v2/ServiceProviderConfig SCIM ныфсытӕ (discovery)
/scim/v2/ResourceTypes Хъӕугӕ ресурсты хуызтӕ (discovery)
/scim/v2/Schemas Пайдагӕнӕг ӕмӕ Къорд схемӕтӕ (discovery)

Къахдзӕф 4: Райдайӕн продукты бабӕрӕг кӕнын (Нӕ ӕнӕмӕнг)

Ды дӕ автоматон продукты лицензи пайдагӕнджытӕн бабӕрӕг кӕнын, куы SCIM-ӕй провизионинг кӕнынц:

  1. SCIM ӕвӕрдтытӕ фарсыл, ссарын Default Product Assignment
  2. Равзарын продукт:
    • None - Пайдагӕнджытӕ продуктӕй фӕстӕмӕ сарӕзт вӕййынц (сӕвӕрын фӕстӕдӕр аллон хуызы)
    • Viewer - Ӕрмӕст кӕсын бацӕуын
    • Pro Basic - Стандартон редактировать фӕрӕзтытӕ
    • Pro Business - Ӕххӕст фӕрӕзтытӕм бацӕуын
  3. Ныкъхъырцы кӕн Save

Фиппаинаг: Пайдагӕнджытӕн продукт сӕвӕрдзысты ӕрмӕст, куы бынӕттӕ ис. Куы бынӕттӕ нӕй, пайдагӕнӕг сарӕзт вӕййы, фӕлӕ ныууайы ницы бабӕрӕг кӕнын.

Къахдзӕф 5: Тестирование ӕмӕ пайдагӕнджыты сӕвӕрын

  1. Дӕ Identity Provider-ы, спайда кӕн 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 app
  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 application (кӕнӕ саразын иу)
  3. Бацу Provisioning > Get Started
  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. Ныкъхъырцы кӕн +, цӕмӕй ног application бафтауай
  3. Равзар Custom SCIM
  4. Сфӕтк кӕн:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Бавӕр дӕ ScribbleMaps SCIM токен
    • Authentication: Bearer Token
  5. Ныкъхъырцы кӕн Test Connection
  6. Сфӕтк кӕн атрибуттӕ mappings
  7. Сӕвӕр пайдагӕнджыты къордтӕ application-мӕ

Хъӕугӕ SCIM Операцитӕ

Пайдагӕнджыты Операцитӕ

Операци Метод Хъӕугӕ Ӕмбарынгӕнӕн
List Users GET /Users О Ӕппӕт пайдагӕнджытӕ рахӕцын pagination ӕмӕ фильтртимӕ
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 О Раздӕхы Admin ӕмӕ Member ролы къордтӕ
Get Group GET /Groups/{id} О Къорд рахӕцын уӕнгты рӕгъимӕ
Update Group PATCH /Groups/{id} О Ролы къордтӕй уӕнгтӕ бафтауын/схафын
Create Group POST /Groups Нӕ Нӕ хъӕуы (ролтӕ ӕнӕивгъуыд сты)

Хъӕугӕ Пайдагӕнӕджы Атрибуттӕ

SCIM Атрибут ScribbleMaps Field Ӕнӕмӕнг
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 кӕнынӕн, бафтау йӕ admin къордмӕ SCIM PATCH-ӕй. Owner роль SCIM-ӕй ивын нӕ ис.

Фӕлтау ӕмӕ рӕдыдтытӕ уӕйгӕнын

Ӕгъдау Проблемӕтӕ

"401 Unauthorized" кӕнӕ "Invalid token"

  • Ныхъхъус кӕн, bearer token раст у ӕмӕ ссыгъдӕг нӕу
  • Ныфс дар, токен Authorization сӕйраг хайы бацӕйцыд куыд Bearer YOUR_TOKEN
  • Каст кӕн, токен нӕ ацыд (кӕд ӕнӕхъӕнӕй бацӕттӕ у)
  • Куы хъӕуы, ног токен саразын

"409 Conflict" - Пайдагӕнӕг ис

  • Ахӕм электрон постимӕ пайдагӕнӕг ис дӕ командӕйы
  • Кӕд ис пайдагӕнӕг деактивировать кӕнын у, SCIM йӕ автоматон ног активировать кӕндзӕн
  • Каст кӕн, дӕ IdP-ы дыууӕ ахӕм электрон посты адрисы ис кӕнӕ нӕ

"400 Bad Request" - Ӕнӕмӕнг field нӕй

  • Ныфс дар, userName (Электрон пост) уӕнгтӕй бацӕуы
  • Каст кӕн, электрон посты формат раст у
  • Каст кӕн дӕ IdP-ы атрибут mapping конфигураци

Пайдагӕнджытӕ сарӕзт сты, фӕлӕ продукт нӕ бабӕрӕг кодтой

  • Каст кӕн, райдайӕн продукт SCIM ӕвӕрдтытӕй сфӕтк кӕнын у
  • Ныхъхъус кӕн, райдайӕн продуктӕн дӕм ис ӕнӕбон бынӕттӕ
  • Пайдагӕнджытӕн продуктӕ аллон хуызы сӕвӕрын ис Team Settings-ы

Пайдагӕнӕджы ивддзинӕдтӕ синхронизаци нӕ кӕнынц

  • Иуӕй-иу IdP-тӕ синхронизаци кӕнынц рӕстӕгӕй (куыд, 40 минуты фӕстӕ Azure AD-мӕ)
  • Аразын ӕнцон синхронизаци аллон хуызы дӕ IdP-ы
  • Ныхъхъус кӕн, SCIM ног дӕр активировать кӕнын у ӕмӕ токен раст у

Test connection нӕ ӕххӕст кӕны

  • Ныхъхъус кӕн, SCIM Base URL ӕххӕстӕй у https://api.scribblemaps.com/scim/v2
  • Ныфс дар, нӕй fyrxon слэштӕ кӕнӕ рӕдыдтытӕ
  • Каст кӕн, дӕ рӕдыд/файрвол бауадзы ӕддаг HTTPS api.scribblemaps.com-мӕ
     

Ӕххуыс хъӕуы?

Кӕд SCIM провизионингимӕ проблемӕтӕ ис, дӕ хъусын кӕн мах ӕххуысы командӕйы ацы информацийимӕ:

  • Дӕ Командӕйы ном
  • Identity Provider, кӕй пайдагӕнӕй
  • Кӕцыфӕнды рӕдыды фыстытӕ дӕ IdP-ы провизионинг логӕй
  • Дӕ SCIM конфигурацийы скриншоттӕ (токен ӕвидигъӕ)

Мах ам стӕм, цӕмӕй дӕ ӕххуыс кӕнӕм SCIM провизионинг дӕ организацийӕн сфӕтк кӕнынӕн.

Фæстаг ног кæнынад