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. चरण 1: आफ्नो इमेल डोमेन प्रमाणित गर्नुहोस्
4. चरण 2: आफ्नो आइडेन्टिटी प्रोभाइडर कन्फिगर गर्नुहोस्
5. चरण 3: ScribbleMaps मा SSO कन्फिगर गर्नुहोस्
6. चरण 4: आफ्नो कन्फिगरेसन परीक्षण गर्नुहोस्
7. चरण 5: SSO सक्षम गर्नुहोस्
8. SP-Initiated SSO
9. OIN Universal Logout
10. प्रोभाइडर-विशेष गाइडहरू
11. उन्नत विकल्पहरू
12. समस्या समाधान

समर्थित विशेषताहरू

ScribbleMaps SSO इन्टिग्रेसनले निम्न विशेषताहरू समर्थन गर्छ:

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

• SSO कन्फिगर गर्न तपाईं टोली मालिक हुनुपर्छ
• तपाईंलाई आफ्नो संस्थाको आइडेन्टिटी प्रोभाइडर एडमिन कन्सोलमा पहुँच चाहिन्छ
• आफ्नो इमेल डोमेन तयार राख्नुहोस् (जस्तै, yourcompany.com)

चरण 1: आफ्नो इमेल डोमेन प्रमाणित गर्नुहोस्

SSO कन्फिगर गर्नु अघि, तपाईंले आफ्नो इमेल डोमेनको स्वामित्व प्रमाणित गर्नुपर्छ। यो सुरक्षा उपायले अधिकृत संस्थाहरूले मात्र आफ्ना डोमेनहरूका लागि SSO कन्फिगर गर्न सक्छन् भन्ने सुनिश्चित गर्छ।

1. team.scribblemaps.com मा लगइन गर्नुहोस्
2. सेटिङहरू > Single Sign-On मा जानुहोस्
3. Domains ट्याबमा जानुहोस्
4. Add Domain मा क्लिक गर्नुहोस् र आफ्नो इमेल डोमेन प्रविष्ट गर्नुहोस् (जस्तै, yourcompany.com)
5. प्रमाणीकरण विधि छनोट गर्नुहोस्:

विकल्प A: DNS TXT रेकर्ड (सिफारिस गरिएको)

आफ्नो डोमेनको DNS सेटिङहरूमा TXT रेकर्ड थप्नुहोस्:

नोट: DNS परिवर्तनहरू फैलिन ४८ घण्टासम्म लाग्न सक्छ।

विकल्प B: फाइल अपलोड

1. scribblemaps-verify.txt नामको टेक्स्ट फाइल बनाउनुहोस्
2. आफ्नो प्रमाणीकरण कोडलाई एकमात्र सामग्रीको रूपमा थप्नुहोस्
3. यहाँ अपलोड गर्नुहोस्: https://yourcompany.com/.well-known/scribblemaps-verify.txt

प्रमाणीकरण थपेपछि, स्वामित्व पुष्टि गर्न Verify Domain मा क्लिक गर्नुहोस्।

चरण 2: आफ्नो आइडेन्टिटी प्रोभाइडर कन्फिगर गर्नुहोस्

आफ्नो आइडेन्टिटी प्रोभाइडरमा ScribbleMaps लाई एप्लिकेसनको रूपमा थप्नुहोस्। यदि तपाईं Okta प्रयोग गर्दै हुनुहुन्छ भने, तपाईंले Okta Integration Network (OIN) क्याटलगबाट सिधै ScribbleMaps थप्न सक्नुहुन्छ — SAML SSO URL, SP Entity ID, ACS URL, र OIDC Redirect URI स्वतः पूर्व-कन्फिगर गरिएका हुन्छन्।

SAML 2.0 का लागि

OIDC का लागि

चरण 3: ScribbleMaps मा SSO कन्फिगर गर्नुहोस्

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

1. ScribbleMaps मा, सेटिङहरू > Single Sign-On > SAML ट्याबमा जानुहोस्
2. आफ्नो आइडेन्टिटी प्रोभाइडरबाट निम्न जानकारी प्रविष्ट गर्नुहोस्:

3. सेटिङहरू बचत गर्नुहोस् मा क्लिक गर्नुहोस्

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

1. ScribbleMaps मा, सेटिङहरू > Single Sign-On > OIDC ट्याबमा जानुहोस्
2. आफ्नो Provider Type चयन गर्नुहोस् (Google, Microsoft, Okta, Auth0, वा कस्टम)
3. निम्न जानकारी प्रविष्ट गर्नुहोस्:

4. सेटिङहरू बचत गर्नुहोस् मा क्लिक गर्नुहोस्

