SCIM အသုံးပြုသူ ပံ့ပိုးပေးခြင်းကို ပြင်ဆင်သတ်မှတ်ခြင်း

ScribbleMaps သည် အလိုအလျောက် အသုံးပြုသူ ပံ့ပိုးပေးခြင်းနှင့် ရုပ်သိမ်းခြင်းအတွက် SCIM 2.0 (System for Cross-domain Identity Management) ကို ပံ့ပိုးပေးပါသည်။ ၎င်းသည် သင်၏ Identity Provider (IdP) မှ အသုံးပြုသူများကို ScribbleMaps သို့ အလိုအလျောက် ထပ်တူကျစေပြီး အသင်းဝင်များကို သင့်အဖွဲ့အစည်း၏ ဒိုင်ရက်ထရီနှင့် အမြဲတမ်း ကိုက်ညီစေပါသည်။

SCIM ပံ့ပိုးပေးခြင်းကို team.scribblemaps.com တွင် အသုံးပြုနိုင်ပြီး လုံးဝ အခမဲ့ဖြစ်ပါသည်။

မာတိကာ

1. SCIM ဆိုတာ ဘာလဲ။
2. မစတင်မီ
3. အဆင့် ၁: ScribbleMaps တွင် SCIM ကို ဖွင့်ပါ
4. အဆင့် ၂: Bearer Token ထုတ်လုပ်ပါ
5. အဆင့် ၃: သင်၏ Identity Provider ကို ပြင်ဆင်သတ်မှတ်ပါ
6. အဆင့် ၄: မူလသတ်မှတ်ချက် ထုတ်ကုန် သတ်မှတ်ပေးခြင်းကို သတ်မှတ်ပါ
7. အဆင့် ၅: စမ်းသပ်ပြီး အသုံးပြုသူများကို သတ်မှတ်ပါ
8. ဝန်ဆောင်မှုပေးသူအလိုက် လမ်းညွှန်များ
9. ပံ့ပိုးထားသော SCIM လုပ်ငန်းများ
10. အသုံးပြုသူ လည်ပတ်မှုသံသရာ စီမံခန့်ခွဲခြင်း
11. ပြဿနာဖြေရှင်းခြင်း

SCIM ဆိုတာ ဘာလဲ။

SCIM (System for Cross-domain Identity Management) သည် အောက်ပါတို့ကို အလိုအလျောက် ပြုလုပ်နိုင်စေသော ပွင့်လင်းစံနှုန်းတစ်ခု ဖြစ်ပါသည်။

• အသုံးပြုသူများကို ပံ့ပိုးပေးခြင်း - သင်၏ IdP တွင် အသုံးပြုသူများကို သတ်မှတ်လိုက်သည့်အခါ ScribbleMaps အကောင့်များကို အလိုအလျောက် ဖန်တီးပေးပါသည်
• အသုံးပြုသူများကို မွမ်းမံခြင်း - အသုံးပြုသူ အချက်အလက် (အမည်၊ အီးမေးလ်) ကို ထပ်တူကျအောင် ထိန်းသိမ်းပေးပါသည်
• အသုံးပြုသူများကို ရုပ်သိမ်းခြင်း - သင်၏ IdP မှ အသုံးပြုသူများကို ဖယ်ရှားလိုက်သည့်အခါ အကောင့်များကို အလိုအလျောက် ပိတ်ပေးပါသည်
• အခန်းကဏ္ဍများကို စီမံခန့်ခွဲခြင်း - အုပ်စုဝင်ဖြစ်မှုမှတစ်ဆင့် အသုံးပြုသူများကို စီမံခန့်ခွဲသူ (Admin) သို့မဟုတ် အသင်းဝင် (Member) အခန်းကဏ္ဍများသို့ သတ်မှတ်ပေးပါသည်

SCIM သည် SSO (SAML/OIDC) နှင့် အတူတကွ အလုပ်လုပ်ပြီး အထောက်အထားအပြည့်အစုံ လည်ပတ်မှုသံသရာ စီမံခန့်ခွဲမှုကို ပေးစွမ်းပါသည်။

မစတင်မီ

