Scribble Maps मदत केंद्र
भाषा बदला

SCIM प्रोव्हिजनिंग

SCIM वापरकर्ता प्रोव्हिजनिंग कॉन्फिगर करणे

ScribbleMaps स्वयंचलित वापरकर्ता प्रोव्हिजनिंग आणि डीप्रोव्हिजनिंगसाठी SCIM 2.0 (System for Cross-domain Identity Management) ला समर्थन देते. यामुळे तुम्ही तुमच्या Identity Provider (IdP) मधील वापरकर्ते ScribbleMaps मध्ये आपोआप सिंक करू शकता, ज्यामुळे टीम सदस्यत्व तुमच्या संस्थेच्या डिरेक्टरीशी सिंकमध्ये राहते.

SCIM प्रोव्हिजनिंग team.scribblemaps.com वर उपलब्ध आहे आणि पूर्णपणे विनामूल्य आहे.

अनुक्रमणिका

  1. SCIM म्हणजे काय?
  2. सुरू करण्यापूर्वी
  3. पायरी 1: ScribbleMaps मध्ये SCIM सक्षम करा
  4. पायरी 2: Bearer Token तयार करा
  5. पायरी 3: तुमचा Identity Provider कॉन्फिगर करा
  6. पायरी 4: डीफॉल्ट प्रोडक्ट असाइनमेंट सेट करा
  7. पायरी 5: चाचणी करा आणि वापरकर्ते असाइन करा
  8. प्रोव्हायडर-विशिष्ट मार्गदर्शक (Guides)
  9. समर्थित SCIM ऑपरेशन्स
  10. वापरकर्ता लाइफसायकल व्यवस्थापन
  11. समस्यानिवारण

SCIM म्हणजे काय?

SCIM (System for Cross-domain Identity Management) हे एक खुले मानक आहे जे तुम्हाला आपोआप खालील गोष्टी करण्याची परवानगी देते:

  • वापरकर्ते प्रोव्हिजन करा - तुमच्या IdP मध्ये वापरकर्ते असाइन केल्यावर ScribbleMaps खाती आपोआप तयार करा
  • वापरकर्ते अपडेट करा - वापरकर्ता माहिती (नाव, ईमेल) सिंक्रोनाइझ ठेवा
  • वापरकर्ते डीप्रोव्हिजन करा - तुमच्या IdP मधून वापरकर्ते काढल्यावर खाती आपोआप निष्क्रिय करा
  • भूमिका व्यवस्थापित करा - गट सदस्यत्वाद्वारे वापरकर्त्यांना ॲडमिन किंवा सदस्य भूमिका असाइन करा

संपूर्ण आयडेंटिटी लाइफसायकल व्यवस्थापनासाठी SCIM हे SSO (SAML/OIDC) सोबत काम करते.

सुरू करण्यापूर्वी

  • SCIM कॉन्फिगर करण्यासाठी तुम्ही Team Owner असणे आवश्यक आहे
  • तुम्हाला तुमच्या Identity Provider च्या ॲडमिन कन्सोलमध्ये प्रवेश असणे आवश्यक आहे
  • तुमचा IdP SCIM 2.0 ला समर्थन देत असणे आवश्यक आहे (Okta, Microsoft Entra ID, OneLogin, JumpCloud, इ.)
  • सर्वोत्तम वापरकर्ता अनुभवासाठी SCIM पूर्वी (Before) SSO कॉन्फिगर करण्याची आम्ही शिफारस करतो

पायरी 1: ScribbleMaps मध्ये SCIM सक्षम करा

  1. team.scribblemaps.com मध्ये लॉग इन करा
  2. SCIM Provisioning (डाव्या बाजूचा साइड बार) येथे जा
  3. Enable SCIM टॉगल ON करा

टीप: SCIM पूर्णपणे सक्षम होण्यापूर्वी तुम्हाला bearer token तयार करावा लागेल.

पायरी 2: Bearer Token तयार करा

Bearer token तुमच्या Identity Provider ला ScribbleMaps सोबत प्रमाणित करतो.

  1. SCIM सेटिंग्ज पेजवर, Generate Token वर क्लिक करा
  2. टोकन लगेच कॉपी करा आणि सुरक्षितपणे साठवा

महत्त्वाच्या सुरक्षा टिपा:

  • टोकन फक्त एकदाच दाखवला जातो - तो हरवल्यास तुम्हाला नवीन तयार करावा लागेल
  • या टोकनला पासवर्डप्रमाणे वागवा - टोकन असलेली कोणतीही व्यक्ती तुमच्या टीमचे वापरकर्ते व्यवस्थापित करू शकते
  • टोकनशी तडजोड झाल्यास तुम्ही तो कधीही रद्द करून पुन्हा तयार करू शकता
  • टोकन रद्द केल्यास नवीन टोकन कॉन्फिगर होईपर्यंत सर्व SCIM ऑपरेशन्स त्वरित थांबतात

