Помощен център на 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
  • Актуализирате потребители - Поддържате информацията за потребителите (име, имейл) синхронизирана
  • Премахвате потребители - Автоматично деактивирате акаунти, когато потребителите бъдат премахнати от вашия 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 осигуряване (лява странична лента)
  3. Превключете Enable SCIM на ВКЛ.

Бележка: Ще трябва да генерирате Bearer токен, преди SCIM да може да бъде напълно активиран.

Стъпка 2: Генерирайте Bearer токен

Bearer токенът удостоверява вашия доставчик на самоличност пред ScribbleMaps.

  1. На страницата с настройки на SCIM щракнете Генерирай токен
  2. Копирайте токена незабавно и го съхранете на сигурно място

Важни бележки за сигурността:

  • Токенът се показва само веднъж - ако го загубите, ще трябва да генерирате нов
  • Третирайте този токен като парола - всеки, който го притежава, може да управлява потребителите на вашия екип
  • Можете да отмените и да генерирате отново токена по всяко време, ако е компрометиран
  • Отмяната на токен незабавно спира всички SCIM операции, докато не бъде конфигуриран нов токен

Стъпка 3: Конфигурирайте вашия доставчик на самоличност

Използвайте следните данни, за да конфигурирате ScribbleMaps като SCIM приложение във вашия IdP:

Настройка Стойност
SCIM основен URL адрес https://api.scribblemaps.com/scim/v2
Метод за удостоверяване HTTP заглавка / Bearer токен
Заглавка за упълномощаване 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 намерете Назначаване на продукт по подразбиране
  2. Изберете продукт:
    • Няма - Потребителите се създават без продукт (назначете ръчно по-късно)
    • Зрител - Достъп само за преглед
    • 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: Поставете вашия 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 Portal отидете на 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 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: Поставете вашия SCIM токен от ScribbleMaps
  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: Поставете вашия SCIM токен от ScribbleMaps
    • Authentication: Bearer Token
  5. Щракнете Test Connection
  6. Конфигурирайте съпоставянията на атрибути
  7. Назначете потребителски групи към приложението

Поддържани SCIM операции

Операции с потребители

Операция Метод Поддържа се Описание
Списък с потребители GET /Users Да Извличане на всички потребители с разбиване на страници и филтриране
Извличане на потребител GET /Users/{id} Да Извличане на конкретен потребител по ID
Създаване на потребител POST /Users Да Осигуряване на нов потребител
Замяна на потребител PUT /Users/{id} Да Пълна актуализация на атрибутите на потребителя
Актуализиране на потребител PATCH /Users/{id} Да Частична актуализация на атрибутите на потребителя
Изтриване на потребител DELETE /Users/{id} Да Деактивиране на потребител (меко изтриване)

Операции с групи

Операция Метод Поддържа се Описание
Списък с групи GET /Groups Да Връща ролевите групи Администратор и Член
Извличане на група GET /Groups/{id} Да Извличане на група със списък на членовете
Актуализиране на група PATCH /Groups/{id} Да Добавяне/премахване на членове от ролеви групи
Създаване на група 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 основният URL адрес е точно https://api.scribblemaps.com/scim/v2
  • Уверете се, че няма крайни наклонени черти или правописни грешки
  • Проверете дали вашата мрежа/защитна стена позволява изходящ HTTPS към api.scribblemaps.com
     

Нуждаете се от помощ?

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

  • Името на вашия екип
  • Доставчика на самоличност, който използвате
  • Всички съобщения за грешка от дневниците за осигуряване на вашия IdP
  • Екранни снимки на вашата SCIM конфигурация (със скрит токен)

Тук сме, за да ви помогнем да конфигурирате SCIM осигуряването за вашата организация.

Последна промяна