SAML లేదా OIDC తో సింగిల్ సైన్-ఆన్ (SSO) ను కాన్ఫిగర్ చేయడం

ScribbleMaps, SAML 2.0 లేదా OpenID Connect (OIDC) ఉపయోగించి ఎంటర్‌ప్రైజ్ సింగిల్ సైన్-ఆన్‌కు మద్దతు ఇస్తుంది. దీనివల్ల మీ బృంద సభ్యులు Okta, Microsoft Entra ID (Azure AD), Google Workspace లేదా Auth0 వంటి మీ సంస్థ యొక్క ఐడెంటిటీ ప్రొవైడర్ (IdP) ఉపయోగించి ప్రమాణీకరించుకోవచ్చు.

SSO కాన్ఫిగరేషన్ team.scribblemaps.com లో అందుబాటులో ఉంది మరియు పూర్తిగా ఉచితం.

విషయ సూచిక

1. మద్దతు ఉన్న ఫీచర్లు
2. ప్రారంభించే ముందు
3. స్టెప్ 1: మీ ఇమెయిల్ డొమైన్‌ను ధృవీకరించండి
4. స్టెప్ 2: మీ ఐడెంటిటీ ప్రొవైడర్‌ను కాన్ఫిగర్ చేయండి
5. స్టెప్ 3: ScribbleMaps లో SSO ను కాన్ఫిగర్ చేయండి
6. స్టెప్ 4: మీ కాన్ఫిగరేషన్‌ను పరీక్షించండి
7. స్టెప్ 5: SSO ను ప్రారంభించండి
8. SP-ఇనిషియేటెడ్ SSO
9. OIN యూనివర్సల్ లాగౌట్
10. ప్రొవైడర్-నిర్దిష్ట గైడ్‌లు
11. అధునాతన ఎంపికలు
12. ట్రబుల్షూటింగ్

మద్దతు ఉన్న ఫీచర్లు

ScribbleMaps SSO ఇంటిగ్రేషన్ కింది ఫీచర్లకు మద్దతు ఇస్తుంది:

ప్రారంభించే ముందు

• SSO ను కాన్ఫిగర్ చేయడానికి మీరు తప్పనిసరిగా Team Owner అయి ఉండాలి
• మీ సంస్థ యొక్క ఐడెంటిటీ ప్రొవైడర్ అడ్మిన్ కన్సోల్‌కు మీకు యాక్సెస్ ఉండాలి
• మీ ఇమెయిల్ డొమైన్‌ను సిద్ధంగా ఉంచుకోండి (ఉదా., 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 మార్పులు ప్రచారం కావడానికి 48 గంటల వరకు పట్టవచ్చు.

ఎంపిక 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, లేదా Custom)
3. కింది సమాచారాన్ని నమోదు చేయండి:

4. సెట్టింగ్‌లను సేవ్ చేయండి క్లిక్ చేయండి

స్టెప్ 4: మీ కాన్ఫిగరేషన్‌ను పరీక్షించండి

వినియోగదారులందరికీ SSO ను ప్రారంభించే ముందు, మీ కాన్ఫిగరేషన్‌ను పరీక్షించండి:

1. Test Connection బటన్‌ను క్లిక్ చేయండి
2. SSO లాగిన్ ప్రవాహాన్ని అనుకరించడానికి కొత్త విండో తెరవబడుతుంది
3. మీ ఐడెంటిటీ ప్రొవైడర్‌తో ప్రమాణీకరణను పూర్తి చేయండి
4. మీరు విజయవంతంగా ScribbleMaps కు తిరిగి మళ్లించబడ్డారని ధృవీకరించండి

పరీక్ష విఫలమైతే, లోపం సందేశాన్ని సమీక్షించి మీ కాన్ఫిగరేషన్ సెట్టింగ్‌లను తనిఖీ చేయండి.

స్టెప్ 5: SSO ను ప్రారంభించండి

పరీక్ష విజయవంతమైన తర్వాత:

1. Enable SSO స్విచ్‌ను ON కు టోగుల్ చేయండి
2. మీ అమలు ఎంపికను ఎంచుకోండి:
   • Optional: వినియోగదారులు SSO లేదా పాస్‌వర్డ్ లాగిన్‌ను ఎంచుకోవచ్చు
   • Enforced: ధృవీకరించబడిన ఇమెయిల్ డొమైన్‌లు ఉన్న వినియోగదారులు తప్పనిసరిగా SSO ను ఉపయోగించాలి (పాస్‌వర్డ్ లాగిన్ నిలిపివేయబడుతుంది)

గమనిక: SSO అమలు చేయబడినప్పటికీ, Team Owners ఎల్లప్పుడూ బ్యాకప్‌గా పాస్‌వర్డ్ లాగిన్‌ను ఉపయోగించవచ్చు.

SP-ఇనిషియేటెడ్ SSO

ScribbleMaps, SP-ఇనిషియేటెడ్ SSO కు మద్దతు ఇస్తుంది, ఇది వినియోగదారులను ScribbleMaps లాగిన్ పేజీ నుండి సైన్-ఇన్ ప్రక్రియను ప్రారంభించడానికి అనుమతిస్తుంది. ఇది ఎలా పని చేస్తుందో ఇక్కడ ఉంది:

1. scribblemaps.com/account/login కు వెళ్లండి
2. మీ ఇమెయిల్ చిరునామాను నమోదు చేయండి (ఉదా., [email protected])
3. Sign in with SSO క్లిక్ చేయండి
4. ప్రమాణీకరణ కోసం మీరు మీ సంస్థ యొక్క ఐడెంటిటీ ప్రొవైడర్‌కు (ఉదా., Okta) మళ్లించబడతారు
5. విజయవంతమైన ప్రమాణీకరణ తర్వాత, మీరు ఆటోమేటిక్‌గా ScribbleMaps కు తిరిగి మళ్లించబడి సైన్ ఇన్ చేయబడతారు

మీ సంస్థ SSO ను అమలు చేసి ఉంటే, లాగిన్ పేజీలో మీ ఇమెయిల్‌ను నమోదు చేయడం వలన మీరు ఆటోమేటిక్‌గా మీ ఐడెంటిటీ ప్రొవైడర్‌కు మళ్లించబడతారు — పాస్‌వర్డ్ ఫీల్డ్ చూపబడదు.

OIN యూనివర్సల్ లాగౌట్

Okta యొక్క యూనివర్సల్ లాగౌట్‌కు మద్దతు ఉంది. కాన్ఫిగరేషన్ సూచనల కోసం దయచేసి ఈ లింక్ ను సందర్శించండి.

ప్రొవైడర్-నిర్దిష్ట గైడ్‌లు

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

అధునాతన ఎంపికలు

జస్ట్-ఇన్-టైమ్ (JIT) ప్రొవిజనింగ్

ప్రారంభించినప్పుడు, మొదటి SSO లాగిన్‌లో ScribbleMaps లో వినియోగదారులు ఆటోమేటిక్‌గా సృష్టించబడతారు. వారి ప్రొఫైల్ సమాచారం (పేరు, ఇమెయిల్) ఐడెంటిటీ ప్రొవైడర్ నుండి నింపబడుతుంది.

మల్టీ-ఫ్యాక్టర్ ప్రమాణీకరణను తప్పనిసరి చేయండి (OIDC మాత్రమే)

లాగిన్‌ను అనుమతించే ముందు MFA ధృవీకరణను తప్పనిసరి చేయడానికి ఈ ఎంపికను ప్రారంభించండి. వినియోగదారు కోసం మీ IdP MFA ను అమలు చేసిందో లేదో ScribbleMaps ధృవీకరిస్తుంది.

Okta కోసం, మీరు ఈ క్రింది అనుకూల ACR విలువలను పేర్కొనవచ్చు:

• urn:okta:loa:2fa:any - ఏదైనా రెండవ ఫ్యాక్టర్
• phr - ఫిషింగ్-నిరోధక ప్రమాణీకరణ
• phrh - ఫిషింగ్-నిరోధక హార్డ్‌వేర్-బౌండ్ ప్రమాణీకరణ

ఆట్రిబ్యూట్/క్లెయిమ్ మ్యాపింగ్

మీ IdP నుండి వినియోగదారు ఆట్రిబ్యూట్‌లు ScribbleMaps వినియోగదారు ఫీల్డ్‌లకు ఎలా మ్యాప్ అవుతాయో అనుకూలీకరించండి:

ట్రబుల్షూటింగ్

సాధారణ సమస్యలు

"Domain not verified"

• మీ DNS TXT రికార్డ్ లేదా ధృవీకరణ ఫైల్ సరిగ్గా కాన్ఫిగర్ చేయబడిందని నిర్ధారించుకోండి
• DNS మార్పులు ప్రచారం కావడానికి 48 గంటల వరకు పట్టవచ్చు
• ధృవీకరణ కోడ్‌లో అక్షర దోషాలు లేవని ధృవీకరించండి

"Invalid certificate"

• మీరు -----BEGIN CERTIFICATE----- మరియు -----END CERTIFICATE----- తో సహా పూర్తి సర్టిఫికెట్‌ను ఉపయోగిస్తున్నారని నిర్ధారించుకోండి
• సర్టిఫికెట్ గడువు ముగియలేదని తనిఖీ చేయండి
• మీరు ఎన్‌క్రిప్షన్ సర్టిఫికెట్‌ను కాకుండా సైనింగ్ సర్టిఫికెట్‌ను కాపీ చేశారని నిర్ధారించుకోండి

"Invalid signature"

• సర్టిఫికెట్ మీ IdP యొక్క ప్రస్తుత సైనింగ్ సర్టిఫికెట్‌తో సరిపోలుతుందని ధృవీకరించండి
• సిగ్నేచర్ అల్గారిథమ్ సరిపోలుతుందో లేదో తనిఖీ చేయండి (SHA-256 vs SHA-1)

"User not found" or "Email mismatch"

• మీ IdP తిరిగి ఇచ్చే ఇమెయిల్ ధృవీకరించబడిన డొమైన్‌తో సరిపోలుతుందని నిర్ధారించుకోండి
• NameID ఫార్మాట్ Email Address కు సెట్ చేయబడిందో లేదో తనిఖీ చేయండి
• ఆట్రిబ్యూట్/క్లెయిమ్ మ్యాపింగ్ సరైనదని ధృవీకరించండి

"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 ను కాన్ఫిగర్ చేయడంలో మీకు సహాయం చేయడానికి మేము ఇక్కడ ఉన్నాము.