SCIM პროვიზიონინგი

SCIM მომხმარებლების პროვიზიონინგის კონფიგურაცია

ScribbleMaps მხარს უჭერს SCIM 2.0-ს (System for Cross-domain Identity Management) მომხმარებლების ავტომატური პროვიზიონინგისა და დეპროვიზიონინგისთვის. ეს საშუალებას გაძლევთ, ავტომატურად დაასინქრონოთ მომხმარებლები თქვენი იდენტიფიკაციის პროვაიდერიდან (IdP) ScribbleMaps-ში და დარწმუნდეთ, რომ გუნდის წევრობა სინქრონიზებულია თქვენი ორგანიზაციის დირექტორიასთან.

SCIM პროვიზიონინგი ხელმისაწვდომია მისამართზე team.scribblemaps.com და სრულიად უფასოა.

სარჩევი

რა არის SCIM?
დაწყებამდე
ნაბიჯი 1: SCIM-ის ჩართვა ScribbleMaps-ში
ნაბიჯი 2: Bearer ტოკენის გენერირება
ნაბიჯი 3: თქვენი იდენტიფიკაციის პროვაიდერის კონფიგურაცია
ნაბიჯი 4: პროდუქტის ნაგულისხმევი მინიჭების დაყენება
ნაბიჯი 5: ტესტირება და მომხმარებლების მინიჭება
პროვაიდერების სპეციფიკური სახელმძღვანელოები
მხარდაჭერილი SCIM ოპერაციები
მომხმარებლის სასიცოცხლო ციკლის მართვა
პრობლემების აღმოფხვრა

რა არის 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 და სხვ.)
საუკეთესო მომხმარებლის გამოცდილებისთვის გირჩევთ, SCIM-მდე გააკეთოთ SSO-ს კონფიგურაცია

ნაბიჯი 1: SCIM-ის ჩართვა ScribbleMaps-ში

შედით team.scribblemaps.com-ზე
გადადით განყოფილებაში SCIM პროვიზიონინგი (მარცხენა გვერდითა პანელი)
გადამრთველი SCIM-ის ჩართვა დააყენეთ ჩართულ მდგომარეობაში

შენიშვნა: SCIM-ის სრულად ჩასართავად ჯერ უნდა მოახდინოთ bearer ტოკენის გენერირება.

ნაბიჯი 2: Bearer ტოკენის გენერირება

Bearer ტოკენი ახდენს თქვენი იდენტიფიკაციის პროვაიდერის ავთენტიფიკაციას ScribbleMaps-თან.

SCIM-ის პარამეტრების გვერდზე დააწკაპუნეთ ღილაკზე გენერირება (ტოკენის გენერირება)
დაუყოვნებლივ დააკოპირეთ ტოკენი და შეინახეთ უსაფრთხო ადგილას

მნიშვნელოვანი შენიშვნები უსაფრთხოების შესახებ:

ტოკენი ნაჩვენებია მხოლოდ ერთხელ - თუ დაკარგავთ, ახალი უნდა დააგენერიროთ
ტოკენს მოეპყარით როგორც პაროლს - ტოკენის მქონე ნებისმიერ პირს შეუძლია თქვენი გუნდის მომხმარებლების მართვა
თუ ტოკენი კომპრომეტირებულია, ნებისმიერ დროს შეგიძლიათ მისი გაუქმება და ხელახლა გენერირება
ტოკენის გაუქმება დაუყოვნებლივ აჩერებს 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-ის მეშვეობით პროვიზიონირდებიან:

SCIM-ის პარამეტრების გვერდზე იპოვეთ პროდუქტის ნაგულისხმევი მინიჭება
აირჩიეთ პროდუქტი:
- არცერთი - მომხმარებლები იქმნებიან პროდუქტის გარეშე (მოგვიანებით მიანიჭეთ ხელით)
- დამთვალიერებელი - მხოლოდ ნახვის წვდომა
- Pro Basic - რედაქტირების სტანდარტული ფუნქციები
- Pro Business - ფუნქციებზე სრული წვდომა
დააწკაპუნეთ ღილაკზე შენახვა

შენიშვნა: პროდუქტი მომხმარებელს მიენიჭება მხოლოდ იმ შემთხვევაში, თუ ადგილები ხელმისაწვდომია. თუ ადგილები არ არის ხელმისაწვდომი, მომხმარებელი შეიქმნება, მაგრამ მინიჭების გარეშე დარჩება.

ნაბიჯი 5: ტესტირება და მომხმარებლების მინიჭება

თქვენს იდენტიფიკაციის პროვაიდერში გამოიყენეთ კავშირის ტესტირების ფუნქცია SCIM-ის კავშირის შესამოწმებლად
თქვენს IdP-ში მიანიჭეთ სატესტო მომხმარებელი ScribbleMaps-ის აპლიკაციას
დარწმუნდით, რომ მომხმარებელი ჩანს თქვენი ScribbleMaps გუნდის წევრების სიაში
დადასტურების შემდეგ, საჭიროებისამებრ მიანიჭეთ დამატებითი მომხმარებლები ან ჯგუფები

პროვაიდერების სპეციფიკური სახელმძღვანელოები

Okta

Okta-ს ადმინისტრატორის კონსოლში გადადით Applications > Browse App Catalog
მოძებნეთ "SCIM 2.0 Test App (Header Auth)" ან შექმენით მორგებული SCIM აპლიკაცია
გადადით Provisioning ჩანართზე > კონფიგურაცია API Integration
მონიშნეთ Enable API integration
დააკონფიგურირეთ:
- SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
- OAuth Bearer Token: ჩასვით თქვენი ScribbleMaps SCIM ტოკენი
დააწკაპუნეთ Test API Credentials-ზე შესამოწმებლად
გადადით Provisioning > To App-ზე და ჩართეთ:
- Create Users
- Update User Attributes
- Deactivate Users
გადადით Assignments ჩანართზე მომხმარებლების ან ჯგუფების მისანიჭებლად

