ការកំណត់រចនាសម្ព័ន្ធការផ្តល់សិទ្ធិអ្នកប្រើប្រាស់ SCIM

ScribbleMaps គាំទ្រ SCIM 2.0 (System for Cross-domain Identity Management) សម្រាប់ការផ្តល់សិទ្ធិ និងដកសិទ្ធិអ្នកប្រើប្រាស់ដោយស្វ័យប្រវត្តិ។ នេះអនុញ្ញាតឱ្យអ្នកធ្វើសមកាលកម្មអ្នកប្រើប្រាស់ពីអ្នកផ្តល់អត្តសញ្ញាណ (IdP) របស់អ្នកទៅ ScribbleMaps ដោយស្វ័យប្រវត្តិ ដើម្បីធានាថាសមាជិកភាពក្រុមនៅតែស្របគ្នាជាមួយថតឯកសាររបស់ស្ថាប័នអ្នក។

ការផ្តល់សិទ្ធិ SCIM មាននៅ team.scribblemaps.com ហើយគឺឥតគិតថ្លៃទាំងស្រុង។

មាតិកា

1. តើ SCIM ជាអ្វី?
2. មុនពេលអ្នកចាប់ផ្តើម
3. ជំហានទី 1៖ បើក SCIM នៅក្នុង ScribbleMaps
4. ជំហានទី 2៖ បង្កើតសញ្ញាសម្ងាត់ Bearer
5. ជំហានទី 3៖ កំណត់រចនាសម្ព័ន្ធអ្នកផ្តល់អត្តសញ្ញាណរបស់អ្នក
6. ជំហានទី 4៖ កំណត់ការផ្តល់ផលិតផលលំនាំដើម
7. ជំហានទី 5៖ សាកល្បង និងកំណត់អ្នកប្រើប្រាស់
8. មគ្គុទ្ទេសក៍សម្រាប់អ្នកផ្តល់សេវាកម្មនីមួយៗ
9. ប្រតិបត្តិការ SCIM ដែលគាំទ្រ
10. ការគ្រប់គ្រងវដ្តជីវិតអ្នកប្រើប្រាស់
11. ការដោះស្រាយបញ្ហា

តើ SCIM ជាអ្វី?

SCIM (System for Cross-domain Identity Management) គឺជាស្តង់ដារបើកចំហដែលអនុញ្ញាតឱ្យអ្នកធ្វើដោយស្វ័យប្រវត្តិនូវ៖

• ផ្តល់សិទ្ធិអ្នកប្រើប្រាស់ - បង្កើតគណនី ScribbleMaps ដោយស្វ័យប្រវត្តិនៅពេលអ្នកប្រើប្រាស់ត្រូវបានកំណត់នៅក្នុង IdP របស់អ្នក
• ធ្វើបច្ចុប្បន្នភាពអ្នកប្រើប្រាស់ - រក្សាព័ត៌មានអ្នកប្រើប្រាស់ (ឈ្មោះ អ៊ីមែល) ឱ្យស្របគ្នា
• ដកសិទ្ធិអ្នកប្រើប្រាស់ - បិទដំណើរការគណនីដោយស្វ័យប្រវត្តិនៅពេលអ្នកប្រើប្រាស់ត្រូវបានដកចេញពី IdP របស់អ្នក
• គ្រប់គ្រងតួនាទី - កំណត់អ្នកប្រើប្រាស់ទៅតួនាទី អ្នកគ្រប់គ្រង ឬ សមាជិក តាមរយៈសមាជិកភាពក្រុម

SCIM ដំណើរការរួមគ្នាជាមួយ SSO (SAML/OIDC) ដើម្បីផ្តល់ការគ្រប់គ្រងវដ្តជីវិតអត្តសញ្ញាណពេញលេញ។

មុនពេលអ្នកចាប់ផ្តើម

