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. အဆင့် ၁။ သင့်အီးမေးလ် ဒိုမိန်းကို အတည်ပြုပါ
4. အဆင့် ၂။ သင့် Identity Provider ကို ပြင်ဆင်သတ်မှတ်ပါ
5. အဆင့် ၃။ ScribbleMaps တွင် SSO ကို ပြင်ဆင်သတ်မှတ်ပါ
6. အဆင့် ၄။ သင့်ပြင်ဆင်သတ်မှတ်မှုကို စမ်းသပ်ပါ
7. အဆင့် ၅။ SSO ကို ဖွင့်ပါ
8. SP-Initiated SSO
9. OIN Universal Logout
10. ပံ့ပိုးသူအလိုက် လမ်းညွှန်ချက်များ
11. အဆင့်မြင့် ရွေးချယ်စရာများ
12. ပြဿနာဖြေရှင်းခြင်း

ပံ့ပိုးထားသော အင်္ဂါရပ်များ

ScribbleMaps SSO ပေါင်းစပ်မှုသည် အောက်ပါအင်္ဂါရပ်များကို ပံ့ပိုးပါသည်။

မစတင်မီ

• SSO ကို ပြင်ဆင်သတ်မှတ်ရန် သင်သည် Team Owner ဖြစ်ရမည်
• သင့်အဖွဲ့အစည်း၏ Identity Provider စီမံခန့်ခွဲသူ ကွန်ဆိုးလ်သို့ ဝင်ရောက်ခွင့် လိုအပ်ပါသည်
• သင့်အီးမေးလ် ဒိုမိန်းကို အဆင်သင့်ထားပါ (ဥပမာ - yourcompany.com)

အဆင့် ၁။ သင့်အီးမေးလ် ဒိုမိန်းကို အတည်ပြုပါ

SSO ကို မပြင်ဆင်သတ်မှတ်မီ သင့်အီးမေးလ် ဒိုမိန်း၏ ပိုင်ဆိုင်မှုကို အတည်ပြုရပါမည်။ ဤလုံခြုံရေးအစီအမံသည် ခွင့်ပြုထားသော အဖွဲ့အစည်းများသာ ၎င်းတို့၏ ဒိုမိန်းများအတွက် SSO ကို ပြင်ဆင်သတ်မှတ်နိုင်စေရန် သေချာစေပါသည်။

1. team.scribblemaps.com သို့ အကောင့်ဝင်ရန်
2. ဆက်တင်များ > Single Sign-On သို့ သွားပါ
3. Domains တက်ဘ်သို့ သွားပါ
4. ဒိုမိန်းထည့်ရန် ကို နှိပ်ရန် ပြီး သင့်အီးမေးလ် ဒိုမိန်းကို ထည့်သွင်းပါ (ဥပမာ - yourcompany.com)
5. အတည်ပြုနည်းလမ်းတစ်ခုကို ရွေးချယ်ပါ -

ရွေးချယ်စရာ A - DNS TXT Record (အကြံပြုထားသည်)

သင့်ဒိုမိန်း၏ DNS ဆက်တင်များတွင် TXT record တစ်ခု ထည့်ပါ -

မှတ်စု - DNS ပြောင်းလဲမှုများ ပျံ့နှံ့ရန် ၄၈ နာရီအထိ ကြာနိုင်ပါသည်။

ရွေးချယ်စရာ B - ဖိုင်အပ်လုဒ်တင်ခြင်း

1. scribblemaps-verify.txt အမည်ရှိ စာသားဖိုင်တစ်ခု ဖန်တီးပါ
2. သင့်အတည်ပြုကုဒ်ကို တစ်ခုတည်းသော အကြောင်းအရာအဖြစ် ထည့်ပါ
3. ဤလိပ်စာသို့ အပ်လုဒ်တင်ပါ - https://yourcompany.com/.well-known/scribblemaps-verify.txt

အတည်ပြုချက်ကို ထည့်ပြီးနောက် ပိုင်ဆိုင်မှုကို အတည်ပြုရန် ဒိုမိန်းကို အတည်ပြုရန် ကို နှိပ်ရန် ပါ။

အဆင့် ၂။ သင့် 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 အတွက်

အဆင့် ၃။ ScribbleMaps တွင် SSO ကို ပြင်ဆင်သတ်မှတ်ပါ

SAML 2.0 ကို ပြင်ဆင်သတ်မှတ်ခြင်း