पायरी 3: तुमचा Identity Provider कॉन्फिगर करा

तुमच्या IdP मध्ये ScribbleMaps ला SCIM ॲप्लिकेशन म्हणून कॉन्फिगर करण्यासाठी खालील तपशील वापरा:

सेटिंग मूल्य (Value)
SCIM Base URL https://api.scribblemaps.com/scim/v2
Authentication Method HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
Unique Identifier userName (ईमेल पत्ता)

SCIM Endpoints संदर्भ

Endpoint उद्देश
/scim/v2/Users वापरकर्ता प्रोव्हिजनिंग आणि व्यवस्थापन
/scim/v2/Groups भूमिका/गट सदस्यत्व व्यवस्थापन
/scim/v2/ServiceProviderConfig SCIM क्षमता (डिस्कव्हरी)
/scim/v2/ResourceTypes समर्थित रिसोर्स प्रकार (डिस्कव्हरी)
/scim/v2/Schemas वापरकर्ता आणि गट स्कीमा (डिस्कव्हरी)

पायरी 4: डीफॉल्ट प्रोडक्ट असाइनमेंट सेट करा (ऐच्छिक)

SCIM द्वारे प्रोव्हिजन केल्यावर तुम्ही वापरकर्त्यांना आपोआप प्रोडक्ट लायसन्स असाइन करू शकता:

  1. SCIM सेटिंग्ज पेजवर, Default Product Assignment शोधा
  2. एक प्रोडक्ट निवडा (Select):
    • काहीही नाही - वापरकर्ते प्रोडक्टशिवाय तयार केले जातात (नंतर मॅन्युअली असाइन करा)
    • व्ह्यूअर (Viewer) - फक्त पाहण्याचा प्रवेश
    • Pro Basic - मानक संपादन वैशिष्ट्ये
    • Pro Business - संपूर्ण वैशिष्ट्य प्रवेश
  3. जतन करा वर क्लिक करा

टीप: सीट्स उपलब्ध असतील तरच वापरकर्त्यांना प्रोडक्ट असाइन केला जाईल. सीट्स उपलब्ध नसल्यास वापरकर्ता तयार होतो पण असाइन न केलेला राहतो.

पायरी 5: चाचणी करा आणि वापरकर्ते असाइन करा

  1. तुमच्या Identity Provider मध्ये, SCIM कनेक्टिव्हिटी पडताळण्यासाठी Test Connection वैशिष्ट्य वापरा
  2. तुमच्या IdP मध्ये ScribbleMaps ॲप्लिकेशनला एक चाचणी वापरकर्ता असाइन करा
  3. वापरकर्ता तुमच्या ScribbleMaps टीम सदस्यांच्या यादीत दिसतो का ते पडताळा
  4. पुष्टी झाल्यावर, गरजेनुसार अतिरिक्त वापरकर्ते किंवा गट असाइन करा

प्रोव्हायडर-विशिष्ट मार्गदर्शक (Guides)

Okta

  1. Okta Admin Console मध्ये, Applications > Browse App Catalog येथे जा
  2. "SCIM 2.0 Test App (Header Auth)" शोधा (Search) किंवा सानुकूल (Custom) 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: तुमचा 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 ॲप्लिकेशन निवडा (किंवा नवीन तयार करा)
  3. Provisioning > सुरुवात करा येथे जा
  4. Provisioning Mode Automatic वर सेट करा
  5. Admin Credentials अंतर्गत:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: तुमचा ScribbleMaps SCIM टोकन पेस्ट करा
  6. पडताळणीसाठी Test Connection वर क्लिक करा
  7. वापरकर्ता गुणधर्मांसाठी (Attributes) Mappings कॉन्फिगर करा
  8. Provisioning Status On वर सेट करा
  9. वापरकर्ते असाइन करण्यासाठी Users and groups येथे जा

OneLogin

  1. OneLogin Admin मध्ये, Applications > Add App येथे जा
  2. "SCIM Provisioner with SAML (SCIM v2 Core)" किंवा तत्सम शोधा (Search)
  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. नवीन ॲप्लिकेशन जोडण्यासाठी + वर क्लिक करा
  3. Custom SCIM निवडा (Select)
  4. कॉन्फिगर करा:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: तुमचा ScribbleMaps SCIM टोकन पेस्ट करा
    • Authentication: Bearer Token
  5. Test Connection वर क्लिक करा
  6. गुणधर्म (Attribute) मॅपिंग्ज कॉन्फिगर करा
  7. ॲप्लिकेशनला वापरकर्ता गट असाइन करा

समर्थित SCIM ऑपरेशन्स

वापरकर्ता ऑपरेशन्स

