Scribble Maps Kömək Mərkəzi
Dili dəyişin

SCIM təminatı

SCIM istifadəçi təminatının konfiqurasiyası

ScribbleMaps avtomatlaşdırılmış istifadəçi təminatı və ləğvi üçün SCIM 2.0 (System for Cross-domain Identity Management) standartını dəstəkləyir. Bu, istifadəçiləri Identity Provider (IdP) sistemindən ScribbleMaps-ə avtomatik sinxronlaşdırmağa və komanda üzvlüyünün təşkilatınızın kataloqu ilə sinxron qalmasını təmin etməyə imkan verir.

SCIM təminatı team.scribblemaps.com ünvanında mövcuddur və tamamilə pulsuzdur.

Mündəricat

  1. SCIM nədir?
  2. Başlamazdan əvvəl
  3. Addım 1: ScribbleMaps-də SCIM-i aktivləşdirin
  4. Addım 2: Bearer tokeni yaradın
  5. Addım 3: Identity Provider sisteminizi konfiqurasiya edin
  6. Addım 4: Standart məhsul təyinatını seçin
  7. Addım 5: Sınaqdan keçirin və istifadəçiləri təyin edin
  8. Provayderlər üzrə bələdçilər
  9. Dəstəklənən SCIM əməliyyatları
  10. İstifadəçi həyat dövrünün idarə olunması
  11. Problemlərin aradan qaldırılması

SCIM nədir?

SCIM (System for Cross-domain Identity Management) aşağıdakıları avtomatik etməyə imkan verən açıq standartdır:

  • İstifadəçilərin təminatı - İstifadəçilər IdP-də təyin edildikdə ScribbleMaps hesabları avtomatik yaradılır
  • İstifadəçilərin yenilənməsi - İstifadəçi məlumatları (ad, e-poçt) sinxron saxlanılır
  • İstifadəçilərin ləğvi - İstifadəçilər IdP-dən çıxarıldıqda hesablar avtomatik deaktiv edilir
  • Rolların idarə olunması - İstifadəçilər qrup üzvlüyü vasitəsilə Administrator və ya Member rollarına təyin edilir

SCIM tam şəxsiyyət həyat dövrü idarəetməsi təmin etmək üçün SSO (SAML/OIDC) ilə birlikdə işləyir.

Başlamazdan əvvəl

  • SCIM-i konfiqurasiya etmək üçün Team Owner olmalısınız
  • Identity Provider sisteminizin administrator konsoluna çıxışınız olmalıdır
  • IdP sisteminiz SCIM 2.0-ı dəstəkləməlidir (Okta, Microsoft Entra ID, OneLogin, JumpCloud və s.)
  • Ən yaxşı istifadəçi təcrübəsi üçün SCIM-dən əvvəl SSO-nu konfiqurasiya etməyi tövsiyə edirik

Addım 1: ScribbleMaps-də SCIM-i aktivləşdirin

  1. team.scribblemaps.com ünvanına daxil olun
  2. SCIM Provisioning (sol yan panel) bölməsinə keçin
  3. Enable SCIM açarını AÇIQ vəziyyətə gətirin

Qeyd: SCIM-in tam aktivləşdirilməsi üçün əvvəlcə bearer tokeni yaratmalısınız.

Addım 2: Bearer tokeni yaradın

Bearer tokeni Identity Provider sisteminizi ScribbleMaps-də autentifikasiya edir.

  1. SCIM ayarları səhifəsində Generate Token düyməsinə klikləyin
  2. Tokeni dərhal kopyalayın və təhlükəsiz yerdə saxlayın

Vacib təhlükəsizlik qeydləri:

  • Token yalnız bir dəfə göstərilir - onu itirsəniz, yenisini yaratmalı olacaqsınız
  • Bu tokenə parol kimi yanaşın - tokenə sahib olan hər kəs komandanızın istifadəçilərini idarə edə bilər
  • Token təhlükəyə düşərsə, istənilən vaxt onu ləğv edib yenidən yarada bilərsiniz
  • Tokenin ləğvi yeni token konfiqurasiya edilənədək bütün SCIM əməliyyatlarını dərhal dayandırır

