Motimate: วิธีการตั้งค่า SCIM ระหว่าง Azure และ Motimate?

เปิดใช้งานการผสานรวม SCIM ระหว่าง Azure Active Directory (AD) ของคุณกับ Motimate เพื่อซิงโครไนซ์ผู้ใช้โดยอัตโนมัติใน Motimate

Motimate รองรับการนำเข้า/ซิงค์ข้อมูลอัตโนมัติจาก Azure AD โดยใช้ SCIM API คุณยังสามารถตรวจสอบคู่มือของMicrosoft: สร้างและวางแผนการจัดเตรียมสำหรับจุดสิ้นสุด SCIM ใน Azure Active Directoryเพื่อเรียนรู้เพิ่มเติมได้

 

ข้อจำกัดที่ควรทราบ

ในขณะที่การผสานรวม SCIM จะช่วยให้คุณสามารถนำเข้าและรักษาการซิงค์ผู้ใช้ระหว่าง Azure (ปัจจุบันคือ Entra ID) และ Motimate ได้ แต่ผู้ใช้ทุกคนจะได้รับบทบาทผู้ใช้มาตรฐาน 'ผู้ใช้ทั่วไป' และบทบาท 'สมาชิก' ในทุกกลุ่ม ผู้ใช้ใด ๆ ที่ควรมีบทบาทอื่น ๆ จะต้องได้รับการอัปเดตด้วยตนเองเมื่อพวกเขาถูกนำเข้าแล้ว คุณสามารถอ่านเพิ่มเติมเกี่ยวกับบทบาทต่าง ๆ ใน Motimateได้ที่นี่

การตั้งค่า SCIM ระหว่าง Microsoft Azure และ Motimate

1. เข้าสู่ระบบMicrosoft Azure Portalของคุณด้วยบัญชีผู้ดูแลระบบ Microsoft Azure
    
2. เริ่มต้นด้วยการค้นหาEnterprise Applications ใน แถบค้นหาที่ด้านบนของ Azure Portal แล้วคลิกเมื่อปรากฏขึ้น
    
3. หน้าใหม่สำหรับการตั้งค่าแอปพลิเคชันองค์กร ปรากฏขึ้น ที่นี่คุณควรคลิกที่ "New Application " ที่ด้านบนของหน้าเว็บ
    
4. จากนั้นคลิกที่ สร้างแอปพลิเคชันของคุณเอง ที่ด้านบนของหน้า
    
5. ในหน้าต่างที่ปรากฏทางด้านขวา คุณต้องตั้งชื่อแอปของคุณว่า :Motimate SCIM.
    
6. จากนั้นเลือกปุ่มวิทยุต่อไปนี้:
   ผสานรวมแอปพลิเคชันอื่นใดที่คุณไม่พบในแกลเลอรี (นอกแกลเลอรี)
    
7. คลิกที่สร้าง และคุณจะถูกนำไปยังหน้าภาพรวม ของแอปพลิเคชันใหม่ของคุณในไม่ช้า
    
8. ตอนนี้คุณควรไปที่Provisioning ใน เมนูด้านซ้าย จากนั้นคลิกปุ่ม เริ่มต้น
    
9. ขณะนี้คุณจะต้องตั้งค่าโหมดการจัดเตรียมเป็น อัตโนมัติ
    
10. กรุณากรอกURL ของผู้เช่าและ โทเค็นลับที่คุณได้รับ จาก Motimate หากคุณยังไม่ได้ติดต่อ Motimate เพื่อขอรับสิ่งเหล่านี้ คุณจะไม่สามารถดำเนินการต่อได้
     
11. คลิกทดสอบการเชื่อมต่อ เพื่อให้ แน่ใจว่าสำเร็จ อาจใช้เวลาสักครู่ แต่คุณจะเห็นการแจ้งเตือนที่มุมขวาบนเมื่อเสร็จสิ้น
    • หากการทดสอบล้มเหลว โปรดตรวจสอบอีกครั้งว่าคุณได้ป้อนTenant URL และ Secret Token ตรงตามที่ Motimate ได้ให้ไว้
       

    • URL ของผู้เช่าจะมีรูปแบบดังนี้:

      https://{identifier}.motimateapp.com/scim/v1

      อย่าลืมเปลี่ยน {identifier} กับบัญชี Motimate ของคุณ
       

    • โทเค็นลับจะประกอบด้วย ตัวอักษรและตัวเลขจำนวน 32 ตัว เช่น:

      5e188cf76084d08cde4b7d68083f27c4

      (ตัวอย่างโทเคนนี้จะไม่สามารถใช้งานได้ ดังนั้นอย่าใช้)
       

