ነጠላ መግቢያ (SSO) ከ SAML ወይም OIDC ጋር ማዋቀር

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፦ SSO ን በ ScribbleMaps ውስጥ ያዋቅሩ
6. ደረጃ 4፦ ውቅርዎን ይሞክሩ
7. ደረጃ 5፦ SSO ን ያንቁ
8. በ SP የሚጀመር SSO
9. OIN ሁለንተናዊ መውጫ
10. አቅራቢ-ተኮር መመሪያዎች
11. የላቁ አማራጮች
12. ችግር መፍታት

የሚደገፉ ባህሪያት

የ ScribbleMaps SSO ውህደት የሚከተሉትን ባህሪያት ይደግፋል፦

ከመጀመርዎ በፊት

• SSO ን ለማዋቀር የቡድን ባለቤት መሆን አለብዎት
• የድርጅትዎ የማንነት አቅራቢ አስተዳዳሪ ኮንሶል መዳረሻ ያስፈልግዎታል
• የኢሜይል ጎራዎን ዝግጁ ያድርጉ (ለምሳሌ yourcompany.com)

ደረጃ 1፦ የኢሜይል ጎራዎን ያረጋግጡ

SSO ን ከማዋቀርዎ በፊት የኢሜይል ጎራዎን ባለቤትነት ማረጋገጥ አለብዎት። ይህ የደህንነት እርምጃ ፈቃድ ያላቸው ድርጅቶች ብቻ ለጎራዎቻቸው SSO ማዋቀር እንደሚችሉ ያረጋግጣል።

1. ወደ team.scribblemaps.com ይግቡ
2. ወደ ቅንብሮች > ነጠላ መግቢያ ይሂዱ
3. ወደ ጎራዎች ትር ይሂዱ
4. ጎራ አክል ን ጠቅ ያድርጉ እና የኢሜይል ጎራዎን ያስገቡ (ለምሳሌ yourcompany.com)
5. የማረጋገጫ ዘዴ ይምረጡ፦

አማራጭ ሀ፦ DNS TXT መዝገብ (የሚመከር)

ወደ ጎራዎ DNS ቅንብሮች የ TXT መዝገብ ያክሉ፦

ማስታወሻ፦ የ DNS ለውጦች ለመሰራጨት እስከ 48 ሰዓታት ሊወስዱ ይችላሉ።

አማራጭ ለ፦ ፋይል መስቀል

1. scribblemaps-verify.txt የሚል ስም ያለው የጽሑፍ ፋይል ይፍጠሩ
2. የማረጋገጫ ኮድዎን እንደ ብቸኛ ይዘት ያክሉ
3. ወደዚህ ይስቀሉ፦ https://yourcompany.com/.well-known/scribblemaps-verify.txt

ማረጋገጫውን ካከሉ በኋላ ባለቤትነትን ለማረጋገጥ ጎራን አረጋግጥ ን ጠቅ ያድርጉ።

ደረጃ 2፦ የማንነት አቅራቢዎን ያዋቅሩ

ScribbleMaps ን በማንነት አቅራቢዎ ውስጥ እንደ መተግበሪያ ያክሉ። Okta እየተጠቀሙ ከሆነ ScribbleMaps ን በቀጥታ ከ Okta Integration Network (OIN) ካታሎግ ማከል ይችላሉ — የ SAML SSO URL፣ SP Entity ID፣ ACS URL እና OIDC Redirect URI በራስ-ሰር አስቀድመው ተዋቅረዋል።

ለ SAML 2.0

ለ OIDC

ደረጃ 3፦ SSO ን በ ScribbleMaps ውስጥ ያዋቅሩ

SAML 2.0 ን ማዋቀር

1. በ ScribbleMaps ውስጥ ወደ ቅንብሮች > ነጠላ መግቢያ > SAML ትር ይሂዱ
2. ከማንነት አቅራቢዎ የሚከተለውን መረጃ ያስገቡ፦

3. ቅንብሮችን አስቀምጥ ን ጠቅ ያድርጉ

OIDC ን ማዋቀር