• SCIM ကို ပြင်ဆင်သတ်မှတ်ရန် သင်သည် အသင်းပိုင်ရှင် (Team Owner) ဖြစ်ရပါမည်
• သင်၏ Identity Provider ၏ စီမံခန့်ခွဲသူ ကွန်ဆိုးလ်သို့ ဝင်ရောက်ခွင့် လိုအပ်ပါသည်
• သင်၏ IdP သည် SCIM 2.0 ကို ပံ့ပိုးရပါမည် (Okta၊ Microsoft Entra ID၊ OneLogin၊ JumpCloud စသည်)
• အကောင်းဆုံး အသုံးပြုသူ အတွေ့အကြုံအတွက် SCIM မတိုင်မီ SSO ကို ပြင်ဆင်သတ်မှတ်ရန် အကြံပြုပါသည်

အဆင့် ၁: ScribbleMaps တွင် SCIM ကို ဖွင့်ပါ

1. team.scribblemaps.com သို့ ဝင်ရောက်ပါ
2. SCIM Provisioning (ဘယ်ဘက်ဘား) သို့ သွားပါ
3. Enable SCIM ကို ON သို့ ပြောင်းပါ

မှတ်ချက်: SCIM ကို အပြည့်အဝ ဖွင့်နိုင်ရန်မတိုင်မီ Bearer Token ကို ထုတ်လုပ်ရန် လိုအပ်ပါလိမ့်မည်။

အဆင့် ၂: Bearer Token ထုတ်လုပ်ပါ

Bearer Token သည် သင်၏ Identity Provider ကို ScribbleMaps နှင့် အထောက်အထားစိစစ်ပေးပါသည်။

1. SCIM ဆက်တင်များ စာမျက်နှာတွင် Generate Token ကို နှိပ်ပါ
2. Token ကို ချက်ချင်း ကူးယူပြီး လုံခြုံစွာ သိမ်းဆည်းထားပါ

အရေးကြီးသော လုံခြုံရေး မှတ်ချက်များ:

• Token ကို တစ်ကြိမ်သာ ပြသပါသည် - ပျောက်သွားပါက အသစ်တစ်ခု ထုတ်လုပ်ရပါမည်
• ဤ Token ကို စကားဝှက်ကဲ့သို့ ဆက်ဆံပါ - Token ရှိသူ မည်သူမဆို သင်၏ အသင်း၏ အသုံးပြုသူများကို စီမံခန့်ခွဲနိုင်ပါသည်
• အန္တရာယ်ရှိလာပါက Token ကို အချိန်မရွေး ရုပ်သိမ်းပြီး ပြန်လည်ထုတ်လုပ်နိုင်ပါသည်
• Token ကို ရုပ်သိမ်းလိုက်ပါက Token အသစ်တစ်ခု ပြင်ဆင်သတ်မှတ်ပြီးသည်အထိ SCIM လုပ်ငန်းအားလုံး ချက်ချင်း ရပ်တန့်သွားပါမည်

အဆင့် ၃: သင်၏ Identity Provider ကို ပြင်ဆင်သတ်မှတ်ပါ

သင်၏ IdP တွင် ScribbleMaps ကို SCIM အပလီကေးရှင်းအဖြစ် ပြင်ဆင်သတ်မှတ်ရန် အောက်ပါ အသေးစိတ်များကို အသုံးပြုပါ။

SCIM Endpoints ကိုးကားချက်

အဆင့် ၄: မူလသတ်မှတ်ချက် ထုတ်ကုန် သတ်မှတ်ပေးခြင်းကို သတ်မှတ်ပါ (ရွေးချယ်စရာ)

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

1. SCIM ဆက်တင်များ စာမျက်နှာတွင် Default Product Assignment ကို ရှာပါ
2. ထုတ်ကုန်တစ်ခုကို ရွေးချယ်ပါ:
   • မရှိပါ - အသုံးပြုသူများကို ထုတ်ကုန်မပါဘဲ ဖန်တီးပါမည် (နောက်မှ ကိုယ်တိုင် သတ်မှတ်ပါ)
   • ကြည့်ရှုသူ - ကြည့်ရှုခွင့်သာ
   • Pro Basic - စံနှုန်း တည်းဖြတ်ရေး လုပ်ဆောင်ချက်များ
   • Pro စီးပွားရေးလုပ်ငန်း - လုပ်ဆောင်ချက်အားလုံး အသုံးပြုခွင့်
3. သိမ်းဆည်းရန် ကို နှိပ်ပါ