12. เมื่อการทดสอบสำเร็จ คุณต้องคลิกบันทึก ก่อน ที่คุณจะสามารถดำเนินการต่อได้
     
13. เมื่อการตั้งค่าถูกบันทึกแล้ว ส่วนใหม่สำหรับการจับคู่จะ ปรากฏขึ้นใต้ปุ่มทดสอบการเชื่อมต่อ
     
14. กรุณาขยายส่วนการแมป (Mappings ) จากนั้นคลิกการจัดเตรียมผู้ใช้ Azure Active Directory
     
15. เลื่อนลงจนกว่าคุณจะเห็นส่วนการแมปแอตทริบิวต์
     
16. ก่อนอื่นคุณต้องค้นหาคุณสมบัติ ของAzure Active Directory ใน คอลัมน์แรกที่เรียกว่าmailNickname.
     
17. คลิกที่mailNickname แล้วหน้าต่างใหม่เพื่อแก้ไขคุณลักษณะจะ เปิดขึ้น
     
18. คุณต้องเปลี่ยนคุณลักษณะแหล่งที่มาจาก mailNickname เป็น objectId
     
19. จากนั้นเลือกใช่ ใน เมนูแบบเลื่อนลงสำหรับจับคู่รายการโดยใช้คุณสมบัตินี้
     
20. คลิกตกลง
     
21. ขณะนี้คุณต้องตรวจสอบให้แน่ใจว่าคุณได้เก็บคุณลักษณะของAzure Active Directoryต่อไปนี้ไว้ในคอลัมน์แรก:
    • objectId
    • Switch([IsSoftDeleted], , "False", "True", "True", "False")
    • ตำแหน่งงาน
    • อีเมล
    • ชื่อผู้ใช้หลัก
    • ชื่อ
    • นามสกุล

    • มือถือ*
      
      *) หมายเลขโทรศัพท์ต้องขึ้นต้นด้วยเครื่องหมายบวก ตามด้วยรหัสประเทศและตัวเลขเท่านั้น:

      ถูกต้อง:+4798765432
      ไม่ถูกต้อง:98765432

      อนุญาตให้เว้นว่างได้ รูปแบบไม่ถูกต้องจะทำให้ไม่สามารถซิงค์ได้ หากคุณไม่แน่ใจเกี่ยวกับรูปแบบหรือไม่จำเป็นต้องซิงโครไนซ์ตัวเลข เราขอแนะนำให้ลบคุณสมบัตินี้ออก

22. คุณสามารถลบสิ่ง ต่อไปนี้ได้:
    • ชื่อแสดง
    • ภาษาที่ต้องการ
    • Join(" ", [ชื่อ], [นามสกุล])
    • ชื่อสำนักงานจัดส่งทางกายภาพ
    • ที่อยู่ถนน
    • เมือง
    • รัฐ
    • รหัสไปรษณีย์
    • ประเทศ
    • หมายเลขโทรศัพท์
    • หมายเลขโทรศัพท์แบบจำลอง
    • รหัสพนักงาน
    • แผนก
    • ผู้จัดการ
       
23. ตอนนี้คุณต้องคลิกที่แอตทริบิวต์userPrincipalName เพื่อ เปิดหน้าต่างแก้ไขแอตทริบิวต์
     
24. เปลี่ยนตัวเลือกในเมนูแบบเลื่อนลงสำหรับวัตถุที่ตรงกันโดยใช้คุณสมบัตินี้เป็น "ไม่" แล้วคลิกตกลง
     
25. จากนั้นคลิกที่อ็อบเจ็กต์คุณสมบัติobjectId เพื่อ เปิดหน้าต่างแก้ไขคุณสมบัติ อีกครั้ง
     
26. คราวนี้เปลี่ยนค่าของลำดับความสำคัญในการจับคู่เป็น 1 แล้วคลิกตกลง
     
27. รายการการแมปแอตทริบิวต์ของคุณควรมีลักษณะดังนี้:
    
    
     
28. หากทุกอย่างถูกต้องแล้ว คุณสามารถคลิกบันทึกที่ด้าน บนและจากนั้นคลิกตกลง
     