• អ្នកត្រូវតែជា ម្ចាស់ក្រុម ដើម្បីកំណត់រចនាសម្ព័ន្ធ SCIM
• អ្នកត្រូវការចូលប្រើកុងសូលអ្នកគ្រប់គ្រងរបស់អ្នកផ្តល់អត្តសញ្ញាណរបស់អ្នក
• IdP របស់អ្នកត្រូវតែគាំទ្រ SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud ។ល។)
• យើងណែនាំឱ្យកំណត់រចនាសម្ព័ន្ធ SSO មុន SCIM ដើម្បីទទួលបានបទពិសោធន៍អ្នកប្រើប្រាស់ល្អបំផុត

ជំហានទី 1៖ បើក SCIM នៅក្នុង ScribbleMaps

1. ចូលទៅកាន់ team.scribblemaps.com
2. ចូលទៅកាន់ ការផ្តល់សិទ្ធិ SCIM (របារចំហៀងខាងឆ្វេង)
3. បើក បើក SCIM ទៅជា ON

កំណត់ចំណាំ៖ អ្នកនឹងត្រូវបង្កើតសញ្ញាសម្ងាត់ Bearer មុនពេល SCIM អាចត្រូវបានបើកពេញលេញ។

ជំហានទី 2៖ បង្កើតសញ្ញាសម្ងាត់ Bearer

សញ្ញាសម្ងាត់ Bearer ផ្ទៀងផ្ទាត់អ្នកផ្តល់អត្តសញ្ញាណរបស់អ្នកជាមួយ ScribbleMaps។

1. នៅលើទំព័រការកំណត់ SCIM ចុច បង្កើតសញ្ញាសម្ងាត់
2. ចម្លងសញ្ញាសម្ងាត់ភ្លាមៗ ហើយរក្សាទុកវាដោយសុវត្ថិភាព

កំណត់ចំណាំសន្តិសុខសំខាន់ៗ៖

• សញ្ញាសម្ងាត់ត្រូវបានបង្ហាញតែម្តងគត់ - ប្រសិនបើអ្នកបាត់វា អ្នកនឹងត្រូវបង្កើតថ្មី
• ចាត់ទុកសញ្ញាសម្ងាត់នេះដូចពាក្យសម្ងាត់ - អ្នកណាដែលមានសញ្ញាសម្ងាត់អាចគ្រប់គ្រងអ្នកប្រើប្រាស់របស់ក្រុមអ្នកបាន
• អ្នកអាចដកហូត និងបង្កើតសញ្ញាសម្ងាត់ឡើងវិញបានគ្រប់ពេល ប្រសិនបើវាត្រូវបានលួច
• ការដកហូតសញ្ញាសម្ងាត់នឹងបញ្ឈប់ប្រតិបត្តិការ SCIM ទាំងអស់ភ្លាមៗ រហូតដល់សញ្ញាសម្ងាត់ថ្មីត្រូវបានកំណត់រចនាសម្ព័ន្ធ

ជំហានទី 3៖ កំណត់រចនាសម្ព័ន្ធអ្នកផ្តល់អត្តសញ្ញាណរបស់អ្នក

ប្រើព័ត៌មានលម្អិតខាងក្រោមដើម្បីកំណត់រចនាសម្ព័ន្ធ ScribbleMaps ជាកម្មវិធី SCIM នៅក្នុង IdP របស់អ្នក៖

ឯកសារយោង Endpoints របស់ SCIM

ជំហានទី 4៖ កំណត់ការផ្តល់ផលិតផលលំនាំដើម (ស្រេចចិត្ត)

អ្នកអាចកំណត់អាជ្ញាប័ណ្ណផលិតផលដោយស្វ័យប្រវត្តិទៅអ្នកប្រើប្រាស់នៅពេលពួកគេត្រូវបានផ្តល់សិទ្ធិតាមរយៈ SCIM៖

