ን​ጉጅለኹም Single Sign-On (SSO) ኣዋዕል - (Team web app)

SSO እንታይ ይገብር

Single Sign-On ኣባላት ጉጅለኹም ብናይ ትካልኩም identity provider ከም Okta, Microsoft Entra ID (Azure AD), Google Workspace, ወይ Auth0 ኣቢሎም ኣብ ሲስተም ክኣትዉ የኽእሎም። ኣብ SSO ገጽ ትዋዕልዎ። ንገጹ ክኸፍትዎ ዝኽእሉ ወነንቲን ኣመሓደርትን ጥራይ እዮም። ኣርእስቲ ገጹ Single Sign-On (SSO) ይብል።

እቲ ገጽ ሰለስተ tabs ኣለዎ፡ Email Domains, OIDC, ከምኡውን SAML 2.0። ነቲ ሓደ OIDC ወይ SAML 2.0 ክትጥቀሙ ትኽእሉ ኢኹም፡ ክልቲኡ ብሓባር ግን ኣይከኣልን።

1 ስጉምቲ፡ ናይ ኢሜይል domain ወሲኽኩም ኣረጋግጹ

Email Domains tab ክፈቱ። SSO ዝጅምር ናይ ትካልኩም ኢሜይል domain ዘለኩም ብምርግጋጽ እዩ። ናይ domain ምረጋገጺ ንSAML ከምኡውን ንOIDC ሓደ እዩ፡ ስለዚ ሓደ ግዜ ጥራይ ክትርግጹ ኣሎኩም።

1. ኣብ ትሕቲ Add Email Domain, domain ኣእትዉ (ንኣብነት example.com) ድሕሪኡ Add Domain ጠውቑ።
2. እቲ domain Pending Verification ኮይኑ ይረኣይ። ስጉምታት ንምኽፋት How to Verify ጠውቑ።
3. ሓደ ኣገባብ ሓረዩ፡ - DNS TXT Record፡ ብዝርአ ዋጋ TXT record ናብ DNS domain ኩም ወስኹ። ለውጢ DNS ክሳብ 48 ሰዓታት ክወስድ ይኽእል። - File Upload፡ ናይ ምርግጋጽ ኮድ ዘለዎ text file ኣብ https://yourdomain/.well-known/scribblemaps-verify.txt ኣቐምጡ። እቲ file ብHTTPS ክርከብ ኣለዎ።
4. Verify Now ጠውቑ። ምስ ሰርሐ፡ እቲ ገጽ "Domain verified successfully!" ከርእይ እቲ domain ከኣ Verified ይብል።

ብDNS ወይ file ምርግጋጽ እንተዘይከኣልኩም፡ ናብ [email protected] ኢሜይል ጽሓፉ፣ እቲ ጉጅለ domain ኩም ብኢዶም ከረጋግጹልኩም ይኽእሉ።

2 ስጉምቲ (ኣማራጺ ሀ)፡ OIDC ኣዋዕሉ

OIDC tab ክፈቱ።

1. ኣብ ትሕቲ Callback URLs ዝረኣይ Redirect URI / Callback URL ቅዱ። ነቲ app ምስ ትፈጥሩ ነዚ ንidentity provider ኩም ትህብዎ።
2. ኣብ Quick Setup, ናይ provider ኩም discovery URL (እቲ .well-known/openid-configuration URL) ለጥፉ ድሕሪኡ Import ጠውቑ፣ ከምኡ እቲ Authority ከምኡውን ዓይነት provider ብኣውቶማቲክ ይመልእ።
3. ኣብ ትሕቲ Provider Settings ዘድልዩ ቦታታት መልኡ፡ - Provider Type - Client ID - Client Secret - Authority / Issuer URL
4. ሓደ ሰብ ብOIDC ንመጀመርታ ግዜ ምስ ኣተወ ናይ ተጠቃማይ ሕሳብ ዝፈጥር Just-In-Time (JIT) Provisioning ንምድማቕ User Settings ክፈቱ።
5. ቅድሚ ምእታው MFA ክረጋገጽ እንተደሊኹም Require Multi-Factor Authentication (MFA) ንምድማቕ Security Settings ክፈቱ።
6. Save Settings ድሕሪኡ Test Connection ጠውቑ። ምሉእ ምእታው ኣብ ሓድሽ መስኮት ንምፍታን Test SSO Login ክትጥቀሙ ትኽእሉ።
7. ነቲ OIDC SSO enabled ምቕያር ኣድምቁ።

ኣብ identity provider ኩም app ምስ ትፈጥሩ፡ Client Secret ስለዘድሊ Web Application ከም ዓይነት ሓረዩ (SPA ወይ Native ኣይኮነን)።

2 ስጉምቲ (ኣማራጺ ለ)፡ SAML 2.0 ኣዋዕሉ

SAML 2.0 tab ክፈቱ።

1. ንidentity provider ኩም ክትህብዎ Service Provider (SP) Information ቅዱ፡ SP Entity ID / Audience URI, Single Sign-On URL / ACS URL, ከምኡውን SP Metadata URL።
2. ኣብ Quick Setup, provider ኩም ሓረዩ ከምኡ settings ብኣውቶማቲክ ንምምላእ metadata URL ኣእትዉ።
3. Identity Provider (IdP) Settings መልኡ፡ - IdP Entity ID (Issuer) - IdP Single Sign-On URL - IdP Single Logout URL (ኣማራጺ) - IdP X.509 Certificate ብPEM ቅርጺ
4. Signature Algorithm (SHA-256 ይምከር) ከምኡውን NameID Format ንምቕማጥ Advanced Settings ክፈቱ።
5. Just-In-Time (JIT) Provisioning ንምድማቕ User Settings ክፈቱ።
6. Save Settings ድሕሪኡ Test Connection ጠውቑ። ምሉእ ምእታው ንምፍታን Test SSO Login ተጠቐሙ።
7. ነቲ SAML SSO enabled ምቕያር ኣድምቁ።

ሓደ ግዜ ሓደ protocol ጥራይ

OIDC ወይ SAML ጥራይ ክትሰርሑ ትኽእሉ፡ ክልቲኦም ኣይከኣልን። እቲ ካልእ ድሮ ክሰርሕ ከሎ ሓደ እንተኣንቀሕቅሕኩም፡ እቲ ገጽ ቅድም ነቲ ካልእ ክትዓጽዎ ትደልዩ ድኣ ኢሉ ይሓትት። ንኣብነት፡ SAML ኣብ ዝሰርሕሉ OIDC ምስ ኣንቀሓቕሕኩም "SAML is currently enabled. Would you like to disable it?" ብ Disable SAML ከምኡውን Keep Both ኣማራጺታት ይርአ።

ተጠቃሚታት SSO ርእዩ

ኣብ ታሕቲ እቲ ገጽ፡ SSO Provisioned Users card ብSSO ዝተፈጥሩ ሰባት ይዘርዝር። ዝርዝር ንምኽፋት Show ንምዕጻው ከኣ Hide ጠውቑ። እቲ ሰንጠረዥ ናይ ነፍሲ ወከፍ ተጠቃሚ Email, Name, Created date, ከምኡውን Last Login የርእይ። ሓደ እኳ ብዝዀነ ኣገባብ ክሳብ ዘይኣተወ፡ "No users have been provisioned via SSO yet." ይብል።