29. สำคัญมาก: น่าเสียดาย เนื่องจากมีข้อผิดพลาดในระบบ Azure คุณจำเป็นต้องกลับไปที่ภาพรวมของแอปพลิเคชัน Motimate SCIM ของคุณ และทำตามคำแนะนำต่อไปนี้:
    1. คลิกที่ Provisioning ใน เมนูทางด้านซ้ายอีกครั้ง
    2. คลิกแก้ไขการจับคู่แอตทริบิวต์ ภายใต้ส่วนการจัดการการจัดเตรียม
    3. ขยายส่วนการแมป และคลิกจัดเตรียมผู้ใช้ Azure Active Directory อีกครั้ง
    4. ตอนนี้มีความเป็นไปได้สูงที่ชื่อของคุณลักษณะแรกของ Azure Active Directory จะเปลี่ยนกลับไปเป็นmailNickname อีกครั้ง
    5. กรุณาคลิกที่mailNickname และ ในหน้าต่างแก้ไขคุณสมบัติ ให้เปลี่ยนSource Attribute กลับเป็น objectId
    6. คลิกตกลง จากนั้นบันทึกที่ด้านบน แล้วคลิกใช่
    7. ขั้นตอนนี้มีความสำคัญมากที่จะต้องแก้ไข หากไม่ทำเช่นนั้นผู้ใช้ทุกคนจะไม่สามารถซิงโครไนซ์กับ Motimate ได้
        
30. หลังจากแก้ไขข้อบกพร่องข้างต้นแล้ว คุณสามารถกลับไปที่การตั้งค่าการจัดเตรียม ได้ คุณสามารถไปที่นั่นได้โดยคลิกที่ > การจัดเตรียม > ที่ เส้นทางด้านบนสุดที่นี่:
    
    
     
31. ครั้งนี้คุณควรคลิกที่การจัดเตรียมกลุ่ม Azure Active Directory
     
32. ในส่วนการแมปแอตทริบิวต์ ให้คลิกที่แอตทริบิวต์ Azure Active Directory ที่ชื่อว่า objectID
     
33. ในหน้าต่างแก้ไขคุณสมบัติ ให้เปลี่ยนตัวเลือก "จับคู่รายการโดยใช้คุณสมบัตินี้" เป็น "ใช่" แล้วคลิกตกลง
     
34. จากนั้นคลิกที่แสดงชื่อคุณสมบัติ
     
35. ในหน้าต่างแก้ไขคุณสมบัติ ให้เปลี่ยนตัวเลือก "จับคู่รายการโดยใช้คุณสมบัตินี้ "เป็น "ไม่" แล้วคลิกตกลง
     
36. ตอนนี้ให้คลิกที่อ็อบเจ็กต์คุณสมบัติobjectID อีกครั้ง แล้วเปลี่ยนลำดับความสำคัญในการจับคู่เป็น 1 จากนั้นคลิกตกลง
     
37. รายการการจับคู่แอตทริบิวต์ของคุณควรมีลักษณะเหมือนกับตัวอย่างนี้ทุกประการ:
    
    
     
38. หากทุกอย่างถูกต้องแล้ว คุณสามารถคลิกบันทึกที่ด้าน บนและจากนั้นคลิกตกลง
     
39. คุณสามารถคลิกที่เครื่องหมายX ที่ มุมขวาบนใต้ชื่อผู้ใช้และรูปโปรไฟล์ของคุณได้แล้ว คลิกสองครั้ง เพื่อกลับไปยังการตั้งค่าแอปพลิเคชันของคุณ
     
40. การกำหนดค่าแอปพลิเคชันของคุณเสร็จสมบูรณ์แล้ว และเราจำเป็นต้องทดสอบการซิงโครไนซ์ของผู้ใช้ทดสอบสองคน
     
41. คลิกที่ผู้ใช้และกลุ่มใน เมนูทางด้านซ้าย นี่คือที่ที่คุณจะเพิ่มกลุ่มที่ต้องการซิงค์กับ Motimate โดยปกติ แต่สำหรับการทดสอบ คุณสามารถเพิ่มผู้ใช้เพียงหนึ่งหรือสองคนแทนได้
     
42. คลิกที่เพิ่มผู้ใช้/กลุ่ม ที่ด้านบนของหน้าจอ
     
43. คลิกไม่มีที่เลือก ภายใต้ ผู้ใช้
     