1. នៅលើទំព័រការកំណត់ SCIM ស្វែងរក ការផ្តល់ផលិតផលលំនាំដើម
2. ជ្រើសរើសផលិតផលមួយ៖
   • គ្មាន - អ្នកប្រើប្រាស់ត្រូវបានបង្កើតដោយគ្មានផលិតផល (កំណត់ដោយដៃនៅពេលក្រោយ)
   • អ្នកមើល - ការចូលប្រើសម្រាប់តែមើល
   • Pro Basic - លក្ខណៈពិសេសកែសម្រួលស្តង់ដារ
   • Pro Business - ការចូលប្រើលក្ខណៈពិសេសពេញលេញ
3. ចុច រក្សាទុក

កំណត់ចំណាំ៖ អ្នកប្រើប្រាស់នឹងត្រូវបានកំណត់ផលិតផលតែនៅពេលមានកៅអីទំនេរប៉ុណ្ណោះ។ ប្រសិនបើគ្មានកៅអីទំនេរ អ្នកប្រើប្រាស់ត្រូវបានបង្កើត ប៉ុន្តែមិនត្រូវបានកំណត់។

ជំហានទី 5៖ សាកល្បង និងកំណត់អ្នកប្រើប្រាស់

1. នៅក្នុងអ្នកផ្តល់អត្តសញ្ញាណរបស់អ្នក ប្រើមុខងារ សាកល្បងការតភ្ជាប់ ដើម្បីផ្ទៀងផ្ទាត់ការតភ្ជាប់ SCIM
2. កំណត់អ្នកប្រើប្រាស់សាកល្បងម្នាក់ទៅកម្មវិធី ScribbleMaps នៅក្នុង IdP របស់អ្នក
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: បិទភ្ជាប់សញ្ញាសម្ងាត់ SCIM របស់ ScribbleMaps របស់អ្នក
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: បិទភ្ជាប់សញ្ញាសម្ងាត់ SCIM របស់ ScribbleMaps របស់អ្នក
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: បិទភ្ជាប់សញ្ញាសម្ងាត់ SCIM របស់ ScribbleMaps របស់អ្នក
5. ចូលទៅកាន់ផ្ទាំង Provisioning ហើយបើកការផ្តល់សិទ្ធិ
6. ចូលទៅកាន់ផ្ទាំង Users ដើម្បីកំណត់អ្នកប្រើប្រាស់

JumpCloud

1. នៅក្នុង JumpCloud Admin ចូលទៅកាន់ SSO Applications
2. ចុច + ដើម្បីបន្ថែមកម្មវិធីថ្មី
3. ជ្រើសរើស Custom SCIM
4. កំណត់រចនាសម្ព័ន្ធ៖
   • Base URL: https://api.scribblemaps.com/scim/v2
   • Token Key: បិទភ្ជាប់សញ្ញាសម្ងាត់ SCIM របស់ ScribbleMaps របស់អ្នក
   • Authentication: Bearer Token
5. ចុច Test Connection
6. កំណត់រចនាសម្ព័ន្ធការផ្គូផ្គងគុណលក្ខណៈ
7. កំណត់ក្រុមអ្នកប្រើប្រាស់ទៅកម្មវិធី

ប្រតិបត្តិការ SCIM ដែលគាំទ្រ

ប្រតិបត្តិការអ្នកប្រើប្រាស់

ប្រតិបត្តិការក្រុម

គុណលក្ខណៈអ្នកប្រើប្រាស់ដែលគាំទ្រ

តម្រងដែលគាំទ្រ

ការគ្រប់គ្រងវដ្តជីវិតអ្នកប្រើប្រាស់

នៅពេលអ្នកប្រើប្រាស់ត្រូវបានផ្តល់សិទ្ធិ