မှတ်ချက်: ထိုင်ခုံများ ကျန်ရှိမှသာ အသုံးပြုသူများကို ထုတ်ကုန်သတ်မှတ်ပေးပါမည်။ ထိုင်ခုံမကျန်ပါက အသုံးပြုသူကို ဖန်တီးထားသော်လည်း မသတ်မှတ်ဘဲ ထားရှိပါမည်။

အဆင့် ၅: စမ်းသပ်ပြီး အသုံးပြုသူများကို သတ်မှတ်ပါ

1. သင်၏ Identity Provider တွင် SCIM ချိတ်ဆက်မှုကို အတည်ပြုရန် Test Connection လုပ်ဆောင်ချက်ကို အသုံးပြုပါ
2. သင်၏ IdP ရှိ ScribbleMaps အပလီကေးရှင်းသို့ စမ်းသပ်အသုံးပြုသူတစ်ဦးကို သတ်မှတ်ပါ
3. အသုံးပြုသူသည် သင်၏ ScribbleMaps အသင်းဝင်စာရင်းတွင် ပေါ်လာကြောင်း စစ်ဆေးပါ
4. အတည်ပြုပြီးပါက လိုအပ်သလို အသုံးပြုသူများ သို့မဟုတ် အုပ်စုများကို ထပ်မံ သတ်မှတ်ပါ

ဝန်ဆောင်မှုပေးသူအလိုက် လမ်းညွှန်များ

Okta

1. Okta Admin Console တွင် Applications > Browse App Catalog သို့ သွားပါ
2. "SCIM 2.0 Test App (Header Auth)" ကို ရှာပါ သို့မဟုတ် စိတ်ကြိုက် SCIM အပလီကေးရှင်းတစ်ခု ဖန်တီးပါ
3. Provisioning တက်ဘ် > Configure API Integration သို့ သွားပါ
4. Enable API integration ကို အမှန်ခြစ်ပါ
5. ပြင်ဆင်သတ်မှတ်ပါ:
   • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
   • OAuth Bearer Token: သင်၏ ScribbleMaps SCIM token ကို ပူးတွဲချထားရန် (Paste)
6. အတည်ပြုရန် Test API Credentials ကို နှိပ်ပါ
7. Provisioning > To App သို့ သွားပြီး အောက်ပါတို့ကို ဖွင့်ပါ:
   • Create Users
   • Update User Attributes
   • Deactivate Users
8. အသုံးပြုသူများ သို့မဟုတ် အုပ်စုများကို သတ်မှတ်ရန် Assignments တက်ဘ်သို့ သွားပါ

Microsoft Entra ID (Azure AD)

1. Azure Portal တွင် Microsoft Entra ID > Enterprise Applications သို့ သွားပါ
2. သင်၏ ScribbleMaps အပလီကေးရှင်းကို ရွေးချယ်ပါ (သို့မဟုတ် တစ်ခု ဖန်တီးပါ)
3. Provisioning > စတင်ရန် သို့ သွားပါ
4. Provisioning Mode ကို Automatic သို့ သတ်မှတ်ပါ
5. Admin Credentials အောက်တွင်:
   • Tenant URL: https://api.scribblemaps.com/scim/v2
   • Secret Token: သင်၏ ScribbleMaps SCIM token ကို ပူးတွဲချထားရန် (Paste)
6. အတည်ပြုရန် Test Connection ကို နှိပ်ပါ
7. အသုံးပြုသူ ဂုဏ်သတ္တိများအတွက် Mappings ကို ပြင်ဆင်သတ်မှတ်ပါ
8. Provisioning Status ကို On သို့ သတ်မှတ်ပါ
9. အသုံးပြုသူများကို သတ်မှတ်ရန် Users and groups သို့ သွားပါ

OneLogin

1. OneLogin Admin တွင် Applications > Add App သို့ သွားပါ
2. "SCIM Provisioner with SAML (SCIM v2 Core)" သို့မဟုတ် ဆင်တူသည်ကို ရှာပါ
3. Configuration တက်ဘ်သို့ သွားပါ
4. ပြင်ဆင်သတ်မှတ်ပါ:
   • SCIM Base URL: https://api.scribblemaps.com/scim/v2
   • SCIM Bearer Token: သင်၏ ScribbleMaps SCIM token ကို ပူးတွဲချထားရန် (Paste)
5. Provisioning တက်ဘ်သို့ သွားပြီး provisioning ကို ဖွင့်ပါ
6. အသုံးပြုသူများကို သတ်မှတ်ရန် Users တက်ဘ်သို့ သွားပါ