Addım 3: Identity Provider sisteminizi konfiqurasiya edin

ScribbleMaps-i IdP sisteminizdə SCIM tətbiqi kimi konfiqurasiya etmək üçün aşağıdakı məlumatlardan istifadə edin:

Ayarlar Dəyər
SCIM Base URL https://api.scribblemaps.com/scim/v2
Authentication Method HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
Unikal identifikator userName (e-poçt ünvanı)

SCIM endpoint-lərinə dair məlumat

Endpoint Təyinatı
/scim/v2/Users İstifadəçi təminatı və idarə olunması
/scim/v2/Groups Rol/qrup üzvlüyünün idarə olunması
/scim/v2/ServiceProviderConfig SCIM imkanları (kəşf)
/scim/v2/ResourceTypes Dəstəklənən resurs növləri (kəşf)
/scim/v2/Schemas İstifadəçi və qrup sxemləri (kəşf)

Addım 4: Standart məhsul təyinatını seçin (İstəyə bağlı)

İstifadəçilər SCIM vasitəsilə təmin edilərkən onlara məhsul lisenziyasını avtomatik təyin edə bilərsiniz:

  1. SCIM ayarları səhifəsində Default Product Assignment bölməsini tapın
  2. Məhsulu seçin:
    • Yoxdur - İstifadəçilər məhsulsuz yaradılır (sonra əl ilə təyin edin)
    • İzləyici - Yalnız baxış icazəsi
    • Pro Basic - Standart redaktə funksiyaları
    • Pro Business - Bütün funksiyalara tam çıxış
  3. Yadda saxla düyməsinə klikləyin

Qeyd: İstifadəçilərə məhsul yalnız boş yerlər (seat) olduqda təyin edilir. Boş yer yoxdursa, istifadəçi yaradılır, lakin təyinatsız qalır.

Addım 5: Sınaqdan keçirin və istifadəçiləri təyin edin

  1. Identity Provider sisteminizdə SCIM bağlantısını yoxlamaq üçün Test Connection funksiyasından istifadə edin
  2. IdP sisteminizdə ScribbleMaps tətbiqinə bir test istifadəçisi təyin edin
  3. İstifadəçinin ScribbleMaps komanda üzvləri siyahısında göründüyünü yoxlayın
  4. Təsdiq edildikdən sonra lazım olduqca əlavə istifadəçiləri və ya qrupları təyin edin

Provayderlər üzrə bələdçilər

Okta

  1. Okta Admin Console-da Applications > Browse App Catalog bölməsinə keçin
  2. "SCIM 2.0 Test App (Header Auth)" axtarın və ya fərdi SCIM tətbiqi yaradın
  3. Provisioning sekmesinə > Configure API Integration bölməsinə keçin
  4. Enable API integration seçimini işarələyin
  5. Konfiqurasiya edin:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: ScribbleMaps SCIM tokeninizi yapışdırın
  6. Yoxlamaq üçün Test API Credentials düyməsinə klikləyin
  7. Provisioning > To App bölməsinə keçin və aşağıdakıları aktivləşdirin:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. İstifadəçiləri və ya qrupları təyin etmək üçün Assignments sekmesinə keçin

Microsoft Entra ID (Azure AD)

  1. Azure Portal-da Microsoft Entra ID > Enterprise Applications bölməsinə keçin
  2. ScribbleMaps tətbiqinizi seçin (və ya yaradın)
  3. Provisioning > Başla bölməsinə keçin
  4. Provisioning Mode parametrini Automatic olaraq təyin edin
  5. Admin Credentials altında:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: ScribbleMaps SCIM tokeninizi yapışdırın
  6. Yoxlamaq üçün Test Connection düyməsinə klikləyin
  7. İstifadəçi atributları üçün Mappings bölməsini konfiqurasiya edin
  8. Provisioning Status parametrini On olaraq təyin edin
  9. İstifadəçiləri təyin etmək üçün Users and groups bölməsinə keçin

