SCIM प्रोभिजनिङ

SCIM प्रयोगकर्ता प्रोभिजनिङ कन्फिगर गर्दै

ScribbleMaps ले स्वचालित प्रयोगकर्ता प्रोभिजनिङ र डिप्रोभिजनिङका लागि SCIM 2.0 (System for Cross-domain Identity Management) लाई समर्थन गर्दछ। यसले तपाईंलाई आफ्नो Identity Provider (IdP) बाट प्रयोगकर्ताहरूलाई ScribbleMaps मा स्वचालित रूपमा सिङ्क गर्न अनुमति दिन्छ, जसले टोली सदस्यता तपाईंको संस्थाको डाइरेक्टरीसँग सिङ्कमा रहेको सुनिश्चित गर्दछ।

SCIM प्रोभिजनिङ team.scribblemaps.com मा उपलब्ध छ र पूर्ण रूपमा निःशुल्क छ।

विषयसूची

SCIM भनेको के हो?
सुरु गर्नु अघि
चरण 1: ScribbleMaps मा SCIM सक्षम गर्नुहोस्
चरण 2: Bearer Token तयार पार्नुहोस् (Generate)
चरण 3: आफ्नो Identity Provider कन्फिगर गर्नुहोस्
चरण 4: पूर्वनिर्धारित उत्पादन असाइनमेन्ट सेट गर्नुहोस्
चरण 5: परीक्षण गर्नुहोस् र प्रयोगकर्ताहरू असाइन गर्नुहोस्
प्रोभाइडर-विशेष गाइडहरू
समर्थित SCIM सञ्चालनहरू
प्रयोगकर्ता जीवनचक्र व्यवस्थापन
समस्या समाधान

SCIM भनेको के हो?

SCIM (System for Cross-domain Identity Management) एउटा खुला मानक हो जसले तपाईंलाई स्वचालित रूपमा निम्न कार्यहरू गर्न अनुमति दिन्छ:

प्रयोगकर्ताहरू प्रोभिजन गर्नुहोस् - तपाईंको IdP मा प्रयोगकर्ताहरू असाइन गरिँदा स्वचालित रूपमा ScribbleMaps खाताहरू सिर्जना गर्नुहोस्
प्रयोगकर्ताहरू अद्यावधिक गर्नुहोस् - प्रयोगकर्ता जानकारी (नाम, इमेल) सिङ्क्रोनाइज राख्नुहोस्
प्रयोगकर्ताहरू डिप्रोभिजन गर्नुहोस् - प्रयोगकर्ताहरूलाई तपाईंको IdP बाट हटाइँदा स्वचालित रूपमा खाताहरू निष्क्रिय गर्नुहोस्
भूमिकाहरू व्यवस्थापन गर्नुहोस् - समूह सदस्यता मार्फत प्रयोगकर्ताहरूलाई Admin वा Member भूमिकामा असाइन गर्नुहोस्

SCIM ले SSO (SAML/OIDC) सँगै काम गरेर पूर्ण पहिचान जीवनचक्र व्यवस्थापन प्रदान गर्दछ।

सुरु गर्नु अघि

SCIM कन्फिगर गर्न तपाईं Team Owner हुनुपर्छ
तपाईंलाई आफ्नो Identity Provider को एडमिन कन्सोलमा पहुँच चाहिन्छ
तपाईंको IdP ले SCIM 2.0 लाई समर्थन गर्नुपर्छ (Okta, Microsoft Entra ID, OneLogin, JumpCloud, आदि)
उत्तम प्रयोगकर्ता अनुभवका लागि SCIM भन्दा पहिले SSO कन्फिगर गर्न हामी सिफारिस गर्दछौं

चरण 1: ScribbleMaps मा SCIM सक्षम गर्नुहोस्

team.scribblemaps.com मा लग इन गर्नुहोस्
SCIM Provisioning (बायाँ साइड बार) मा जानुहोस्
Enable SCIM लाई ON मा टगल गर्नुहोस्

नोट: SCIM पूर्ण रूपमा सक्षम हुनुअघि तपाईंले bearer token तयार पार्नुपर्छ (Generate)।

चरण 2: Bearer Token तयार पार्नुहोस् (Generate)

Bearer token ले तपाईंको Identity Provider लाई ScribbleMaps सँग प्रमाणित गर्दछ।