JumpCloud

1. JumpCloud Admin တွင် SSO Applications သို့ သွားပါ
2. အပလီကေးရှင်းအသစ်တစ်ခု ထည့်ရန် + ကို နှိပ်ပါ
3. Custom SCIM ကို ရွေးချယ်ပါ
4. ပြင်ဆင်သတ်မှတ်ပါ:
   • Base URL: https://api.scribblemaps.com/scim/v2
   • Token Key: သင်၏ ScribbleMaps SCIM token ကို ပူးတွဲချထားရန် (Paste)
   • Authentication: Bearer Token
5. Test Connection ကို နှိပ်ပါ
6. ဂုဏ်သတ္တိ mapping များကို ပြင်ဆင်သတ်မှတ်ပါ
7. အပလီကေးရှင်းသို့ အသုံးပြုသူ အုပ်စုများကို သတ်မှတ်ပါ

ပံ့ပိုးထားသော SCIM လုပ်ငန်းများ

အသုံးပြုသူ လုပ်ငန်းများ

အုပ်စု လုပ်ငန်းများ

ပံ့ပိုးထားသော အသုံးပြုသူ ဂုဏ်သတ္တိများ

ပံ့ပိုးထားသော စစ်ထုတ်မှုများ

အသုံးပြုသူ လည်ပတ်မှုသံသရာ စီမံခန့်ခွဲခြင်း

အသုံးပြုသူကို ပံ့ပိုးပေးသည့်အခါ

1. ScribbleMaps တွင် အသင်းဝင်အကောင့်အသစ်တစ်ခု ဖန်တီးပါသည်
2. အသုံးပြုသူ အချက်အလက် (အမည်၊ အီးမေးလ်) ကို သင်၏ IdP မှ ဖြည့်သွင်းပါသည်
3. မူလသတ်မှတ်ချက် ထုတ်ကုန်ကို ပြင်ဆင်သတ်မှတ်ထားပြီး ထိုင်ခုံများ ကျန်ရှိပါက လိုင်စင်ကို အလိုအလျောက် သတ်မှတ်ပေးပါသည်
4. အသုံးပြုသူသည် SSO မှတစ်ဆင့် ချက်ချင်း ဝင်ရောက်နိုင်ပါသည် (ပြင်ဆင်သတ်မှတ်ထားပါက)

အသုံးပြုသူကို မွမ်းမံသည့်အခါ

1. အသုံးပြုသူ ဂုဏ်သတ္တိများ (အမည်၊ ပြသမည့် အမည်) ကို သင်၏ IdP နှင့် ကိုက်ညီအောင် မွမ်းမံပါသည်
2. အီးမေးလ် ပြောင်းလဲမှုများကို ထပ်တူကျစေပါသည် (အသုံးပြုသူက မိမိအကောင့်ကို ချိတ်ဆက်ထားပါက မဟုတ်ပါ)

အသုံးပြုသူကို ရုပ်သိမ်းသည့်အခါ

1. အသုံးပြုသူ၏ အကောင့်ကို ပိတ်လိုက်ပါသည် (soft delete)
2. ထုတ်ကုန်လိုင်စင်အားလုံးကို ဖယ်ရှားပြီး ထိုင်ခုံများကို လွတ်စေပါသည်
3. လက်ရှိ session အားလုံးကို ချက်ချင်း ပျက်ပြယ်စေပါသည်
4. အသုံးပြုသူသည် ထပ်မံ ဝင်ရောက်၍ မရတော့ပါ
5. အသုံးပြုသူ ဒေတာနှင့် မြေပုံများကို ထိန်းသိမ်းထားပါသည် (မဖျက်ပါ)
6. အသုံးပြုသူကို ပြန်လည် ပံ့ပိုးပေးပါက အကောင့်ကို ပြန်လည်ဖွင့်နိုင်ပါသည်

အုပ်စုများမှတစ်ဆင့် အခန်းကဏ္ဍ စီမံခန့်ခွဲခြင်း

ScribbleMaps သည် SCIM မှတစ်ဆင့် အခန်းကဏ္ဍ အုပ်စု နှစ်ခုကို ဖော်ပြပေးပါသည်။