चरण 4: आफ्नो कन्फिगरेसन परीक्षण गर्नुहोस्

सबै प्रयोगकर्ताहरूका लागि SSO सक्षम गर्नु अघि, आफ्नो कन्फिगरेसन परीक्षण गर्नुहोस्:

1. Test Connection बटनमा क्लिक गर्नुहोस्
2. SSO लगइन प्रक्रिया अनुकरण गर्न नयाँ विन्डो खुल्नेछ
3. आफ्नो आइडेन्टिटी प्रोभाइडरसँग प्रमाणीकरण पूरा गर्नुहोस्
4. तपाईं सफलतापूर्वक ScribbleMaps मा फर्किनुभएको पुष्टि गर्नुहोस्

यदि परीक्षण असफल भयो भने, त्रुटि सन्देश समीक्षा गर्नुहोस् र आफ्ना कन्फिगरेसन सेटिङहरू जाँच गर्नुहोस्।

चरण 5: SSO सक्षम गर्नुहोस्

परीक्षण सफल भएपछि:

1. Enable SSO स्विचलाई ON मा टगल गर्नुहोस्
2. आफ्नो प्रवर्तन विकल्प छनोट गर्नुहोस्:
   • Optional: प्रयोगकर्ताहरूले SSO वा पासवर्ड लगइन छनोट गर्न सक्छन्
   • Enforced: प्रमाणित इमेल डोमेन भएका प्रयोगकर्ताहरूले SSO प्रयोग गर्नैपर्छ (पासवर्ड लगइन असक्षम)

नोट: SSO प्रवर्तन गरिएको अवस्थामा पनि टोली मालिकहरूले ब्याकअपको रूपमा सधैं पासवर्ड लगइन प्रयोग गर्न सक्छन्।

SP-Initiated SSO

ScribbleMaps ले SP-initiated SSO समर्थन गर्छ, जसले प्रयोगकर्ताहरूलाई ScribbleMaps लगइन पृष्ठबाट साइन-इन प्रक्रिया सुरु गर्न अनुमति दिन्छ। यसले यसरी काम गर्छ:

1. scribblemaps.com/account/login मा जानुहोस्
2. आफ्नो इमेल ठेगाना प्रविष्ट गर्नुहोस् (जस्तै, [email protected])
3. Sign in with SSO मा क्लिक गर्नुहोस्
4. प्रमाणीकरणका लागि तपाईंलाई आफ्नो संस्थाको आइडेन्टिटी प्रोभाइडर (जस्तै, Okta) मा रिडाइरेक्ट गरिनेछ
5. सफल प्रमाणीकरणपछि, तपाईं स्वतः ScribbleMaps मा फर्कनुहुन्छ र साइन इन हुनुहुन्छ

यदि तपाईंको संस्थाले SSO प्रवर्तन गरेको छ भने, लगइन पृष्ठमा आफ्नो इमेल प्रविष्ट गर्दा तपाईं स्वतः आफ्नो आइडेन्टिटी प्रोभाइडरमा रिडाइरेक्ट हुनुहुनेछ — कुनै पासवर्ड फिल्ड देखाइने छैन।

OIN Universal Logout

Okta द्वारा Universal logout समर्थित छ। कन्फिगरेसन निर्देशनहरूका लागि कृपया यो लिङ्क हेर्नुहोस्।

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

Okta