44. ค้นหาและพบผู้ใช้ที่คุณต้องการทดสอบ เราขอแนะนำให้ทดสอบผู้ใช้ของคุณเอง อาจรวมถึงผู้ดูแลระบบ Motimate ขององค์กรของคุณด้วย (หากไม่ใช่คุณ) หากคุณได้สร้างบัญชีผู้ใช้สำหรับการทดสอบสำหรับผู้ติดต่อของคุณใน Motimate แล้ว โปรดเพิ่มบัญชีนี้ด้วย
     
45. ผู้ใช้ทั้งหมดที่คุณเลือกจะปรากฏภายใต้รายการที่เลือก เมื่อเสร็จแล้ว ให้คลิกที่ปุ่มเลือก ด้านล่าง
     
46. ตอนนี้ให้คลิกที่ปุ่มกำหนด
     
47. คุณพร้อมแล้วที่จะเปิดการเตรียมการเพื่อทดสอบว่าทุกอย่างทำงานได้ อย่างไรก็ตาม ก่อนที่คุณจะทำเช่นนั้น คุณต้องส่งอีเมลไปยังผู้ติดต่อของคุณใน Motimate หรือไปที่support@motimateapp.comเพื่อแจ้งให้เราทราบว่าคุณวางแผนที่จะเปิดการใช้งานการจัดเตรียม ด้วยอีเมลนี้ คุณต้องแจ้งให้เราทราบถึงรหัสวัตถุ (Object ID), ชื่อผู้ใช้หลัก (User Principal Name - UPN), และอีเมลของผู้ใช้แต่ละคนที่คุณวางแผนจะทดสอบ นอกจากนี้ คุณต้องแนบภาพหน้าจอของการจับคู่แอตทริบิวต์สำหรับสิ่งต่อไปนี้:
    • การจัดเตรียมผู้ใช้ Azure Active Directory
    • การจัดเตรียมกลุ่ม Azure Active Directory
       
48. เราจะติดต่อกลับและยืนยันว่าคุณสามารถเปิดการเตรียมการใช้งานได้หากทุกอย่างดูถูกต้อง
     
49. เพื่อเปิดการใช้งานการจัดเตรียม ให้คลิกที่ การจัดเตรียม ใน เมนูทางด้านซ้าย
     
50. จากนั้นคลิกเริ่มการเตรียมการใช้งาน ที่ ด้านบนของหน้าจอ
     
51. อาจใช้เวลาถึงหลายชั่วโมงก่อนที่ผู้ใช้จะได้รับการจัดสรรโดยอัตโนมัติ หลังจากที่คุณได้เริ่มการจัดเตรียมแล้ว คุณสามารถคลิกที่Provision on Demand เพื่อ จัดเตรียมผู้ใช้จำนวนหนึ่งได้ เร็วขึ้น (ระยะเวลาที่ผู้ใช้จะปรากฏใน Motimate ขึ้นอยู่กับปริมาณข้อมูลที่กำลังถูกโอนถ่ายในขณะนั้น)
     
52. ค้นหาผู้ใช้คนใดคนหนึ่งที่คุณเพิ่มไว้สำหรับการทดสอบ เลือกผู้ใช้ จากนั้นคลิกปุ่มจัดเตรียม ที่ด้านล่าง คุณสามารถจัดเตรียมผู้ใช้ได้เพียงหนึ่งคนต่อครั้งตามคำขอเท่านั้น และคุณสามารถจัดเตรียมผู้ใช้ได้เฉพาะผู้ใช้ที่ได้เพิ่มไว้ในแอปพลิเคชันภายใต้ผู้ใช้และกลุ่มเท่านั้น พวกเขาต้องถูกเพิ่มโดยตรง หรือเป็นสมาชิกโดยตรงของกลุ่มที่เพิ่มแล้ว
     
53. หากการจัดเตรียมสำเร็จแล้ว เครื่องหมายถูกทั้งหมดจะเป็นสีเขียวดังนี้:
    
    หากการจัดเตรียมล้มเหลวด้วยเหตุผลใด ๆ คุณต้องถ่ายภาพหน้าจอของคุณทั้งหมด รวมถึงใต้"ดูรายละเอียด" ของขั้นตอนที่ล้มเหลว กรุณาส่งสิ่งนี้ไปยังผู้ติดต่อ Motimate ของคุณเพื่อการแก้ไขปัญหา
     
54. หากการจัดเตรียมสำเร็จ คุณสามารถคลิกที่ปุ่มจัดเตรียมผู้ใช้รายอื่นเพื่อเพิ่มผู้ใช้รายอื่นที่คุณต้องการทดสอบ
     