OneLogin

  1. OneLogin Admin-də Applications > Add App bölməsinə keçin
  2. "SCIM Provisioner with SAML (SCIM v2 Core)" və ya buna bənzər tətbiqi axtarın
  3. Configuration sekmesinə keçin
  4. Konfiqurasiya edin:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: ScribbleMaps SCIM tokeninizi yapışdırın
  5. Provisioning sekmesinə keçin və təminatı aktivləşdirin
  6. İstifadəçiləri təyin etmək üçün İstifadəçilər sekmesinə keçin

JumpCloud

  1. JumpCloud Admin-də SSO Applications bölməsinə keçin
  2. Yeni tətbiq əlavə etmək üçün + düyməsinə klikləyin
  3. Custom SCIM seçin
  4. Konfiqurasiya edin:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: ScribbleMaps SCIM tokeninizi yapışdırın
    • Authentication: Bearer Token
  5. Test Connection düyməsinə klikləyin
  6. Atribut uyğunlaşdırmalarını konfiqurasiya edin
  7. İstifadəçi qruplarını tətbiqə təyin edin

Dəstəklənən SCIM əməliyyatları

İstifadəçi əməliyyatları

Əməliyyat Üsul Dəstəklənir Təsvir
List Users GET /Users Bəli Bütün istifadəçiləri səhifələmə və filtrləmə ilə əldə edin
Get User GET /Users/{id} Bəli Konkret istifadəçini ID ilə əldə edin
Create User POST /Users Bəli Yeni istifadəçi təmin edin
Replace User PUT /Users/{id} Bəli İstifadəçi atributlarının tam yenilənməsi
Update User PATCH /Users/{id} Bəli İstifadəçi atributlarının qismən yenilənməsi
Delete User DELETE /Users/{id} Bəli İstifadəçini deaktiv edin (yumşaq silmə)

Qrup əməliyyatları

Əməliyyat Üsul Dəstəklənir Təsvir
List Groups GET /Groups Bəli Administrator və Member rol qruplarını qaytarır
Get Group GET /Groups/{id} Bəli Qrupu üzvlər siyahısı ilə əldə edin
Update Group PATCH /Groups/{id} Bəli Rol qruplarına üzv əlavə edin/çıxarın
Create Group POST /Groups Xeyr Dəstəklənmir (rollar sabitdir)

Dəstəklənən istifadəçi atributları

SCIM atributu ScribbleMaps sahəsi Tələb olunur
userName E-poçt ünvanı Bəli
externalId Xarici IdP identifikatoru Xeyr
name.givenName Ad Xeyr
name.familyName Soyad Xeyr
displayName Göstərilən ad Xeyr
active Hesab statusu Xeyr
emails[].value E-poçt ünvanı Xeyr

Dəstəklənən filtrlər

Filtr Nümunə
E-poçta görə filtr userName eq "[email protected]"
Xarici ID-yə görə filtr externalId eq "12345"
Statusa görə filtr active eq true

İstifadəçi həyat dövrünün idarə olunması

İstifadəçi təmin edildikdə

  1. ScribbleMaps-də yeni komanda üzvü hesabı yaradılır
  2. İstifadəçi məlumatları (ad, e-poçt) IdP sisteminizdən doldurulur
  3. Standart məhsul konfiqurasiya edilibsə və boş yerlər varsa, lisenziya avtomatik təyin edilir
  4. İstifadəçi SSO vasitəsilə dərhal daxil ola bilər (konfiqurasiya edilibsə)

İstifadəçi yeniləndikdə

  1. İstifadəçi atributları (ad, göstərilən ad) IdP sisteminizlə uyğunlaşdırmaq üçün yenilənir
  2. E-poçt dəyişiklikləri sinxronlaşdırılır (istifadəçi hesabını əlaqələndirməyibsə)