1. በ ScribbleMaps ውስጥ ወደ ቅንብሮች > ነጠላ መግቢያ > OIDC ትር ይሂዱ
2. የአቅራቢ ዓይነት ይምረጡ (Google፣ Microsoft፣ Okta፣ Auth0 ወይም ብጁ)
3. የሚከተለውን መረጃ ያስገቡ፦

4. ቅንብሮችን አስቀምጥ ን ጠቅ ያድርጉ

ደረጃ 4፦ ውቅርዎን ይሞክሩ

SSO ን ለሁሉም ተጠቃሚዎች ከማንቃትዎ በፊት ውቅርዎን ይሞክሩ፦

1. ግንኙነትን ሞክር የሚለውን አዝራር ጠቅ ያድርጉ
2. የ SSO መግቢያ ሂደቱን ለመምሰል አዲስ መስኮት ይከፈታል
3. ከማንነት አቅራቢዎ ጋር ማረጋገጫውን ያጠናቅቁ
4. በተሳካ ሁኔታ ወደ ScribbleMaps መመለስዎን ያረጋግጡ

ሙከራው ካልተሳካ የስህተት መልዕክቱን ይመልከቱ እና የውቅር ቅንብሮችዎን ይፈትሹ።

ደረጃ 5፦ SSO ን ያንቁ

ሙከራው ከተሳካ በኋላ፦

1. SSO ን አንቃ የሚለውን ማብሪያ ወደ ON ያድርጉ
2. የማስፈጸሚያ አማራጭዎን ይምረጡ፦
   • አማራጭ፦ ተጠቃሚዎች SSO ወይም የይለፍ ቃል መግቢያ መምረጥ ይችላሉ
   • የግዴታ፦ የተረጋገጠ የኢሜይል ጎራ ያላቸው ተጠቃሚዎች SSO ን መጠቀም አለባቸው (የይለፍ ቃል መግቢያ ተሰናክሏል)

ማስታወሻ፦ SSO የግዴታ ቢሆንም የቡድን ባለቤቶች እንደ ምትኬ ሁልጊዜ የይለፍ ቃል መግቢያን መጠቀም ይችላሉ።

በ SP የሚጀመር SSO

ScribbleMaps በ SP የሚጀመር SSO ን ይደግፋል፣ ይህም ተጠቃሚዎች የመግቢያ ሂደቱን ከ ScribbleMaps የመግቢያ ገጽ እንዲጀምሩ ያስችላቸዋል። የሚሰራው እንደሚከተለው ነው፦

1. ወደ scribblemaps.com/account/login ይሂዱ
2. የኢሜይል አድራሻዎን ያስገቡ (ለምሳሌ [email protected])
3. በ 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. ከ Settings ትር Client ID እና Client Secret ን ይቅዱ
5. Authority URL፦ https://YOUR-DOMAIN.auth0.com

የላቁ አማራጮች

Just-In-Time (JIT) ማቅረብ

ሲነቃ ተጠቃሚዎች በመጀመሪያው የ SSO መግቢያቸው ላይ በ ScribbleMaps ውስጥ በራስ-ሰር ይፈጠራሉ። የመገለጫ መረጃቸው (ስም፣ ኢሜይል) ከማንነት አቅራቢው ይሞላል።

ባለብዙ-ደረጃ ማረጋገጫ ያስፈልግ (OIDC ብቻ)

መግባትን ከመፍቀዱ በፊት MFA ማረጋገጫ እንዲያስፈልግ ይህን አማራጭ ያንቁ። ScribbleMaps የእርስዎ IdP ለተጠቃሚው MFA ን እንዳስፈጸመ ያረጋግጣል።

ለ Okta እንደሚከተሉት ያሉ ብጁ የ ACR ዋጋዎችን መጥቀስ ይችላሉ፦

• urn:okta:loa:2fa:any - ማንኛውም ሁለተኛ ምክንያት
• phr - ማስገርን የሚቋቋም ማረጋገጫ
• phrh - ማስገርን የሚቋቋም ከሃርድዌር ጋር የተሳሰረ ማረጋገጫ

