SAML किंवा OIDC सह सिंगल साइन-ऑन (SSO) कॉन्फिगर करणे

ScribbleMaps SAML 2.0 किंवा OpenID Connect (OIDC) वापरून एंटरप्राइझ सिंगल साइन-ऑनला सपोर्ट करते. यामुळे तुमच्या टीम सदस्यांना तुमच्या संस्थेच्या आयडेंटिटी प्रोव्हायडर (IdP) द्वारे, जसे की Okta, Microsoft Entra ID (Azure AD), Google Workspace किंवा Auth0, ऑथेंटिकेट करता येते.

SSO कॉन्फिगरेशन team.scribblemaps.com वर उपलब्ध आहे आणि पूर्णपणे विनामूल्य आहे.

अनुक्रमणिका

1. सपोर्ट असलेली वैशिष्ट्ये
2. सुरू करण्यापूर्वी
3. पायरी (Step) 1: तुमचे ईमेल डोमेन व्हेरिफाय करा
4. पायरी (Step) 2: तुमचा आयडेंटिटी प्रोव्हायडर कॉन्फिगर करा
5. पायरी (Step) 3: ScribbleMaps मध्ये SSO कॉन्फिगर करा
6. पायरी (Step) 4: तुमचे कॉन्फिगरेशन तपासा
7. पायरी (Step) 5: SSO सुरू करा
8. SP-Initiated SSO
9. OIN Universal Logout
10. प्रोव्हायडरनुसार मार्गदर्शक (Guides)
11. प्रगत (Advanced) पर्याय
12. समस्यानिवारण

सपोर्ट असलेली वैशिष्ट्ये

ScribbleMaps SSO इंटिग्रेशन खालील वैशिष्ट्यांना सपोर्ट करते:

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

• SSO कॉन्फिगर करण्यासाठी तुम्ही Team Owner असणे आवश्यक आहे
• तुमच्या संस्थेच्या आयडेंटिटी प्रोव्हायडरच्या ॲडमिन कन्सोलचा तुम्हाला अॅक्सेस असणे आवश्यक आहे
• तुमचे ईमेल डोमेन तयार ठेवा (उदा., yourcompany.com)

पायरी (Step) 1: तुमचे ईमेल डोमेन व्हेरिफाय करा

SSO कॉन्फिगर करण्यापूर्वी, तुम्हाला तुमच्या ईमेल डोमेनची मालकी व्हेरिफाय करणे आवश्यक आहे. हा सुरक्षा उपाय केवळ अधिकृत संस्थाच त्यांच्या डोमेनसाठी SSO कॉन्फिगर करू शकतील याची खात्री करतो.

1. team.scribblemaps.com वर लॉग इन करा (Login)
2. सेटिंग्ज (Settings) > Single Sign-On वर जा
3. Domains टॅबवर जा
4. Add Domain वर क्लिक करा (Click) आणि तुमचे ईमेल डोमेन टाका (उदा., yourcompany.com)
5. व्हेरिफिकेशन पद्धत निवडा (Select):

पर्याय (Option) A: DNS TXT रेकॉर्ड (शिफारस केलेले)

तुमच्या डोमेनच्या DNS सेटिंग्जमध्ये TXT रेकॉर्ड जोडा (Add):

टीप: DNS बदल लागू होण्यासाठी 48 तासांपर्यंत वेळ लागू शकतो.

पर्याय (Option) B: फाइल अपलोड

1. scribblemaps-verify.txt नावाची टेक्स्ट फाइल तयार करा
2. तुमचा व्हेरिफिकेशन कोड हाच एकमेव मजकूर म्हणून जोडा
3. येथे अपलोड करा: https://yourcompany.com/.well-known/scribblemaps-verify.txt

व्हेरिफिकेशन जोडल्यानंतर, मालकी निश्चित करण्यासाठी Verify Domain वर क्लिक करा (Click).

पायरी (Step) 2: तुमचा आयडेंटिटी प्रोव्हायडर कॉन्फिगर करा

तुमच्या आयडेंटिटी प्रोव्हायडरमध्ये ScribbleMaps ला ॲप्लिकेशन म्हणून जोडा (Add). तुम्ही Okta वापरत असल्यास, तुम्ही Okta Integration Network (OIN) कॅटलॉगमधून थेट ScribbleMaps जोडू शकता — SAML SSO URL, SP Entity ID, ACS URL आणि OIDC Redirect URI आपोआप पूर्व-कॉन्फिगर केले जातात.

SAML 2.0 साठी

OIDC साठी

पायरी (Step) 3: ScribbleMaps मध्ये SSO कॉन्फिगर करा

SAML 2.0 कॉन्फिगर करणे

1. ScribbleMaps मध्ये, सेटिंग्ज (Settings) > Single Sign-On > SAML टॅबवर जा
2. तुमच्या आयडेंटिटी प्रोव्हायडरकडून खालील माहिती टाका:

3. सेटिंग्ज जतन करा वर क्लिक करा (Click)

OIDC कॉन्फिगर करणे

