Single Sign-On (SSO) ብSAML ወይ OIDC ምውቃር

ScribbleMaps ንኢንተርፕራይዝ Single Sign-On ብSAML 2.0 ወይ OpenID Connect (OIDC) ይድግፍ። እዚ ኣባላት ጉጅለኻ ብመለለዪ ኣቅራቢ (Identity Provider - IdP) ትካልካ ከም Okta፣ Microsoft Entra ID (Azure AD)፣ Google Workspace፣ ወይ Auth0 ተጠቒሞም ከረጋግጹ የኽእሎም።

ምውቃር SSO ኣብ team.scribblemaps.com ይርከብ እዩ፣ ምሉእ ብምሉእ ሓራውን እዩ።

ትሕዝቶ

1. ዝድገፉ ፀጉራት
2. ቅድሚ ምጅማርካ
3. ስጉምቲ 1: ዶሜን ኢሜይልካ የረጋግጽ
4. ስጉምቲ 2: Identity Provider ኣዋቕር
5. ስጉምቲ 3: SSO ኣብ ScribbleMaps ኣዋቕር
6. ስጉምቲ 4: ዝወቀርካዮ ፈትን
7. ስጉምቲ 5: SSO የንቕሕ
8. SP-Initiated SSO
9. OIN Universal Logout
10. መምርሒታት ንነፍሲ ወከፍ ኣቅራቢ
11. ዝዓበየ ኣማራጺታት
12. ጸገማት ምፍታሕ

ዝድገፉ ፀጉራት

ናይ ScribbleMaps SSO ምስሕሓብ እዞም ዝስዕቡ ፀጉራት ይድግፍ:

ቅድሚ ምጅማርካ

• SSO ንምውቃር Team Owner ክትከውን ኣለካ
• ናብ ኣድሚን ኮንሶል Identity Provider ትካልካ ምእታው የድልየካ
• ዶሜን ኢሜይልካ ድሉው ይሃሉ (ንኣብነት፣ yourcompany.com)

ስጉምቲ 1: ዶሜን ኢሜይልካ የረጋግጽ

SSO ቅድሚ ምውቃርካ፣ ወናኒ ዶሜን ኢሜይልካ ምዃንካ የረጋግጽ። እዚ ናይ ድሕነት ስጉምቲ ንዶሜናቶም SSO ክዉቅሩ ዝኽእሉ ዝተፈቐደሎም ትካላት ጥራይ ምዃኖም የረጋግጽ።

1. ናብ team.scribblemaps.com እቶ
2. ናብ Settings > Single Sign-On ኪድ
3. ናብ Domains ታብ ኪድ
4. Add Domain ጠውቕን ዶሜን ኢሜይልካ ኣእቱ (ንኣብነት፣ yourcompany.com)
5. ኣገባብ ምርግጋጽ ምረጽ:

ኣማራጺ A: DNS TXT Record (ዝምከር)

ናብ ቅጥዕታት DNS ዶሜንካ TXT record ወስኽ:

ማሳሰቢ: ለውጥታት DNS ክሳብ 48 ሰዓታት ክወስድ ይኽእል።

ኣማራጺ B: ፋይል ምጽዓን

1. scribblemaps-verify.txt ዝብል ስም ዘለዎ ጽሑፍ ፋይል ፍጠር
2. ኮድ ምርግጋጽካ ከም ሓደ ጥራይ ትሕዝቶ ወስኽ
3. ናብዚ ጽዓን: https://yourcompany.com/.well-known/scribblemaps-verify.txt

ምርግጋጽ ምስ ወሰኽካ፣ ወናኒነት ንምርግጋጽ Verify Domain ጠውቕ።

ስጉምቲ 2: Identity Provider ኣዋቕር

ScribbleMaps ከም ኣፕሊኬሽን ናብ Identity Provider ትካልካ ወስኽ። 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፣ ናብ Settings > Single Sign-On > SAML ታብ ኪድ
2. እዞም ዝስዕቡ ሓበሬታታት ካብ Identity Provider ኣእቱ:

3. Save Settings ጠውቕ