SCIM सेटिङहरू पृष्ठमा, तयार पार्नुहोस् (Generate) Token मा क्लिक गर्नुहोस्
Token तुरुन्तै प्रतिलिपि गर्नुहोस् र सुरक्षित रूपमा भण्डारण गर्नुहोस्

महत्त्वपूर्ण सुरक्षा नोटहरू:

Token एक पटक मात्र देखाइन्छ - यदि तपाईंले यसलाई गुमाउनुभयो भने, तपाईंले नयाँ तयार पार्नुपर्नेछ
यो token लाई पासवर्ड जस्तै व्यवहार गर्नुहोस् - token भएको जोसुकैले तपाईंको टोलीका प्रयोगकर्ताहरू व्यवस्थापन गर्न सक्छ
यदि token सम्झौतामा परेको छ भने तपाईं जुनसुकै बेला यसलाई रद्द गर्न र पुनः तयार पार्न सक्नुहुन्छ
Token रद्द गर्दा नयाँ token कन्फिगर नगरेसम्म सबै SCIM सञ्चालनहरू तुरुन्तै रोकिन्छन्

चरण 3: आफ्नो Identity Provider कन्फिगर गर्नुहोस्

आफ्नो IdP मा ScribbleMaps लाई SCIM एप्लिकेसनको रूपमा कन्फिगर गर्न निम्न विवरणहरू प्रयोग गर्नुहोस्:

सेटिङहरू	मान
SCIM Base 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 क्षमताहरू (डिस्कभरी)
`/scim/v2/ResourceTypes`	समर्थित रिसोर्स प्रकारहरू (डिस्कभरी)
`/scim/v2/Schemas`	प्रयोगकर्ता र समूह स्किमाहरू (डिस्कभरी)

चरण 4: पूर्वनिर्धारित उत्पादन असाइनमेन्ट सेट गर्नुहोस् (वैकल्पिक)

प्रयोगकर्ताहरू SCIM मार्फत प्रोभिजन हुँदा तपाईं स्वचालित रूपमा उत्पादन लाइसेन्स असाइन गर्न सक्नुहुन्छ:

SCIM सेटिङहरू पृष्ठमा, पूर्वनिर्धारित उत्पादन असाइनमेन्ट फेला पार्नुहोस्
एउटा उत्पादन चयन गर्नुहोस्:
- कुनै पनि होइन - प्रयोगकर्ताहरू उत्पादन बिना सिर्जना गरिन्छन् (पछि म्यानुअल रूपमा असाइन गर्नुहोस्)
- भ्युअर - हेर्न मात्र पहुँच
- Pro Basic - मानक सम्पादन सुविधाहरू
- Pro Business - पूर्ण सुविधा पहुँच
बचत गर्नुहोस् मा क्लिक गर्नुहोस्

नोट: सिटहरू उपलब्ध भएमा मात्र प्रयोगकर्ताहरूलाई उत्पादन असाइन गरिनेछ। यदि कुनै सिट उपलब्ध छैन भने, प्रयोगकर्ता सिर्जना गरिन्छ तर असाइन नगरिएको छोडिन्छ।

चरण 5: परीक्षण गर्नुहोस् र प्रयोगकर्ताहरू असाइन गर्नुहोस्

आफ्नो Identity Provider मा, SCIM कनेक्टिभिटी प्रमाणित गर्न Test Connection सुविधा प्रयोग गर्नुहोस्
आफ्नो IdP मा ScribbleMaps एप्लिकेसनमा एक परीक्षण प्रयोगकर्ता असाइन गर्नुहोस्
प्रयोगकर्ता तपाईंको ScribbleMaps टोली सदस्य सूचीमा देखिन्छ भनी प्रमाणित गर्नुहोस्
पुष्टि भएपछि, आवश्यकता अनुसार थप प्रयोगकर्ता वा समूहहरू असाइन गर्नुहोस्

प्रोभाइडर-विशेष गाइडहरू

Okta