1. គណនីសមាជិកក្រុមថ្មីត្រូវបានបង្កើតនៅក្នុង ScribbleMaps
2. ព័ត៌មានអ្នកប្រើប្រាស់ (ឈ្មោះ អ៊ីមែល) ត្រូវបានបំពេញពី IdP របស់អ្នក
3. ប្រសិនបើផលិតផលលំនាំដើមត្រូវបានកំណត់រចនាសម្ព័ន្ធ ហើយមានកៅអីទំនេរ អាជ្ញាប័ណ្ណនឹងត្រូវបានកំណត់ដោយស្វ័យប្រវត្តិ
4. អ្នកប្រើប្រាស់អាចចូលតាមរយៈ SSO បានភ្លាមៗ (ប្រសិនបើបានកំណត់រចនាសម្ព័ន្ធ)

នៅពេលអ្នកប្រើប្រាស់ត្រូវបានធ្វើបច្ចុប្បន្នភាព

1. គុណលក្ខណៈអ្នកប្រើប្រាស់ (ឈ្មោះ ឈ្មោះបង្ហាញ) ត្រូវបានធ្វើបច្ចុប្បន្នភាពឱ្យត្រូវនឹង IdP របស់អ្នក
2. ការផ្លាស់ប្តូរអ៊ីមែលត្រូវបានធ្វើសមកាលកម្ម (លុះត្រាតែអ្នកប្រើប្រាស់បានភ្ជាប់គណនីរបស់ពួកគេ)

នៅពេលអ្នកប្រើប្រាស់ត្រូវបានដកសិទ្ធិ

1. គណនីរបស់អ្នកប្រើប្រាស់ត្រូវបានបិទដំណើរការ (លុបបែបទន់)
2. អាជ្ញាប័ណ្ណផលិតផលទាំងអស់ត្រូវបានដកចេញ ដោយបង្កើតកៅអីទំនេរឡើងវិញ
3. សម័យសកម្មទាំងអស់ត្រូវបានបញ្ឈប់ភ្លាមៗ
4. អ្នកប្រើប្រាស់មិនអាចចូលបានទៀតទេ
5. ទិន្នន័យអ្នកប្រើប្រាស់ និងផែនទីត្រូវបានរក្សាទុក (មិនត្រូវបានលុបទេ)
6. គណនីអាចត្រូវបានបើកដំណើរការឡើងវិញ ប្រសិនបើអ្នកប្រើប្រាស់ត្រូវបានផ្តល់សិទ្ធិឡើងវិញ

ការគ្រប់គ្រងតួនាទីតាមរយៈក្រុម

ScribbleMaps បង្ហាញក្រុមតួនាទីពីរតាមរយៈ SCIM៖

ដើម្បីកំណត់អ្នកប្រើប្រាស់ជាអ្នកគ្រប់គ្រង សូមបន្ថែមពួកគេទៅក្រុម admin តាមរយៈ SCIM PATCH។ តួនាទី ម្ចាស់ មិនអាចកែប្រែតាមរយៈ SCIM បានទេ។

ការដោះស្រាយបញ្ហា

បញ្ហាទូទៅ

"401 Unauthorized" ឬ "Invalid token"

• ផ្ទៀងផ្ទាត់ថាសញ្ញាសម្ងាត់ Bearer ត្រឹមត្រូវ ហើយមិនត្រូវបានដកហូត
• ត្រូវប្រាកដថាសញ្ញាសម្ងាត់ត្រូវបានបញ្ជូនក្នុងក្បាលទំព័រ Authorization ជា Bearer YOUR_TOKEN
• ពិនិត្យមើលថាតើសញ្ញាសម្ងាត់បានផុតកំណត់ឬនៅ (ប្រសិនបើបានកំណត់ការផុតកំណត់)
• បង្កើតសញ្ញាសម្ងាត់ថ្មី ប្រសិនបើចាំបាច់

"409 Conflict" - អ្នកប្រើប្រាស់មានរួចហើយ