1. Okta Admin Console मा, Applications > Browse App Catalog मा जानुहोस्
2. ScribbleMaps खोज्नुहोस् र Add Integration मा क्लिक गर्नुहोस्
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 सेटिङहरूमा प्रविष्ट गर्नुहोस् (चरण 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 सिर्जना गर्नुहोस्
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 मा क्लिक गर्नुहोस्
3. Web application चयन गर्नुहोस्
4. Authorized redirect URI थप्नुहोस्: 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 चयन गर्नुहोस्
3. कन्फिगर गर्नुहोस्:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. सेटिङहरू ट्याबबाट Client ID र Client Secret प्रतिलिपि गर्नुहोस्
5. Authority URL: https://YOUR-DOMAIN.auth0.com

उन्नत विकल्पहरू

Just-In-Time (JIT) Provisioning

सक्षम गरिएको बेला, प्रयोगकर्ताहरू पहिलो SSO लगइनमा ScribbleMaps मा स्वतः सिर्जना हुन्छन्। उनीहरूको प्रोफाइल जानकारी (नाम, इमेल) आइडेन्टिटी प्रोभाइडरबाट भरिन्छ।

Multi-Factor Authentication अनिवार्य गर्ने (OIDC मात्र)

लगइन अनुमति दिनु अघि MFA प्रमाणीकरण अनिवार्य गर्न यो विकल्प सक्षम गर्नुहोस्। ScribbleMaps ले तपाईंको IdP ले प्रयोगकर्ताका लागि MFA प्रवर्तन गरेको छ भनी प्रमाणित गर्नेछ।

Okta का लागि, तपाईंले यस्ता कस्टम ACR मानहरू निर्दिष्ट गर्न सक्नुहुन्छ:

• urn:okta:loa:2fa:any - कुनै पनि दोस्रो कारक
• phr - फिसिङ-प्रतिरोधी प्रमाणीकरण
• phrh - फिसिङ-प्रतिरोधी हार्डवेयर-बाउन्ड प्रमाणीकरण

एट्रिब्युट/क्लेम म्यापिङ

तपाईंको IdP का प्रयोगकर्ता एट्रिब्युटहरू ScribbleMaps प्रयोगकर्ता फिल्डहरूमा कसरी म्याप हुन्छन् भनी अनुकूलन गर्नुहोस्:

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

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

"Domain not verified"

• तपाईंको DNS TXT रेकर्ड वा प्रमाणीकरण फाइल सही रूपमा कन्फिगर गरिएको छ भन्ने सुनिश्चित गर्नुहोस्
• DNS परिवर्तनहरू फैलिन ४८ घण्टासम्म लाग्न सक्छ
• प्रमाणीकरण कोडमा कुनै टाइपो छैन भन्ने जाँच गर्नुहोस्

"Invalid certificate"

• -----BEGIN CERTIFICATE----- र -----END CERTIFICATE----- सहितको पूर्ण सर्टिफिकेट प्रयोग गर्दै हुनुहुन्छ भन्ने सुनिश्चित गर्नुहोस्
• सर्टिफिकेटको म्याद सकिएको छैन भन्ने जाँच गर्नुहोस्
• तपाईंले इन्क्रिप्सन सर्टिफिकेट होइन, साइनिङ सर्टिफिकेट प्रतिलिपि गर्नुभएको छ भन्ने सुनिश्चित गर्नुहोस्

"Invalid signature"

• सर्टिफिकेट तपाईंको IdP को हालको साइनिङ सर्टिफिकेटसँग मेल खान्छ भन्ने प्रमाणित गर्नुहोस्
• सिग्नेचर एल्गोरिदम मेल खान्छ (SHA-256 बनाम SHA-1) भन्ने जाँच गर्नुहोस्

"User not found" वा "Email mismatch"

• तपाईंको IdP ले फर्काएको इमेल प्रमाणित डोमेनसँग मेल खान्छ भन्ने सुनिश्चित गर्नुहोस्
• NameID ढाँचा (Format) इमेल ठेगानामा सेट गरिएको छ भन्ने जाँच गर्नुहोस्
• एट्रिब्युट/क्लेम म्यापिङ सही छ भन्ने प्रमाणित गर्नुहोस्

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

• यो तब हुन्छ जब IdP कन्फिगरेसन प्रमाणित डोमेनसँग मेल खाँदैन
• इमेल डोमेन तपाईंको टोली अन्तर्गत प्रमाणित गरिएको छ भन्ने सुनिश्चित गर्नुहोस्
• तपाईं प्रमाणित डोमेनको इमेलसँग लगइन गर्दै हुनुहुन्छ भन्ने जाँच गर्नुहोस्

अडिट लगहरू हेर्ने

सेटिङहरू > Single Sign-On > Audit Logs मा SSO गतिविधि अनुगमन गर्नुहोस्। तपाईं यी गर्न सक्नुहुन्छ:

• घटना प्रकार (Login, Logout, Failed Login) अनुसार फिल्टर गर्नुहोस्
• मिति दायरा अनुसार फिल्टर गर्नुहोस्
• अनुपालन रिपोर्टिङका लागि लगहरू CSV को रूपमा निर्यात गर्नुहोस्

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

यदि तपाईंलाई SSO कन्फिगरेसनमा समस्या भइरहेको छ भने, कृपया निम्न जानकारीसहित हाम्रो सहायता टोलीलाई सम्पर्क गर्नुहोस्:

• तपाईंको टोलीको नाम
• तपाईंले प्रयोग गरिरहनुभएको आइडेन्टिटी प्रोभाइडर
• तपाईंले देखिरहनुभएका कुनै पनि त्रुटि सन्देशहरू
• तपाईंको IdP कन्फिगरेसनका स्क्रिनसटहरू (संवेदनशील डेटा हटाएर)

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