Okta Admin Console मा, Applications > Browse App Catalog मा जानुहोस्
"SCIM 2.0 Test App (Header Auth)" खोज्नुहोस् वा कस्टम SCIM एप सिर्जना गर्नुहोस्
Provisioning ट्याब > Configure API Integration मा जानुहोस्
Enable API integration जाँच गर्नुहोस्
कन्फिगर गर्नुहोस्:
- SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
- OAuth Bearer Token: आफ्नो ScribbleMaps SCIM token पेस्ट गर्नुहोस्
प्रमाणित गर्न 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 मोड लाई Automatic मा सेट गर्नुहोस्
Admin Credentials अन्तर्गत:
- Tenant URL: https://api.scribblemaps.com/scim/v2
- Secret Token: आफ्नो ScribbleMaps SCIM token पेस्ट गर्नुहोस्
प्रमाणित गर्न Test Connection मा क्लिक गर्नुहोस्
प्रयोगकर्ता एट्रिब्युटहरूका लागि Mappings कन्फिगर गर्नुहोस्
Provisioning स्थिति लाई 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 token पेस्ट गर्नुहोस्
Provisioning ट्याबमा जानुहोस् र प्रोभिजनिङ सक्षम गर्नुहोस्
प्रयोगकर्ताहरू असाइन गर्न Users ट्याबमा जानुहोस्

JumpCloud

JumpCloud Admin मा, SSO Applications मा जानुहोस्
नयाँ एप्लिकेसन थप्न + मा क्लिक गर्नुहोस्
Custom SCIM चयन गर्नुहोस्
कन्फिगर गर्नुहोस्:
- Base URL: https://api.scribblemaps.com/scim/v2
- Token Key: आफ्नो ScribbleMaps SCIM token पेस्ट गर्नुहोस्
- Authentication: Bearer Token
Test Connection मा क्लिक गर्नुहोस्
एट्रिब्युट म्यापिङहरू कन्फिगर गर्नुहोस्
एप्लिकेसनमा प्रयोगकर्ता समूहहरू असाइन गर्नुहोस्

समर्थित 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}	हो	प्रयोगकर्ता निष्क्रिय गर्नुहोस् (soft delete)

समूह सञ्चालनहरू