1. ScribbleMaps တွင် ဆက်တင်များ > Single Sign-On > SAML တက်ဘ်သို့ သွားပါ
2. သင့် Identity Provider မှ အောက်ပါအချက်အလက်များကို ထည့်သွင်းပါ -

3. ဆက်တင်များ သိမ်းဆည်းရန် ကို နှိပ်ရန် ပါ

OIDC ကို ပြင်ဆင်သတ်မှတ်ခြင်း

1. ScribbleMaps တွင် ဆက်တင်များ > Single Sign-On > OIDC တက်ဘ်သို့ သွားပါ
2. သင့် Provider Type ကို ရွေးချယ်ပါ (Google၊ Microsoft၊ Okta၊ Auth0 သို့မဟုတ် စိတ်ကြိုက်)
3. အောက်ပါအချက်အလက်များကို ထည့်သွင်းပါ -

4. ဆက်တင်များ သိမ်းဆည်းရန် ကို နှိပ်ရန် ပါ

အဆင့် ၄။ သင့်ပြင်ဆင်သတ်မှတ်မှုကို စမ်းသပ်ပါ

အသုံးပြုသူအားလုံးအတွက် SSO ကို မဖွင့်မီ သင့်ပြင်ဆင်သတ်မှတ်မှုကို စမ်းသပ်ပါ -

1. Test Connection ခလုတ်ကို နှိပ်ရန် ပါ
2. SSO လော့ဂ်အင်လုပ်ငန်းစဉ်ကို ပုံဖော်စမ်းသပ်ရန် ဝင်းဒိုးအသစ်တစ်ခု ပွင့်လာပါမည်
3. သင့် Identity Provider ဖြင့် အတည်ပြုခြင်းကို ပြီးစီးအောင် လုပ်ဆောင်ပါ
4. ScribbleMaps သို့ အောင်မြင်စွာ ပြန်လည်ညွှန်းပို့ခံရကြောင်း စစ်ဆေးပါ

စမ်းသပ်မှု မအောင်မြင်ပါက အမှားသတင်းစကားကို ပြန်လည်သုံးသပ်ပြီး သင့်ပြင်ဆင်သတ်မှတ်မှု ဆက်တင်များကို စစ်ဆေးပါ။

အဆင့် ၅။ SSO ကို ဖွင့်ပါ

စမ်းသပ်မှု အောင်မြင်ပြီးသည်နှင့် -

1. Enable SSO ခလုတ်ကို ON သို့ ပြောင်းပါ
2. သင့်ပြဋ္ဌာန်းမှု ရွေးချယ်စရာကို ရွေးပါ -
   • Optional - အသုံးပြုသူများသည် SSO သို့မဟုတ် စကားဝှက်ဖြင့် လော့ဂ်အင်ဝင်ခြင်းကို ရွေးချယ်နိုင်သည်
   • Enforced - အတည်ပြုပြီးသော အီးမေးလ်ဒိုမိန်းရှိ အသုံးပြုသူများသည် SSO ကို အသုံးပြုရမည် (စကားဝှက်ဖြင့် လော့ဂ်အင်ဝင်ခြင်းကို ပိတ်ထားသည်)

မှတ်စု - SSO ကို ပြဋ္ဌာန်းထားသည့်အခါတွင်ပင် Team Owner များသည် အရန်အဖြစ် စကားဝှက်ဖြင့် လော့ဂ်အင်ဝင်နိုင်ပါသည်။

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 ဆက်တင်များတွင် ထည့်သွင်းပါ (အဆင့် ၃ ကို ကြည့်ပါ)

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 - Phishing ကို ခံနိုင်ရည်ရှိသော အတည်ပြုမှု
• phrh - Phishing ကို ခံနိုင်ရည်ရှိသော ဟာ့ဒ်ဝဲနှင့် ချိတ်ဆက်ထားသော အတည်ပြုမှု

ဂုဏ်သတ္တိ/Claim ချိတ်ဆက်သတ်မှတ်ခြင်း

သင့် IdP မှ အသုံးပြုသူဂုဏ်သတ္တိများသည် ScribbleMaps အသုံးပြုသူအကွက်များသို့ မည်သို့ ချိတ်ဆက်ရမည်ကို စိတ်ကြိုက်ပြင်ဆင်ပါ -

ပြဿနာဖြေရှင်းခြင်း

အသုံးများသော ပြဿနာများ

"Domain not verified"

