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 ગોઠવવા માટે તમે ટીમ માલિક (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, અથવા કસ્ટમ)
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 (વેબ પ્લેટફોર્મ)
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. Settings ટૅબ પરથી Client ID અને Client Secret કૉપિ કરો
5. Authority URL: https://YOUR-DOMAIN.auth0.com

અદ્યતન વિકલ્પો

Just-In-Time (JIT) પ્રોવિઝનિંગ

સક્ષમ હોય ત્યારે, પ્રથમ 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 ફેરફારો પ્રસરતા 48 કલાક સુધી લાગી શકે છે
• ચકાસણી કોડમાં કોઈ ટાઇપો નથી તેની ખાતરી કરો

"Invalid certificate"

• ખાતરી કરો કે તમે -----BEGIN CERTIFICATE----- અને -----END CERTIFICATE----- સહિત સંપૂર્ણ પ્રમાણપત્રનો ઉપયોગ કરી રહ્યા છો
• પ્રમાણપત્રની મુદત પૂરી થઈ નથી તે તપાસો
• ખાતરી કરો કે તમે સાઇનિંગ પ્રમાણપત્ર કૉપિ કર્યું છે, એન્ક્રિપ્શન પ્રમાણપત્ર નહીં

"Invalid signature"

• ચકાસો કે પ્રમાણપત્ર તમારા IdP ના વર્તમાન સાઇનિંગ પ્રમાણપત્ર સાથે મેળ ખાય છે
• સિગ્નેચર અલ્ગોરિધમ મેળ ખાય છે તે તપાસો (SHA-256 વિરુદ્ધ SHA-1)

"User not found" અથવા "Email mismatch"

• ખાતરી કરો કે તમારા IdP દ્વારા પરત કરાયેલ ઇમેઇલ ચકાસાયેલ ડોમેન સાથે મેળ ખાય છે
• NameID ફોર્મેટ ઇમેઇલ સરનામું પર સેટ છે તે તપાસો
• એટ્રિબ્યુટ/ક્લેમ મેપિંગ સાચું છે તે ચકાસો

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

• જ્યારે IdP ગોઠવણી ચકાસાયેલ ડોમેન સાથે મેળ ખાતી નથી ત્યારે આવું થાય છે
• ખાતરી કરો કે ઇમેઇલ ડોમેન તમારી ટીમ હેઠળ ચકાસાયેલ છે
• તમે ચકાસાયેલ ડોમેનના ઇમેઇલ સાથે લૉગ ઇન કરી રહ્યા છો તે તપાસો

ઑડિટ લૉગ્સ જોવા

સેટિંગ્સ > Single Sign-On > Audit Logs માં SSO પ્રવૃત્તિનું નિરીક્ષણ કરો. તમે આ કરી શકો છો:

• ઇવેન્ટ પ્રકાર દ્વારા ફિલ્ટર કરો (Login, Logout, Failed Login)
• તારીખ શ્રેણી દ્વારા ફિલ્ટર કરો
• અનુપાલન રિપોર્ટિંગ માટે લૉગ્સને CSV તરીકે નિકાસ કરો (Export)

મદદ જોઈએ છે?

જો તમને SSO ગોઠવણીમાં સમસ્યાઓ આવી રહી હોય, તો કૃપા કરીને અમારી સપોર્ટ ટીમનો નીચેની માહિતી સાથે સંપર્ક કરો:

• તમારી ટીમનું નામ
• તમે જે આઇડેન્ટિટી પ્રોવાઇડરનો ઉપયોગ કરી રહ્યા છો
• તમે જોઈ રહ્યા છો તે કોઈપણ ભૂલ સંદેશા
• તમારી IdP ગોઠવણીના સ્ક્રીનશૉટ્સ (સંવેદનશીલ ડેટા છુપાવીને)

તમારી સંસ્થા માટે SSO ગોઠવવામાં મદદ કરવા માટે અમે અહીં છીએ.