• អ្នកប្រើប្រាស់ដែលមានអ៊ីមែលនោះមានរួចហើយនៅក្នុងក្រុមរបស់អ្នក
• ប្រសិនបើអ្នកប្រើប្រាស់ដែលមានស្រាប់ត្រូវបានបិទដំណើរការ SCIM នឹងបើកដំណើរការពួកគេឡើងវិញដោយស្វ័យប្រវត្តិ
• ពិនិត្យរកអាសយដ្ឋានអ៊ីមែលស្ទួននៅក្នុង IdP របស់អ្នក

"400 Bad Request" - ខ្វះវាលដែលទាមទារ

• ត្រូវប្រាកដថា userName (អ៊ីមែល) ត្រូវបានបញ្ចូលក្នុងសំណើ
• ផ្ទៀងផ្ទាត់ថាទ្រង់ទ្រាយអ៊ីមែលត្រឹមត្រូវ
• ពិនិត្យមើលការកំណត់រចនាសម្ព័ន្ធការផ្គូផ្គងគុណលក្ខណៈរបស់ IdP របស់អ្នក

អ្នកប្រើប្រាស់ត្រូវបានបង្កើត ប៉ុន្តែគ្មានផលិតផលត្រូវបានកំណត់

• ពិនិត្យមើលថាតើផលិតផលលំនាំដើមត្រូវបានកំណត់រចនាសម្ព័ន្ធនៅក្នុងការកំណត់ SCIM ឬទេ
• ផ្ទៀងផ្ទាត់ថាអ្នកមានកៅអីទំនេរសម្រាប់ផលិតផលលំនាំដើម
• អ្នកប្រើប្រាស់អាចត្រូវបានកំណត់ផលិតផលដោយដៃនៅក្នុងការកំណត់ក្រុម

ការផ្លាស់ប្តូរអ្នកប្រើប្រាស់មិនធ្វើសមកាលកម្ម

• IdP ខ្លះធ្វើសមកាលកម្មតាមកាលវិភាគ (ឧទាហរណ៍ រៀងរាល់ 40 នាទីសម្រាប់ Azure AD)
• សាកល្បងបង្ខំឱ្យធ្វើសមកាលកម្មដោយដៃនៅក្នុង IdP របស់អ្នក
• ផ្ទៀងផ្ទាត់ថា SCIM នៅតែបើក ហើយសញ្ញាសម្ងាត់នៅតែមានសុពលភាព

ការសាកល្បងការតភ្ជាប់បរាជ័យ

• ផ្ទៀងផ្ទាត់ថា URL មូលដ្ឋាន SCIM គឺ https://api.scribblemaps.com/scim/v2 ពិតប្រាកដ
• ត្រូវប្រាកដថាគ្មានសញ្ញា slash ចុងក្រោយ ឬកំហុសវាយអក្សរ
• ពិនិត្យមើលថាបណ្តាញ/ជញ្ជាំងភ្លើងរបស់អ្នកអនុញ្ញាត HTTPS ចេញទៅ api.scribblemaps.com
   

ត្រូវការជំនួយ?

ប្រសិនបើអ្នកជួបបញ្ហាជាមួយការផ្តល់សិទ្ធិ SCIM សូមទាក់ទងក្រុមគាំទ្ររបស់យើង ដោយភ្ជាប់មកជាមួយ៖

• ឈ្មោះក្រុមរបស់អ្នក
• អ្នកផ្តល់អត្តសញ្ញាណដែលអ្នកកំពុងប្រើ
• សារកំហុសណាមួយពីកំណត់ហេតុការផ្តល់សិទ្ធិរបស់ IdP របស់អ្នក
• រូបថតអេក្រង់នៃការកំណត់រចនាសម្ព័ន្ធ SCIM របស់អ្នក (ដោយលាក់សញ្ញាសម្ងាត់)

យើងនៅទីនេះដើម្បីជួយអ្នកកំណត់រចនាសម្ព័ន្ធការផ្តល់សិទ្ធិ SCIM សម្រាប់ស្ថាប័នរបស់អ្នក។