ऑपरेशन पद्धत (Method) समर्थित वर्णन
वापरकर्त्यांची यादी GET /Users होय पेजिनेशन आणि फिल्टरिंगसह सर्व वापरकर्ते मिळवा
वापरकर्ता मिळवा GET /Users/{id} होय ID द्वारे विशिष्ट वापरकर्ता मिळवा
वापरकर्ता तयार करा POST /Users होय नवीन वापरकर्ता प्रोव्हिजन करा
वापरकर्ता बदला PUT /Users/{id} होय वापरकर्ता गुणधर्मांचे संपूर्ण अपडेट
वापरकर्ता अपडेट करा PATCH /Users/{id} होय वापरकर्ता गुणधर्मांचे आंशिक अपडेट
वापरकर्ता हटवा DELETE /Users/{id} होय वापरकर्ता निष्क्रिय करा (सॉफ्ट डिलीट)

गट ऑपरेशन्स

ऑपरेशन पद्धत (Method) समर्थित वर्णन
गटांची यादी GET /Groups होय ॲडमिन आणि सदस्य भूमिका गट परत करते
गट मिळवा GET /Groups/{id} होय सदस्य यादीसह गट मिळवा
गट अपडेट करा PATCH /Groups/{id} होय भूमिका गटांमध्ये सदस्य जोडा/काढा
गट तयार करा POST /Groups नाही समर्थित नाही (भूमिका निश्चित आहेत)

समर्थित वापरकर्ता गुणधर्म (Attributes)

SCIM गुणधर्म (Attribute) 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 सदस्य मानक टीम सदस्य प्रवेश

वापरकर्त्याला ॲडमिन म्हणून असाइन करण्यासाठी, SCIM PATCH द्वारे त्यांना admin गटात जोडा. Owner भूमिका SCIM द्वारे बदलता येत नाही.

समस्यानिवारण

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

"401 Unauthorized" किंवा "Invalid token"

  • Bearer token बरोबर आहे आणि रद्द केलेला नाही हे पडताळा
  • टोकन Authorization हेडरमध्ये Bearer YOUR_TOKEN या स्वरूपात पाठवला जात असल्याची खात्री करा
  • टोकनची मुदत संपली आहे का ते तपासा (मुदत सेट केली असल्यास)
  • गरज असल्यास नवीन टोकन तयार करा

"409 Conflict" - वापरकर्ता आधीच अस्तित्वात आहे

  • त्या ईमेलचा वापरकर्ता तुमच्या टीममध्ये आधीच अस्तित्वात आहे
  • विद्यमान वापरकर्ता निष्क्रिय केलेला असल्यास, SCIM त्यांना आपोआप पुन्हा सक्रिय करेल
  • तुमच्या IdP मध्ये डुप्लिकेट ईमेल पत्ते आहेत का ते तपासा

"400 Bad Request" - आवश्यक फील्ड गहाळ

  • विनंतीमध्ये userName (ईमेल) समाविष्ट असल्याची खात्री करा
  • ईमेल स्वरूप वैध असल्याचे पडताळा
  • तुमच्या IdP चे गुणधर्म (Attribute) मॅपिंग कॉन्फिगरेशन तपासा

वापरकर्ते तयार झाले पण प्रोडक्ट असाइन झाला नाही

  • SCIM सेटिंग्जमध्ये डीफॉल्ट प्रोडक्ट कॉन्फिगर केला आहे का ते तपासा
  • डीफॉल्ट प्रोडक्टसाठी तुमच्याकडे सीट्स उपलब्ध आहेत हे पडताळा
  • वापरकर्त्यांना Team Settings मध्ये मॅन्युअली प्रोडक्ट असाइन करता येतात

वापरकर्ता बदल सिंक होत नाहीत

  • काही IdP वेळापत्रकानुसार सिंक करतात (उदा., Azure AD साठी दर 40 मिनिटांनी)
  • तुमच्या IdP मध्ये मॅन्युअल सिंक सक्तीने करून पहा
  • SCIM अजूनही सक्षम आहे आणि टोकन वैध आहे हे पडताळा

Test connection अयशस्वी होते

  • SCIM Base URL अगदी https://api.scribblemaps.com/scim/v2 असल्याचे पडताळा
  • शेवटी स्लॅश किंवा टायपो नसल्याची खात्री करा
  • तुमचे नेटवर्क/फायरवॉल api.scribblemaps.com ला आउटबाउंड HTTPS ला परवानगी देते का ते तपासा
     

मदत हवी आहे?

SCIM प्रोव्हिजनिंगमध्ये तुम्हाला समस्या येत असल्यास, कृपया आमच्या सपोर्ट टीमशी खालील माहितीसह संपर्क साधा:

  • तुमच्या टीमचे नाव
  • तुम्ही वापरत असलेला Identity Provider
  • तुमच्या IdP च्या प्रोव्हिजनिंग लॉगमधील कोणतेही एरर मेसेजेस
  • तुमच्या SCIM कॉन्फिगरेशनचे स्क्रीनशॉट्स (टोकन लपवलेला)

तुमच्या संस्थेसाठी SCIM प्रोव्हिजनिंग कॉन्फिगर करण्यात मदत करण्यासाठी आम्ही येथे आहोत.

शेवटचे अद्यतन