• သင့် DNS TXT record သို့မဟုတ် အတည်ပြုဖိုင်ကို မှန်ကန်စွာ ပြင်ဆင်သတ်မှတ်ထားကြောင်း သေချာပါစေ
• DNS ပြောင်းလဲမှုများ ပျံ့နှံ့ရန် ၄၈ နာရီအထိ ကြာနိုင်ပါသည်
• အတည်ပြုကုဒ်တွင် စာလုံးပေါင်းအမှားမရှိကြောင်း စစ်ဆေးပါ

"Invalid certificate"

• -----BEGIN CERTIFICATE----- နှင့် -----END CERTIFICATE----- အပါအဝင် လက်မှတ်အပြည့်အစုံကို အသုံးပြုနေကြောင်း သေချာပါစေ
• လက်မှတ်သက်တမ်း မကုန်ဆုံးသေးကြောင်း စစ်ဆေးပါ
• ကူးယူခဲ့သည်မှာ လက်မှတ်ထိုးလက်မှတ် ဖြစ်ပြီး ကုဒ်ဝှက်လက်မှတ် မဟုတ်ကြောင်း သေချာပါစေ

"Invalid signature"

• လက်မှတ်သည် သင့် IdP ၏ လက်ရှိ လက်မှတ်ထိုးလက်မှတ်နှင့် ကိုက်ညီကြောင်း စစ်ဆေးပါ
• လက်မှတ်ထိုး အယ်လဂိုရီသမ် ကိုက်ညီကြောင်း စစ်ဆေးပါ (SHA-256 နှင့် SHA-1)

"User not found" သို့မဟုတ် "Email mismatch"

• သင့် IdP မှ ပြန်ပို့သော အီးမေးလ်သည် အတည်ပြုပြီးသော ဒိုမိန်းနှင့် ကိုက်ညီကြောင်း သေချာပါစေ
• NameID ဖော်မတ်ကို အီးမေးလ်လိပ်စာအဖြစ် သတ်မှတ်ထားကြောင်း စစ်ဆေးပါ
• ဂုဏ်သတ္တိ/claim ချိတ်ဆက်သတ်မှတ်မှု မှန်ကန်ကြောင်း စစ်ဆေးပါ

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

• ဤအမှားသည် IdP ပြင်ဆင်သတ်မှတ်မှုသည် အတည်ပြုပြီးသော ဒိုမိန်းနှင့် မကိုက်ညီသည့်အခါ ဖြစ်ပေါ်ပါသည်
• အီးမေးလ်ဒိုမိန်းကို သင့်အသင်းအောက်တွင် အတည်ပြုထားကြောင်း သေချာပါစေ
• အတည်ပြုပြီးသော ဒိုမိန်းမှ အီးမေးလ်ဖြင့် လော့ဂ်အင်ဝင်နေကြောင်း စစ်ဆေးပါ

Audit Logs ကို ကြည့်ရှုခြင်း

SSO လှုပ်ရှားမှုကို ဆက်တင်များ > Single Sign-On > Audit Logs တွင် စောင့်ကြည့်နိုင်ပါသည်။ သင်သည် -

• ဖြစ်ရပ်အမျိုးအစားအလိုက် စစ်ထုတ်ရန် နိုင်သည် (Login၊ Logout၊ Failed Login)
• ရက်စွဲအပိုင်းအခြားအလိုက် စစ်ထုတ်ရန် နိုင်သည်
• လိုက်နာမှုအစီရင်ခံခြင်းအတွက် မှတ်တမ်းများကို CSV အဖြစ် ထုတ်ယူရန် နိုင်သည်

အကူအညီ လိုအပ်ပါသလား။

SSO ပြင်ဆင်သတ်မှတ်ရာတွင် ပြဿနာများ ကြုံနေရပါက အောက်ပါအချက်များနှင့်အတူ ကျွန်ုပ်တို့၏ ပံ့ပိုးကူညီရေးအဖွဲ့သို့ ဆက်သွယ်ပါ -

• သင့်အသင်း၏ အမည်
• သင်အသုံးပြုနေသော Identity Provider
• သင်တွေ့နေရသော အမှားသတင်းစကားများ
• သင့် IdP ပြင်ဆင်သတ်မှတ်မှု၏ ဖန်သားပြင်ဓာတ်ပုံများ (အရေးကြီးသော အချက်အလက်များကို ဖုံးကွယ်ထားပြီး)

သင့်အဖွဲ့အစည်းအတွက် SSO ကို ပြင်ဆင်သတ်မှတ်ရာတွင် ကျွန်ုပ်တို့ ကူညီရန် အဆင်သင့်ရှိပါသည်။