የባህሪ/Claim ካርታ

ከ IdP ዎ የሚመጡ የተጠቃሚ ባህሪያት ከ ScribbleMaps የተጠቃሚ መስኮች ጋር እንዴት እንደሚዛመዱ ያበጁ፦

ችግር መፍታት

የተለመዱ ችግሮች

"ጎራው አልተረጋገጠም"

• የ DNS TXT መዝገብዎ ወይም የማረጋገጫ ፋይልዎ በትክክል መዋቀሩን ያረጋግጡ
• የ DNS ለውጦች ለመሰራጨት እስከ 48 ሰዓታት ሊወስዱ ይችላሉ
• በማረጋገጫ ኮዱ ውስጥ የትየባ ስህተቶች አለመኖራቸውን ያረጋግጡ

"ልክ ያልሆነ የምስክር ወረቀት"

• -----BEGIN CERTIFICATE----- እና -----END CERTIFICATE----- ን ጨምሮ ሙሉውን የምስክር ወረቀት እየተጠቀሙ መሆንዎን ያረጋግጡ
• የምስክር ወረቀቱ ጊዜው እንዳላለፈ ይፈትሹ
• የምስጠራ የምስክር ወረቀት ሳይሆን የፊርማ የምስክር ወረቀቱን መቅዳትዎን ያረጋግጡ

"ልክ ያልሆነ ፊርማ"

• የምስክር ወረቀቱ ከ IdP ዎ ወቅታዊ የፊርማ የምስክር ወረቀት ጋር እንደሚዛመድ ያረጋግጡ
• የፊርማ ስልተ ቀመሩ እንደሚዛመድ ይፈትሹ (SHA-256 ወይም SHA-1)

"ተጠቃሚ አልተገኘም" ወይም "የኢሜይል አለመመሳሰል"

• በ IdP ዎ የተመለሰው ኢሜይል ከተረጋገጠ ጎራ ጋር እንደሚዛመድ ያረጋግጡ
• የ NameID ቅርጸት ወደ የኢሜይል አድራሻ መዋቀሩን ይፈትሹ
• የባህሪ/claim ካርታው ትክክል መሆኑን ያረጋግጡ

"የደህንነት ስህተት፦ የማንነት አቅራቢዎ ለዚህ የኢሜይል ጎራ ፈቃድ የለውም"

• ይህ የሚከሰተው የ IdP ውቅር ከተረጋገጠው ጎራ ጋር ሳይዛመድ ሲቀር ነው
• የኢሜይል ጎራው በቡድንዎ ስር መረጋገጡን ያረጋግጡ
• ከተረጋገጠ ጎራ በሆነ ኢሜይል እየገቡ መሆንዎን ይፈትሹ

የኦዲት መዝገቦችን መመልከት

የ SSO እንቅስቃሴን በ ቅንብሮች > ነጠላ መግቢያ > የኦዲት መዝገቦች ውስጥ ይከታተሉ። የሚከተሉትን ማድረግ ይችላሉ፦

• በክስተት ዓይነት ማጣራት (መግቢያ፣ መውጫ፣ ያልተሳካ መግቢያ)
• በቀን ክልል ማጣራት
• ለተገዢነት ሪፖርት ማድረግ መዝገቦችን እንደ CSV ወደ ውጭ መላክ

እገዛ ይፈልጋሉ?

በ SSO ውቅር ላይ ችግር እያጋጠመዎት ከሆነ እባክዎ የድጋፍ ቡድናችንን በሚከተለው መረጃ ያግኙ፦

• የቡድንዎ ስም
• የሚጠቀሙበት የማንነት አቅራቢ
• እያዩዋቸው ያሉ ማንኛውም የስህተት መልዕክቶች
• የ IdP ውቅርዎ ቅጽበታዊ ገጽ እይታዎች (ሚስጥራዊ መረጃ ተደብቆ)

ለድርጅትዎ SSO እንዲዋቀር ልንረዳዎ እዚህ ነን።