सञ्चालन	विधि	समर्थित	विवरण
List Groups	GET /Groups	हो	Admin र Member भूमिका समूहहरू फर्काउँछ
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`

प्रयोगकर्ता जीवनचक्र व्यवस्थापन

जब प्रयोगकर्ता प्रोभिजन गरिन्छ

ScribbleMaps मा नयाँ टोली सदस्य खाता सिर्जना गरिन्छ
प्रयोगकर्ता जानकारी (नाम, इमेल) तपाईंको IdP बाट भरिन्छ
यदि पूर्वनिर्धारित उत्पादन कन्फिगर गरिएको छ र सिटहरू उपलब्ध छन् भने, लाइसेन्स स्वचालित रूपमा असाइन गरिन्छ
प्रयोगकर्ताले तुरुन्तै SSO मार्फत लग इन गर्न सक्छ (यदि कन्फिगर गरिएको छ भने)

जब प्रयोगकर्ता अद्यावधिक गरिन्छ

प्रयोगकर्ता एट्रिब्युटहरू (नाम, प्रदर्शन नाम) तपाईंको IdP सँग मेल खाने गरी अद्यावधिक गरिन्छन्
इमेल परिवर्तनहरू सिङ्क्रोनाइज गरिन्छन् (प्रयोगकर्ताले आफ्नो खाता लिङ्क गरेको छैन भने)

जब प्रयोगकर्ता डिप्रोभिजन गरिन्छ

प्रयोगकर्ताको खाता निष्क्रिय गरिन्छ (soft delete)
सबै उत्पादन लाइसेन्सहरू हटाइन्छन्, जसले सिटहरू खाली गर्दछ
सबै सक्रिय सत्रहरू तुरुन्तै अमान्य गरिन्छन्
प्रयोगकर्ताले अब लग इन गर्न सक्दैन
प्रयोगकर्ता डाटा र नक्सा संरक्षित गरिन्छन् (मेटाइँदैनन्)
प्रयोगकर्ता पुनः प्रोभिजन गरिएमा खाता पुनः सक्रिय गर्न सकिन्छ

समूहहरू मार्फत भूमिका व्यवस्थापन

ScribbleMaps ले SCIM मार्फत दुईवटा भूमिका समूहहरू प्रदान गर्दछ:

समूह ID	भूमिका	अनुमतिहरू
`admin`	प्रशासक	टोली सेटिङहरू, प्रयोगकर्ताहरू, र बिलिङ व्यवस्थापन गर्नुहोस्
`member`	सदस्य	मानक टोली सदस्य पहुँच

प्रयोगकर्तालाई एडमिनको रूपमा असाइन गर्न, SCIM PATCH मार्फत उनीहरूलाई admin समूहमा थप्नुहोस्। Owner भूमिका SCIM मार्फत परिमार्जन गर्न सकिँदैन।

समस्या समाधान

सामान्य समस्याहरू

"401 Unauthorized" वा "Invalid token"

Bearer token सही छ र रद्द गरिएको छैन भनी प्रमाणित गर्नुहोस्
Token Authorization हेडरमा Bearer YOUR_TOKEN को रूपमा पठाइएको छ भनी सुनिश्चित गर्नुहोस्
Token को म्याद सकिएको छ कि जाँच गर्नुहोस् (यदि म्याद सेट गरिएको थियो भने)
आवश्यक परेमा नयाँ token तयार पार्नुहोस् (Generate)

"409 Conflict" - प्रयोगकर्ता पहिले नै अवस्थित छ

त्यो इमेल भएको प्रयोगकर्ता तपाईंको टोलीमा पहिले नै अवस्थित छ
यदि अवस्थित प्रयोगकर्ता निष्क्रिय गरिएको थियो भने, SCIM ले उनीहरूलाई स्वचालित रूपमा पुनः सक्रिय गर्नेछ
आफ्नो IdP मा दोहोरिएका इमेल ठेगानाहरू जाँच गर्नुहोस्

"400 Bad Request" - आवश्यक फिल्ड छुटेको छ

अनुरोधमा userName (इमेल) समावेश छ भनी सुनिश्चित गर्नुहोस्
इमेल ढाँचा मान्य छ भनी प्रमाणित गर्नुहोस्
आफ्नो IdP को एट्रिब्युट म्यापिङ कन्फिगरेसन जाँच गर्नुहोस्

प्रयोगकर्ताहरू सिर्जना भए तर कुनै उत्पादन असाइन भएन

SCIM सेटिङहरूमा पूर्वनिर्धारित उत्पादन कन्फिगर गरिएको छ कि जाँच गर्नुहोस्
पूर्वनिर्धारित उत्पादनका लागि तपाईंसँग उपलब्ध सिटहरू छन् भनी प्रमाणित गर्नुहोस्
प्रयोगकर्ताहरूलाई टोली सेटिङहरूमा म्यानुअल रूपमा उत्पादनहरू असाइन गर्न सकिन्छ

प्रयोगकर्ता परिवर्तनहरू सिङ्क भइरहेका छैनन्

केही IdP हरू तालिका अनुसार सिङ्क गर्छन् (जस्तै, Azure AD का लागि प्रत्येक 40 मिनेट)
आफ्नो IdP मा म्यानुअल सिङ्क बलपूर्वक गर्ने प्रयास गर्नुहोस्
SCIM अझै सक्षम छ र token मान्य छ भनी प्रमाणित गर्नुहोस्

Test connection असफल हुन्छ

SCIM Base URL ठ्याक्कै https://api.scribblemaps.com/scim/v2 छ भनी प्रमाणित गर्नुहोस्
कुनै ट्रेलिङ स्ल्यास वा टाइपो छैन भनी सुनिश्चित गर्नुहोस्
तपाईंको नेटवर्क/फायरवालले api.scribblemaps.com मा आउटबाउन्ड HTTPS अनुमति दिन्छ भनी जाँच गर्नुहोस्

मद्दत चाहिन्छ?

यदि तपाईंले SCIM प्रोभिजनिङसँग समस्याहरू भोगिरहनुभएको छ भने, कृपया निम्नसहित हाम्रो सहायता टोलीलाई सम्पर्क गर्नुहोस्:

तपाईंको टोलीको नाम
तपाईंले प्रयोग गरिरहनुभएको Identity Provider
तपाईंको IdP को प्रोभिजनिङ लगहरूबाट कुनै पनि त्रुटि सन्देशहरू
तपाईंको SCIM कन्फिगरेसनका स्क्रिनसटहरू (token हटाइएको)

तपाईंको संस्थाका लागि SCIM प्रोभिजनिङ कन्फिगर गर्न हामी तपाईंलाई मद्दत गर्न यहाँ छौं।

पछिल्लो अपडेट 4 अक्टोबर 2026