SAML හෝ OIDC සමඟ Single Sign-On (SSO) වින්‍යාස කිරීම

ScribbleMaps, SAML 2.0 හෝ OpenID Connect (OIDC) භාවිතයෙන් ව්‍යවසාය Single Sign-On සඳහා සහාය දක්වයි. මෙමගින් ඔබේ කණ්ඩායම් සාමාජිකයින්ට Okta, Microsoft Entra ID (Azure AD), Google Workspace, හෝ Auth0 වැනි ඔබේ සංවිධානයේ Identity Provider (IdP) භාවිතයෙන් සත්‍යාපනය කිරීමට හැකිය.

SSO වින්‍යාසය team.scribblemaps.com හි ලබා ගත හැකි අතර සම්පූර්ණයෙන්ම නොමිලේ වේ.

පටුන

1. සහාය දක්වන විශේෂාංග
2. ආරම්භ කිරීමට පෙර
3. 1 වන පියවර: ඔබේ ඊමේල් ඩොමේනය සත්‍යාපනය කරන්න
4. 2 වන පියවර: ඔබේ Identity Provider වින්‍යාස කරන්න
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 කෙනෙකු විය යුතුය
• ඔබේ සංවිධානයේ 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 වින්‍යාස කරන්න

ඔබේ Identity Provider හි 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 හි 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 භාවිතා කළ යුතුය (මුරපද පිවිසුම අබල කෙරේ)

සටහන: SSO බලාත්මක කර ඇති විට පවා, Team Owners ට උපස්ථයක් ලෙස මුරපද පිවිසුම සැමවිටම භාවිතා කළ හැකිය.

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

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 (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) Provisioning

සක්‍රීය කර ඇති විට, පරිශීලකයින් ඔවුන්ගේ පළමු SSO පිවිසුමේදී ScribbleMaps හි ස්වයංක්‍රීයව සාදනු ලැබේ. ඔවුන්ගේ පැතිකඩ තොරතුරු (නම, ඊමේල්) Identity Provider වෙතින් පුරවනු ලැබේ.

Multi-Factor Authentication අවශ්‍ය කරන්න (OIDC පමණි)

පිවිසීමට ඉඩ දීමට පෙර MFA සත්‍යාපනය අවශ්‍ය කිරීමට මෙම විකල්පය සක්‍රීය කරන්න. ඔබේ IdP විසින් පරිශීලකයා සඳහා MFA බලාත්මක කර ඇති බව ScribbleMaps සත්‍යාපනය කරනු ඇත.

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 vs SHA-1)

"User not found" හෝ "Email mismatch"

• ඔබේ IdP මගින් ලැබෙන ඊමේල් සත්‍යාපිත ඩොමේනයකට ගැළපෙන බවට වග බලා ගන්න
• NameID ආකෘතිය Email Address ලෙස සකසා ඇති බව පරීක්ෂා කරන්න
• ගුණාංග/claim සිතියම්ගත කිරීම නිවැරදි බව තහවුරු කරන්න

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

• IdP වින්‍යාසය සත්‍යාපිත ඩොමේනයට නොගැළපෙන විට මෙය සිදු වේ
• ඊමේල් ඩොමේනය ඔබේ කණ්ඩායම යටතේ සත්‍යාපනය කර ඇති බවට වග බලා ගන්න
• ඔබ සත්‍යාපිත ඩොමේනයකින් ඊමේලයක් සමඟ පිවිසෙන බව පරීක්ෂා කරන්න

විගණන ලොග් බැලීම

Settings > Single Sign-On > Audit Logs හි SSO ක්‍රියාකාරකම් නිරීක්ෂණය කරන්න. ඔබට:

• සිදුවීම් වර්ගය අනුව පෙරන්න (Login, Logout, Failed Login)
• දිනයන් පරාසය අනුව පෙරන්න
• අනුකූලතා වාර්තාකරණය සඳහා ලොග් CSV ලෙස අපනයනය කරන්න

උදව් අවශ්‍යද?

ඔබට SSO වින්‍යාසයේදී ගැටළු ඇති වුවහොත්, කරුණාකර පහත තොරතුරු සමඟ අපගේ සහාය කණ්ඩායම අමතන්න:

• ඔබේ Team නම
• ඔබ භාවිතා කරන Identity Provider
• ඔබට පෙනෙන ඕනෑම දෝෂ පණිවිඩ
• ඔබේ IdP වින්‍යාසයේ තිර රූ (සංවේදී දත්ත සැඟවූ)

ඔබේ සංවිධානය සඳහා SSO වින්‍යාස කරගැනීමට උදව් කිරීමට අපි සූදානම්.