Microsoft Entra ID (Azure AD)

Azure Portal-ში გადადით Microsoft Entra ID > Enterprise Applications
აირჩიეთ თქვენი ScribbleMaps აპლიკაცია (ან შექმენით ახალი)
გადადით Provisioning > დაწყება
დააყენეთ Provisioning Mode მნიშვნელობაზე Automatic
განყოფილებაში Admin Credentials:
- Tenant URL: https://api.scribblemaps.com/scim/v2
- Secret Token: ჩასვით თქვენი ScribbleMaps SCIM ტოკენი
დააწკაპუნეთ Test Connection-ზე შესამოწმებლად
დააკონფიგურირეთ მომხმარებლის ატრიბუტების Mappings
დააყენეთ Provisioning Status მნიშვნელობაზე On
გადადით Users and groups-ზე მომხმარებლების მისანიჭებლად

OneLogin

OneLogin Admin-ში გადადით Applications > Add App
მოძებნეთ "SCIM Provisioner with SAML (SCIM v2 Core)" ან მსგავსი
გადადით Configuration ჩანართზე
დააკონფიგურირეთ:
- SCIM Base URL: https://api.scribblemaps.com/scim/v2
- SCIM Bearer Token: ჩასვით თქვენი ScribbleMaps SCIM ტოკენი
გადადით Provisioning ჩანართზე და ჩართეთ პროვიზიონინგი
გადადით Users ჩანართზე მომხმარებლების მისანიჭებლად

JumpCloud

JumpCloud Admin-ში გადადით SSO Applications-ზე
დააწკაპუნეთ +-ზე ახალი აპლიკაციის დასამატებლად
აირჩიეთ Custom SCIM
დააკონფიგურირეთ:
- Base URL: https://api.scribblemaps.com/scim/v2
- Token Key: ჩასვით თქვენი ScribbleMaps SCIM ტოკენი
- Authentication: Bearer Token
დააწკაპუნეთ Test Connection-ზე
დააკონფიგურირეთ ატრიბუტების მეპინგი
მიანიჭეთ მომხმარებლების ჯგუფები აპლიკაციას

მხარდაჭერილი 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`

მომხმარებლის სასიცოცხლო ციკლის მართვა

როდესაც მომხმარებელი პროვიზიონირდება

ScribbleMaps-ში იქმნება გუნდის ახალი წევრის ანგარიში
მომხმარებლის ინფორმაცია (სახელი, ელფოსტა) ივსება თქვენი IdP-დან
თუ ნაგულისხმევი პროდუქტი დაკონფიგურირებულია და ადგილები ხელმისაწვდომია, ლიცენზია ავტომატურად ენიჭება
მომხმარებელს დაუყოვნებლივ შეუძლია SSO-ით შესვლა (თუ დაკონფიგურირებულია)

როდესაც მომხმარებელი ახლდება

მომხმარებლის ატრიბუტები (სახელი, ჩვენებითი სახელი) ახლდება თქვენს IdP-თან შესაბამისობაში
ელფოსტის ცვლილებები სინქრონიზდება (გარდა იმ შემთხვევისა, როდესაც მომხმარებელმა დააკავშირა თავისი ანგარიში)

როდესაც მომხმარებელი დეპროვიზიონირდება

მომხმარებლის ანგარიში დეაქტივირდება (რბილი წაშლა)
პროდუქტის ყველა ლიცენზია ამოიღება და ადგილები თავისუფლდება
ყველა აქტიური სესია დაუყოვნებლივ ბათილდება
მომხმარებელს აღარ შეუძლია შესვლა
მომხმარებლის მონაცემები და რუკები შენარჩუნებულია (არ იშლება)
ანგარიშის ხელახლა გააქტიურება შესაძლებელია, თუ მომხმარებელი ხელახლა პროვიზიონირდება

როლების მართვა ჯგუფების მეშვეობით

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 სინქრონიზდება გრაფიკით (მაგ., Azure AD-ში ყოველ 40 წუთში)
სცადეთ თქვენს IdP-ში ხელით სინქრონიზაციის იძულებით გაშვება
დარწმუნდით, რომ SCIM ჯერ კიდევ ჩართულია და ტოკენი ვალიდურია

კავშირის ტესტირება ვერ ხერხდება

დარწმუნდით, რომ SCIM საბაზისო URL ზუსტად არის https://api.scribblemaps.com/scim/v2
დარწმუნდით, რომ არ არის ბოლოში დახრილი ხაზი ან შეცდომა
შეამოწმეთ, რომ თქვენი ქსელი/ფაირვოლი უშვებს გამავალ HTTPS-ს api.scribblemaps.com-ზე

გჭირდებათ დახმარება?

თუ SCIM პროვიზიონინგთან დაკავშირებით პრობლემები გაქვთ, გთხოვთ, დაუკავშირდეთ ჩვენს მხარდაჭერის გუნდს და მიუთითოთ:

თქვენი გუნდის სახელი
იდენტიფიკაციის პროვაიდერი, რომელსაც იყენებთ
ნებისმიერი შეცდომის შეტყობინება თქვენი IdP-ის პროვიზიონინგის ჟურნალებიდან
თქვენი SCIM კონფიგურაციის სკრინშოტები (ტოკენის დაფარვით)

ჩვენ აქ ვართ, რომ დაგეხმაროთ თქვენი ორგანიზაციისთვის SCIM პროვიზიონინგის კონფიგურაციაში.

ბოლო განახლება 4 ოქტომბერი 2026