1. ScribbleMaps मध्ये, सेटिंग्ज (Settings) > Single Sign-On > OIDC टॅबवर जा
2. तुमचा Provider Type निवडा (Select) (Google, Microsoft, Okta, Auth0 किंवा सानुकूल (Custom))
3. खालील माहिती टाका:

4. सेटिंग्ज जतन करा वर क्लिक करा (Click)

पायरी (Step) 4: तुमचे कॉन्फिगरेशन तपासा

सर्व वापरकर्त्यांसाठी SSO सुरू करण्यापूर्वी, तुमचे कॉन्फिगरेशन तपासा:

1. Test Connection बटणावर क्लिक करा (Click)
2. SSO लॉगिन प्रक्रियेचे सिम्युलेशन करण्यासाठी नवीन विंडो उघडेल
3. तुमच्या आयडेंटिटी प्रोव्हायडरसह ऑथेंटिकेशन पूर्ण करा (Complete)
4. तुम्ही यशस्वीरित्या ScribbleMaps कडे परत रीडायरेक्ट झाला आहात हे तपासा

चाचणी अयशस्वी (Failed) झाल्यास, एरर संदेश तपासा आणि तुमच्या कॉन्फिगरेशन सेटिंग्ज तपासा.

पायरी (Step) 5: SSO सुरू करा

चाचणी यशस्वी झाल्यानंतर:

1. Enable SSO स्विच ON करा
2. तुमचा एन्फोर्समेंट पर्याय निवडा (Select):
   • Optional: वापरकर्ते SSO किंवा पासवर्ड लॉगिन निवडू शकतात
   • Enforced: व्हेरिफाय केलेले ईमेल डोमेन असलेल्या वापरकर्त्यांना SSO वापरावे लागेल (पासवर्ड लॉगिन बंद)

टीप: SSO एन्फोर्स केलेले असतानाही, Team Owners बॅकअप म्हणून नेहमी पासवर्ड लॉगिन वापरू शकतात.

SP-Initiated SSO

ScribbleMaps SP-initiated SSO ला सपोर्ट करते, ज्यामुळे वापरकर्ते ScribbleMaps लॉगिन पेजवरून साइन-इन प्रक्रिया सुरू करू शकतात. हे कसे काम करते ते असे:

1. scribblemaps.com/account/login वर जा
2. तुमचा ईमेल पत्ता (Address) टाका (उदा., [email protected])
3. Sign in with SSO वर क्लिक करा (Click)
4. ऑथेंटिकेट करण्यासाठी तुम्हाला तुमच्या संस्थेच्या आयडेंटिटी प्रोव्हायडरकडे (उदा., Okta) रीडायरेक्ट केले जाईल
5. यशस्वी ऑथेंटिकेशननंतर, तुम्हाला आपोआप ScribbleMaps कडे परत रीडायरेक्ट केले जाते आणि तुम्ही साइन इन होता

तुमच्या संस्थेने SSO एन्फोर्स केले असल्यास, लॉगिन पेजवर तुमचा ईमेल टाकल्यावर तुम्हाला आपोआप तुमच्या आयडेंटिटी प्रोव्हायडरकडे रीडायरेक्ट केले जाईल — पासवर्ड फील्ड दाखवले जाणार नाही.

OIN Universal Logout

Okta चे Universal logout सपोर्टेड आहे. कॉन्फिगरेशन सूचनांसाठी कृपया या लिंक ला भेट द्या.

प्रोव्हायडरनुसार मार्गदर्शक (Guides)

Okta

1. Okta Admin Console मध्ये, Applications > Browse App Catalog वर जा
2. ScribbleMaps शोधा (Search) आणि Add Integration वर क्लिक करा (Click)
3. SSO URL, Entity ID आणि Redirect URI आपोआप पूर्व-कॉन्फिगर केले जातात
4. तुमचे IdP कॉन्फिगरेशन तपशील शोधण्यासाठी Sign On टॅबवर जा:
   • X.509 Certificate डाउनलोड करा
   • Identity Provider Issuer (Entity ID) कॉपी करा
   • Single Sign-On URL कॉपी करा
5. ही मूल्ये ScribbleMaps SSO सेटिंग्जमध्ये टाका (पायरी (Step) 3 पहा)

Microsoft Entra ID (Azure AD)

1. Azure Portal मध्ये, Microsoft Entra ID > App registrations > New registration वर जा
2. कॉन्फिगर करा:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web platform)
3. Certificates & secrets वर जा > नवीन Client secret तयार करा (Create)
4. Application (client) ID आणि Client secret value कॉपी करा
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. Google Cloud Console मध्ये, APIs & Services > Credentials वर जा
2. Create Credentials > OAuth client ID वर क्लिक करा (Click)
3. Web application निवडा (Select)
4. Authorized redirect URI जोडा (Add): https://api.scribblemaps.com/oidc/callback
5. Client ID आणि Client Secret कॉपी करा
6. Authority URL: https://accounts.google.com