OIDC ምውቃር

1. ኣብ ScribbleMaps፣ ናብ Settings > Single Sign-On > OIDC ታብ ኪድ
2. Provider Type ምረጽ (Google፣ Microsoft፣ Okta፣ Auth0፣ ወይ Custom)
3. እዞም ዝስዕቡ ሓበሬታታት ኣእቱ:

4. Save Settings ጠውቕ

ስጉምቲ 4: ዝወቀርካዮ ፈትን

SSO ንኩሎም ተጠቀምቲ ቅድሚ ምንቃሕካ፣ ዝወቀርካዮ ፈትን:

1. Test Connection መጠወቒ ጠውቕ
2. ሂደት SSO መእተዊ ንምምስላል ሓዲሽ መስኮት ይኽፈት
3. ምስ Identity Provider ኣረጋግጽ
4. ብዓወት ናብ ScribbleMaps ከም ዝተመለስካ ኣረጋግጽ

እቲ ፈተነ እንተፈሽለ፣ መልእኽቲ ጌጋ ተመልከት ከምኡውን ቅጥዕታት ምውቃርካ ፈትሽ።

ስጉምቲ 5: SSO የንቕሕ

ፈተነ ምስ ተዓወተ:

1. መቐያየሪ Enable SSO ናብ ON ቀይር
2. ኣማራጺ ምትግባር ምረጽ:
   • Optional: ተጠቀምቲ SSO ወይ መእተዊ ብመሕለፊ ቃል ክመርጹ ይኽእሉ
   • Enforced: ተጠቀምቲ ብዝተረጋገጸ ዶሜን ኢሜይል SSO ክጥቀሙ ኣለዎም (መእተዊ ብመሕለፊ ቃል ዝተኸልከለ)

ማሳሰቢ: Team Owners SSO እኳ እንተተገብረ ከም መመላእታ ብመሕለፊ ቃል ክኣትዉ ይኽእሉ።

SP-Initiated SSO

ScribbleMaps SP-initiated SSO ይድግፍ፣ እዚ ተጠቀምቲ ሂደት መእተዊ ካብ ገጽ መእተዊ ScribbleMaps ክጅምሩ የኽእሎም። ከመይ ከም ዝሰርሕ:

1. ናብ scribblemaps.com/account/login ኪድ
2. ኣድራሻ ኢሜይልካ ኣእቱ (ንኣብነት፣ [email protected])
3. Sign in with SSO ጠውቕ
4. ንምርግጋጽ ናብ Identity Provider ትካልካ (ንኣብነት፣ Okta) ትመርሕ
5. ብዓወት ምስ ተረጋገጸ፣ ብኣውቶማቲክ ናብ ScribbleMaps ተመሊስካ ትኣትዉ

ትካልካ SSO እንተኣተግቢሩ፣ ኢሜይልካ ኣብ ገጽ መእተዊ ምእታውካ ብኣውቶማቲክ ናብ Identity Provider ይመርሕካ — ሜዳ መሕለፊ ቃል ኣይክርአን እዩ።

OIN Universal Logout