55. เมื่อการเตรียมข้อมูลตามคำขอได้เสร็จสิ้นสำหรับผู้ใช้ทดสอบทั้งหมดแล้ว กรุณาส่งอีเมลถึง Motimate เพื่อยืนยันว่าคุณได้ดำเนินการเตรียมข้อมูลเสร็จสิ้นแล้ว
     
56. เราจะยืนยันว่าทุกอย่างดูเรียบร้อยดีจากฝั่งของเรา และหลังจากนั้นคุณจะสามารถเพิ่มกลุ่มสำหรับการจัดเตรียมได้เช่นกัน
     
57. คุณควรหารือเกี่ยวกับโครงสร้างกลุ่มของ Motimate กับผู้ติดต่อของคุณที่ Motimate ก่อนที่คุณจะเริ่มการจัดเตรียมกลุ่ม

ขอแสดงความยินดี! คุณได้ตั้งค่า SCIM ระหว่าง Azure และ Motimate สำเร็จแล้ว

หมายเหตุทางเทคนิคเพิ่มเติม

การแมปค่าเริ่มต้น

โดยค่าเริ่มต้น เราจะทำการแมปแอตทริบิวต์ SCIM ในลักษณะดังต่อไปนี้:

{
  "name":{
  "formatted":"John Doe",
"givenName":"John",
"familyName":"Doe"
  },
"title":"CTO",
  "active":true,
"emails":[
    {
      "type":"work",
"value":"john.doe@example.com",
      "primary":true
    }
  ],
"userName":"john.doe@example.onmicrosoft.com",
  "externalId":"cc5c3f1b-e046-40e8-a317-5e71b2b73286",
  "displayName":"John Mark Doe",
"phoneNumbers":[
    {
      "type":"mobile",
"value":"+4700000000",
      "primary":false
    },
    {
      "type":"work",
      "value":"+4899999999",
      "primary":true
    }
  ],
  "preferredLanguage":"en-US",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User":{
    "department":"DevOps"
  }
}

... จะสร้างผู้ใช้ Motimate พร้อมด้วยคุณสมบัติดังต่อไปนี้:

ข้อกำหนดรูปแบบอีเมล

ที่อยู่อีเมลต้องเป็นไปตามรูปแบบมาตรฐานของอีเมล เช่น:

• ไม่มีสัญลักษณ์ @ หรือช่องว่างในทั้งส่วนของที่อยู่อีเมลหรือโดเมน
• ต้องมีสัญลักษณ์ @ เพียงตัวเดียวคั่นระหว่างส่วนของชื่อผู้ใช้และโดเมน

ข้อกำหนดเกี่ยวกับหมายเลขพนักงาน

ข้อกำหนดที่สำคัญที่สุดคือจำนวนพนักงานต้องไม่ซ้ำกัน การตั้งค่าการแมปเริ่มต้นของเราจะกำหนดหมายเลขพนักงานตามแอตทริบิวต์ userName ของ SCIM ซึ่งหมายความว่า userNames ที่คุณต้องใช้จะต้องไม่ซ้ำกันด้วย

อีกหนึ่งข้อกำหนดสำหรับจำนวนพนักงานคือห้ามมีอักขระเว้นวรรคใด ๆ ปรากฏอยู่

ข้อกำหนดเกี่ยวกับหมายเลขโทรศัพท์

หมายเลขโทรศัพท์ต้องขึ้นต้นด้วย "+" และรหัสประเทศ เช่น "+4799999999" นอกจากนี้ไม่ควรมีอักขระเว้นวรรคใดๆ ตัวอย่างของหมายเลขโทรศัพท์ที่ไม่ถูกต้อง:

• 99999999
• 004799999999
• 4799999999
• @4799999999

เกี่ยวกับ external_id

SCIM ส่ง externalId ซึ่งโดยปกติจะเท่ากับ User หรือ Group's Active Directory Object ID. สามารถ ดึงexternalId นี้ได้ผ่าน SCIM API ของเรา นอกจากนี้ยังแสดงอยู่ในแผงควบคุม Motimate ภายใต้การนำเข้า>ผู้ใช้ SCIM>ดูผู้ใช้>แอตทริบิวต์ภายนอก

หมายเหตุ: ไม่มีความเกี่ยวข้องระหว่าง SCIMexternalId กับ Motimate Users and Groupsexternal_id attribute ซึ่งสามารถดึงข้อมูลได้ด้วย OpenAPI ของเรา

หากคุณมีคำถามใด ๆ โปรดติดต่อsupport@motimateapp.com