İstifadəçinin təminatı ləğv edildikdə

  1. İstifadəçinin hesabı deaktiv edilir (yumşaq silmə)
  2. Bütün məhsul lisenziyaları götürülür və yerlər (seat) azad olunur
  3. Bütün aktiv sessiyalar dərhal etibarsız edilir
  4. İstifadəçi artıq daxil ola bilməz
  5. İstifadəçi məlumatları və xəritələr saxlanılır (silinmir)
  6. İstifadəçi yenidən təmin edilərsə, hesab yenidən aktivləşdirilə bilər

Qruplar vasitəsilə rolların idarə olunması

ScribbleMaps SCIM vasitəsilə iki rol qrupu təqdim edir:

Qrup ID Rol İcazələr
admin Administrator Komanda ayarlarını, istifadəçiləri və hesablaşmanı idarə et
member Member Standart komanda üzvü çıxışı

İstifadəçini administrator təyin etmək üçün onu SCIM PATCH vasitəsilə admin qrupuna əlavə edin. Owner rolu SCIM vasitəsilə dəyişdirilə bilməz.

Problemlərin aradan qaldırılması

Ümumi problemlər

"401 Unauthorized" və ya "Invalid token"

  • Bearer tokenin düzgün olduğunu və ləğv edilmədiyini yoxlayın
  • Tokenin Authorization başlığında Bearer YOUR_TOKEN formatında ötürüldüyünə əmin olun
  • Tokenin müddətinin bitib-bitmədiyini yoxlayın (müddət təyin edilibsə)
  • Lazım gələrsə, yeni token yaradın

"409 Conflict" - İstifadəçi artıq mövcuddur

  • Həmin e-poçtla istifadəçi komandanızda artıq mövcuddur
  • Mövcud istifadəçi deaktiv edilibsə, SCIM onu avtomatik yenidən aktivləşdirəcək
  • IdP sisteminizdə təkrarlanan e-poçt ünvanlarını yoxlayın

"400 Bad Request" - Tələb olunan sahə çatışmır

  • Sorğuya userName (e-poçt) daxil edildiyinə əmin olun
  • E-poçt formatının düzgün olduğunu yoxlayın
  • IdP sisteminizin atribut uyğunlaşdırma konfiqurasiyasını yoxlayın

İstifadəçilər yaradılıb, lakin məhsul təyin edilməyib

  • SCIM ayarlarında standart məhsulun konfiqurasiya edilib-edilmədiyini yoxlayın
  • Standart məhsul üçün boş yerlərinizin olduğunu yoxlayın
  • İstifadəçilərə məhsullar Team Settings bölməsində əl ilə təyin edilə bilər

İstifadəçi dəyişiklikləri sinxronlaşmır

  • Bəzi IdP sistemləri cədvəl üzrə sinxronlaşdırır (məsələn, Azure AD üçün hər 40 dəqiqədən bir)
  • IdP sisteminizdə əl ilə sinxronlaşdırmağa cəhd edin
  • SCIM-in hələ də aktiv olduğunu və tokenin etibarlı olduğunu yoxlayın

Test bağlantısı uğursuz olur

  • SCIM Base URL-in dəqiq olaraq https://api.scribblemaps.com/scim/v2 olduğunu yoxlayın
  • Sonda əyri xətt və ya yazı səhvləri olmadığına əmin olun
  • Şəbəkənizin/firewall-un api.scribblemaps.com ünvanına çıxan HTTPS-ə icazə verdiyini yoxlayın
     

Köməyə ehtiyacınız var?

SCIM təminatı ilə bağlı problemlər yaşayırsınızsa, dəstək komandamızla aşağıdakı məlumatlarla əlaqə saxlayın:

  • Komandanızın adı
  • İstifadə etdiyiniz Identity Provider
  • IdP sisteminizin təminat jurnallarındakı hər hansı xəta mesajları
  • SCIM konfiqurasiyanızın ekran görüntüləri (token gizlədilmiş şəkildə)

Təşkilatınız üçün SCIM təminatını konfiqurasiya etməkdə sizə kömək etməyə hazırıq.

Son yenilənmə