Universal logout ብ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. እዘን ዕቤታት ናብ ቅጥዕታት SSO ScribbleMaps ኣእቱ (ስጉምቲ 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 ካብ Settings ታብ ቀድሕ
5. Authority URL: https://YOUR-DOMAIN.auth0.com

ዝዓበየ ኣማራጺታት

Just-In-Time (JIT) Provisioning

ምስ ተንቀሐ፣ ተጠቀምቲ ብኣውቶማቲክ ኣብ ናይ መጀመርታ SSO መእተዊኦም ኣብ ScribbleMaps ይፍጠሩ። ሓበሬታ መገለጺኦም (ስም፣ ኢሜይል) ካብ Identity Provider ይምላእ።

Multi-Factor Authentication ምጽባይ (OIDC ጥራይ)

መእተዊ ቅድሚ ምፍቃድ ምርግጋጽ MFA ንምጽባይ እዚ ኣማራጺ የንቕሕ። ScribbleMaps IdP ካልእ ንተጠቃሚ MFA ከም ዘተግበሮ ከረጋግጽ እዩ።

ንOkta፣ ከም እዚ ዝስዕቡ ዝተፈላለዩ ዕቤታት ACR ክትገልጽ ትኽእል:

• urn:okta:loa:2fa:any - ዝኾነ ካልኣይ ረቋሒ
• phr - ንፊሺንግ ዝጻወር ምርግጋጽ
• phrh - ንፊሺንግ ዝጻወር ብሃርድዌር ዝተቐረነ ምርግጋጽ

Attribute/Claim Mapping

ኣወዳድባ ባህርያት ተጠቃሚ ካብ IdP ናብ ሜዳታት ተጠቃሚ ScribbleMaps ከመይ ከም ዝተመደበ ኣብጽሕ:

ጸገማት ምፍታሕ

ልሙዳት ጸገማት

"Domain not verified"

• DNS TXT record ወይ ፋይል ምርግጋጽካ ብቕዓት ከምዝተዋቀረ ኣረጋግጽ
• ለውጥታት DNS ክሳብ 48 ሰዓታት ክወስድ ይኽእል
• ኣብ ኮድ ምርግጋጽ ጌጋታት ፊደላት ከምዘየለዉ ኣረጋግጽ

"Invalid certificate"

• -----BEGIN CERTIFICATE----- ከምኡውን -----END CERTIFICATE----- ዘጠቓለለ ምሉእ ሰርቲፊኬት ትጥቀም ከምዘለኻ ኣረጋግጽ
• እቲ ሰርቲፊኬት ከምዘይወድአ ፈትሽ
• ሰርቲፊኬት ምፍራም ከም ዝቐደሕካ እምበር ሰርቲፊኬት ምስጢራዊነት ከምዘይኮነ ኣረጋግጽ

"Invalid signature"

• እቲ ሰርቲፊኬት ምስ ናይ IdP ሕጂ ዘሎ ሰርቲፊኬት ምፍራም ከምዝሰማማዕ ኣረጋግጽ
• ኣልጎሪዝም ፊርማ ከምዝሰማማዕ ፈትሽ (SHA-256 ንፍጹም SHA-1)

"User not found" ወይ "Email mismatch"

• እቲ ብIdP ዝመለሰ ኢሜይል ምስ ዝተረጋገጸ ዶሜን ከምዝሰማማዕ ኣረጋግጽ
• ቅርጺ NameID ናብ Email Address ከምዝተቐመጠ ፈትሽ
• ኣወዳድባ attribute/claim ትኽክል ምዃኑ ኣረጋግጽ

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

• እዚ ምውቃር IdP ምስ ዝተረጋገጸ ዶሜን ምስ ዘይሰማማዕ ይፍጠር
• ዶሜን ኢሜይል ኣብ ትሕቲ ጉጅለኻ ከምዝተረጋገጸ ኣረጋግጽ
• ካብ ዝተረጋገጸ ዶሜን ብዝኾነ ኢሜይል ከምትኣቱ ፈትሽ

Audit Logs ምርኣይ

ንንጥፈታት SSO ኣብ Settings > Single Sign-On > Audit Logs ተኸታተሎ። ክትገብር ትኽእል:

• ብዓይነት ኩነት ምጽራይ (Login፣ Logout፣ Failed Login)
• ብወሰን ዕለት ምጽራይ
• ንጸብጻብ ምስምማዕ ሎጋት ከም CSV ምውጻእ

ሓገዝ የድልየካ?

ኣብ ምውቃር SSO ጸገማት እንተሎዎ፣ በጃኻ ምስ ጉጅለ ደገፍና ርከብ ምስዚ ዝስዕብ:

• ስም ጉጅለኻ
• ትጥቀሞ Identity Provider
• ዝርእይዎም መልእኽታት ጌጋ
• ስክሪንሾታት ምውቃር IdP ካልእ (ሓበሬታ ሓሲሱ ዝተሸፈነ)

SSO ንትካልካ ንምውቃር ንሕግዝ ኣብዚ ኣለና።