टीप: Google Workspace साठी MFA आवश्यक करण्यासाठी, ते तुमच्या Google Workspace Admin Console मध्ये कॉन्फिगर करा.

Auth0

1. Auth0 Dashboard मध्ये, Applications > Create Application वर जा
2. Regular Web Applications निवडा (Select)
3. कॉन्फिगर करा:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. सेटिंग्ज (Settings) टॅबवरून Client ID आणि Client Secret कॉपी करा
5. Authority URL: https://YOUR-DOMAIN.auth0.com

प्रगत (Advanced) पर्याय

Just-In-Time (JIT) Provisioning

सुरू केल्यावर, वापरकर्ते पहिल्या SSO लॉगिनवेळी ScribbleMaps मध्ये आपोआप तयार केले जातात. त्यांची प्रोफाइल माहिती (नाव, ईमेल) आयडेंटिटी प्रोव्हायडरकडून भरली जाते.

Multi-Factor Authentication आवश्यक करा (फक्त OIDC)

लॉगिनला परवानगी देण्यापूर्वी MFA व्हेरिफिकेशन आवश्यक करण्यासाठी हा पर्याय सुरू करा. तुमच्या IdP ने वापरकर्त्यासाठी MFA एन्फोर्स केले आहे का हे ScribbleMaps व्हेरिफाय करेल.

Okta साठी, तुम्ही सानुकूल (Custom) ACR मूल्ये निर्दिष्ट करू शकता, जसे की:

• urn:okta:loa:2fa:any - कोणताही दुसरा फॅक्टर
• phr - फिशिंग-रेझिस्टंट ऑथेंटिकेशन
• phrh - फिशिंग-रेझिस्टंट हार्डवेअर-बाउंड ऑथेंटिकेशन

Attribute/Claim मॅपिंग

तुमच्या IdP कडील वापरकर्ता गुणधर्म (Attribute) ScribbleMaps वापरकर्ता फील्डशी कसे मॅप होतात ते सानुकूल करा:

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

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

"Domain not verified"

• तुमचा DNS TXT रेकॉर्ड किंवा व्हेरिफिकेशन फाइल योग्यरित्या कॉन्फिगर केली आहे याची खात्री करा
• DNS बदल लागू होण्यासाठी 48 तासांपर्यंत वेळ लागू शकतो
• व्हेरिफिकेशन कोडमध्ये टायपो नाहीत हे तपासा

"Invalid certificate"

• -----BEGIN CERTIFICATE----- आणि -----END CERTIFICATE----- सह संपूर्ण सर्टिफिकेट वापरत आहात याची खात्री करा
• सर्टिफिकेटची मुदत संपलेली नाही हे तपासा
• तुम्ही सायनिंग सर्टिफिकेट कॉपी केले आहे, एन्क्रिप्शन सर्टिफिकेट नाही याची खात्री करा

"Invalid signature"

• सर्टिफिकेट तुमच्या IdP च्या सध्याच्या सायनिंग सर्टिफिकेटशी जुळते का ते तपासा
• सिग्नेचर अल्गोरिदम जुळतो का ते तपासा (SHA-256 वि. SHA-1)

"User not found" किंवा "Email mismatch"

• तुमच्या IdP ने परत केलेला ईमेल व्हेरिफाय केलेल्या डोमेनशी जुळतो याची खात्री करा
• NameID format Email Address वर सेट आहे का ते तपासा
• गुणधर्म (Attribute)/claim मॅपिंग योग्य आहे का ते तपासा

"Security error: Your Identity Provider is not authorized for this email domain"

• IdP कॉन्फिगरेशन व्हेरिफाय केलेल्या डोमेनशी जुळत नसल्यास हे घडते
• ईमेल डोमेन तुमच्या टीम अंतर्गत व्हेरिफाय केलेले आहे याची खात्री करा
• तुम्ही व्हेरिफाय केलेल्या डोमेनमधील ईमेलने लॉग इन करत आहात का ते तपासा

ऑडिट लॉग पाहणे

सेटिंग्ज (Settings) > Single Sign-On > Audit Logs मध्ये SSO क्रियाकलापांवर लक्ष ठेवा. तुम्ही हे करू शकता:

• इव्हेंट प्रकारानुसार फिल्टर करा (Filter) (Login, Logout, Failed Login)
• तारीख श्रेणीनुसार फिल्टर करा (Filter)
• कंप्लायन्स रिपोर्टिंगसाठी लॉग CSV म्हणून एक्सपोर्ट करा

मदत हवी आहे?

SSO कॉन्फिगरेशनमध्ये तुम्हाला अडचणी येत असल्यास, कृपया आमच्या सपोर्ट टीमशी खालील माहितीसह संपर्क साधा:

• तुमच्या टीमचे नाव
• तुम्ही वापरत असलेला आयडेंटिटी प्रोव्हायडर
• तुम्हाला दिसत असलेले कोणतेही एरर संदेश
• तुमच्या IdP कॉन्फिगरेशनचे स्क्रीनशॉट (संवेदनशील डेटा काढून टाकून)

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