အသုံးပြုသူတစ်ဦးကို စီမံခန့်ခွဲသူအဖြစ် သတ်မှတ်ရန် SCIM PATCH မှတစ်ဆင့် ၎င်းတို့ကို admin အုပ်စုသို့ ထည့်ပါ။ ပိုင်ရှင် (Owner) အခန်းကဏ္ဍကို SCIM မှတစ်ဆင့် ပြောင်း၍ မရပါ။

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

အဖြစ်များသော ပြဿနာများ

"401 Unauthorized" သို့မဟုတ် "Invalid token"

• Bearer Token မှန်ကန်ပြီး ရုပ်သိမ်းခြင်း မခံရသေးကြောင်း စစ်ဆေးပါ
• Token ကို Authorization header တွင် Bearer YOUR_TOKEN အဖြစ် ပေးပို့ထားကြောင်း သေချာပါစေ
• Token သက်တမ်းကုန်ဆုံးသွားခြင်း ရှိမရှိ စစ်ဆေးပါ (သက်တမ်း သတ်မှတ်ထားပါက)
• လိုအပ်ပါက Token အသစ်တစ်ခု ထုတ်လုပ်ပါ

"409 Conflict" - အသုံးပြုသူ ရှိပြီးသား

• ထိုအီးမေးလ်ဖြင့် အသုံးပြုသူတစ်ဦး သင်၏ အသင်းတွင် ရှိပြီးသား ဖြစ်ပါသည်
• ရှိပြီးသား အသုံးပြုသူကို ပိတ်ထားခဲ့ပါက SCIM က ၎င်းကို အလိုအလျောက် ပြန်လည်ဖွင့်ပေးပါမည်
• သင်၏ IdP တွင် အီးမေးလ် လိပ်စာ ထပ်နေခြင်း ရှိမရှိ စစ်ဆေးပါ

"400 Bad Request" - လိုအပ်သော အကွက် ပျောက်နေသည်

• userName (အီးမေးလ်) ကို တောင်းဆိုမှုတွင် ထည့်သွင်းထားကြောင်း သေချာပါစေ
• အီးမေးလ် ပုံစံ မှန်ကန်ကြောင်း စစ်ဆေးပါ
• သင်၏ IdP ၏ ဂုဏ်သတ္တိ mapping ပြင်ဆင်သတ်မှတ်ချက်ကို စစ်ဆေးပါ

အသုံးပြုသူများ ဖန်တီးပြီးသော်လည်း ထုတ်ကုန် မသတ်မှတ်ရသေးပါ

• SCIM ဆက်တင်များတွင် မူလသတ်မှတ်ချက် ထုတ်ကုန် ပြင်ဆင်သတ်မှတ်ထားခြင်း ရှိမရှိ စစ်ဆေးပါ
• မူလသတ်မှတ်ချက် ထုတ်ကုန်အတွက် ကျန်ရှိသော ထိုင်ခုံများ ရှိကြောင်း အတည်ပြုပါ
• အသုံးပြုသူများကို အသင်း ဆက်တင်များတွင် ထုတ်ကုန်များ ကိုယ်တိုင် သတ်မှတ်ပေးနိုင်ပါသည်

အသုံးပြုသူ ပြောင်းလဲမှုများ မထပ်တူကျပါ

• IdP အချို့သည် အချိန်ဇယားအတိုင်း ထပ်တူကျစေပါသည် (ဥပမာ Azure AD အတွက် ၄၀ မိနစ်တစ်ကြိမ်)
• သင်၏ IdP တွင် ကိုယ်တိုင် ထပ်တူကျစေရန် အတင်းအကျပ် လုပ်ကြည့်ပါ
• SCIM ကို ဆက်လက် ဖွင့်ထားပြီး Token မှန်ကန်ကြောင်း စစ်ဆေးပါ

ချိတ်ဆက်မှု စမ်းသပ်ခြင်း မအောင်မြင်ပါ

• SCIM Base URL သည် အတိအကျ https://api.scribblemaps.com/scim/v2 ဖြစ်ကြောင်း စစ်ဆေးပါ
• နောက်ဆုံးတွင် slash များ သို့မဟုတ် စာလုံးပေါင်းအမှားများ မရှိကြောင်း သေချာပါစေ
• သင်၏ ကွန်ရက်/ဖိုင်ယာဝေါလ်က api.scribblemaps.com သို့ ထွက်သွားသော HTTPS ကို ခွင့်ပြုထားကြောင်း စစ်ဆေးပါ
   

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

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

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

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