กําหนดค่าการลงชื่อเข้าระบบครั้งเดียวด้วย Microsoft Entra ID สําหรับเจ้าหน้าที่ใน Microsoft Teams

Copilot Studio สนับสนุนการลงชื่อเข้าระบบครั้งเดียว (SSO) สำหรับเอเจนต์ที่เผยแพร่ไปยังการสนทนาแบบ 1:1 ของ Microsoft Teams ตัวแทนสามารถลงชื่อเข้าใช้ผู้ใช้ด้วยข้อมูลประจําตัว Microsoft Teams โดยอัตโนมัติโดยใช้การสนับสนุนนี้ รองรับ SSO เมื่อใช้ Microsoft Entra ID เท่านั้น

Prerequisites

• เรียนรู้วิธีใช้การรับรองความถูกต้องของผู้ใช้ในหัวข้อ
• เชื่อมต่อและกำหนดค่าเอเจนต์สำหรับ Microsoft Teams

กำหนดค่าการลงทะเบียนแอป

ก่อนที่จะกำหนดค่า SSO สำหรับ Teams ให้ตั้งค่าการรับรองความถูกต้องของผู้ใช้ด้วย Microsoft Entra ID กระบวนการนี้จะสร้างการลงทะเบียนแอปที่คุณต้องตั้งค่า SSO

1. สร้างการลงทะเบียนแอป ดูคำแนะนำใน กำหนดค่าการรับรองความถูกต้องผู้ใช้ด้วย Microsoft Entra ID

2. เพิ่ม URL การเปลี่ยนเส้นทาง

3. สร้างข้อมูลลับของไคลเอ็นต์

4. กำหนดค่าการรับรองความถูกต้องด้วยตนเอง

ค้นหา ID แอปช่องทาง Teams ของคุณ

1. ใน Copilot Studio ให้เปิดเอเจนต์ที่คุณต้องการกำหนดค่า SSO

2. ไปที่หน้าช่องทางสําหรับเอเจนต์ของคุณและเลือกไทล์ Teams และ Microsoft Copilot

3. ในแผงกําหนดค่า Teams และ Microsoft Copilot ให้เลือก แก้ไขรายละเอียด ขยาย เพิ่มเติม แล้วเลือก คัดลอก ถัดจากช่อง App ID

เพิ่มรหัสแอปช่องทาง Teams ของคุณในการลงทะเบียนแอป

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

2. เลือก แสดง API บนบานหน้าต่างด้านข้าง สำหรับ URI ของรหัสแอปพลิเคชัน เลือก ตั้งค่า

   

3. ป้อน api://botid-{teamsbotid} และแทนที่ {teamsbotid} ด้วย รหัสแอปช่องทาง Teams ที่คุณพบก่อนหน้านี้

   

4. เลือก บันทึก

ให้ความยินยอมของผู้ดูแลระบบ

แอปพลิเคชันได้รับอนุญาตให้เรียกใช้ API เมื่อผู้ใช้หรือผู้ดูแลระบบให้สิทธิ์ในระหว่างกระบวนการยินยอม หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการยินยอม โปรดดู สิทธิ์และความยินยอมในแพลตฟอร์มข้อมูลประจำตัวของ Microsoft

หากมีตัวเลือกความยินยอมของผู้ดูแลระบบ ให้ความยินยอม:

1. ในพอร์ทัล Azure ในการลงทะเบียนแอปของคุณ ให้ไปที่ สิทธิ์ API

2. เลือก ให้คำยินยอมของผู้ดูแลระบบสำหรับ <ชื่อผู้เช่าของคุณ> แล้วเลือก ใช่

เพิ่มสิทธิ์ API

1. ในพอร์ทัล Azure ในการลงทะเบียนแอปของคุณ ให้ไปที่ สิทธิ์ API

2. เลือก เพิ่มสิทธิ์ แล้วเลือก Microsoft Graph

3. เลือก สิทธิ์ที่ได้รับมอบสิทธิ์ รายการสิทธิ์จะปรากฏขึ้น

4. ขยาย สิทธิ์ OpenId

5. เลือก openid และ โปรไฟล์

6. เลือกเพิ่มสิทธิ์

   

กำหนดขอบเขตที่กำหนดเองสำหรับเอเจนต์ของคุณ

1. ในพอร์ทัล Azure ในอินสแตนซ์การลงทะเบียนแอปของคุณ ให้ไปที่ ขยาย API

2. เลือก เพิ่มขอบเขต

   

3. ตั้งค่าคุณสมบัติดังต่อไปนี้

   ทรัพย์สิน	มูลค่า
   ชื่อขอบเขต	ป้อน Test.Read
   ใครสามารถยินยอม	เลือก ผู้ดูแลระบบและผู้ใช้
   ชื่อแสดงการยินยอมผู้ดูแลระบบ	ป้อน Test.Read
   คำอธิบายความยินยอมของผู้ดูแลระบบ	ป้อน Allows the app to sign the user in.
   รัฐ/จังหวัด	เลือก เปิดใช้งาน

   Note

   ชื่อขอบเขต Test.Read เป็นค่าตัวยึด แทนที่ด้วยชื่อที่เหมาะสมในสภาพแวดล้อมของคุณ

4. เลือก เพิ่มขอบเขต

เพิ่มรหัสไคลเอ็นต์ Microsoft Teams

1. ในพอร์ทัล Azure ในอินสแตนซ์การลงทะเบียนแอปของคุณ ให้ไปที่ ส่งออก API และเลือก เพิ่มแอปพลิเคชันไคลเอ็นต์

   

2. ในฟิลด์ รหัสไคลเอ็นต์ ให้ป้อนรหัสไคลเอ็นต์สำหรับ Microsoft Teams บนมือถือ/เดสก์ท็อป ซึ่งเป็น 1fec8e78-bce4-4aaf-ab1b-5451cc387264 เลือกกล่องกาเครื่องหมายสำหรับ ขอบเขตที่คุณสร้างก่อนหน้านี้

   

3. เลือก เพิ่มแอปพลิเคชัน

4. ทำซ้ำขั้นตอนก่อนหน้า แต่สำหรับ ID ไคลเอ็นต์ ให้ป้อน ID ไคลเอ็นต์สำหรับ Microsoft Teams บนเว็บ ซึ่งก็คือ 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

5. ยืนยันว่าหน้า แสดง API แสดงรายการรหัสแอปไคลเอ็นต์ Microsoft Teams

โดยสรุป ID ไคลเอ็นต์ Microsoft Teams สองรายการที่คุณเพิ่มลงในหน้า เปิดเผย API หน้าคือ:

• 1fec8e78-bce4-4aaf-ab1b-5451cc387264
• 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

เพิ่ม URL การแลกเปลี่ยนโทเค็นในหน้าการรับรองความถูกต้องของเอเจนต์ของคุณ

เมื่อต้องการอัปเดตการตั้งค่าการรับรองความถูกต้อง Microsoft Entra ID ใน Copilot Studio ให้เพิ่ม URL การแลกเปลี่ยนโทเค็นเพื่อให้ Microsoft Teams และ Copilot Studio สามารถแชร์ข้อมูลได้

1. ในพอร์ทัล Azure ในอินสแตนซ์การลงทะเบียนแอปของคุณ ให้ไปที่ ขยาย API

2. ภายใต้ ขอบเขต ให้เลือกไอคอน คัดลอกไปยังคลิปบอร์ด

3. ใน Copilot Studio ภายใต้การตั้งค่าสำหรับเอเจนต์ ให้เลือก ความปลอดภัย แล้วเลือกไทล์ การรับรองความถูกต้อง

4. สำหรับ URL การแลกเปลี่ยนโทเค็น (จำเป็นสำหรับ SSO) ให้วางขอบเขตที่คุณคัดลอกไว้ก่อนหน้านี้

5. เลือก บันทึก

   

เพิ่ม SSO ลงในช่องทาง Teams ของเอเจนต์

1. ใน Copilot Studio ภายใต้การตั้งค่าสำหรับเอเจนต์ ให้เลือก ช่องทาง

2. เลือกไทล์ Teams และ Microsoft Copilot

3. เลือก แก้ไขรายละเอียด และขยาย เพิ่มเติม

4. สำหรับ รหัสไคลเอ็นต์ของแอปพลิเคชัน AAD ป้อน รหัสแอปพลิเคชัน (ไคลเอ็นต์) จากการลงทะเบียนแอปของคุณ

   เมื่อต้องการรับค่านี้ ให้เปิดพอร์ทัล Azure ในการลงทะเบียนแอปใหม่ของคุณ ให้ไปที่ ภาพรวม คัดลอกค่าในช่อง รหัสแอปพลิเคชัน (ไคลเอ็นต์)

5. สำหรับ URI ของทรัพยากร ป้อน URI ของรหัสแอปพลิเคชัน จากการลงทะเบียนแอปของคุณ

   เมื่อต้องการรับค่านี้ ให้เปิดพอร์ทัล Azure ในการลงทะเบียนแอปใหม่ของคุณ ให้ไปที่ เปิดเผย API คัดลอกค่าในช่อง URI ของรหัสแอปพลิเคชัน

   

6. เลือก บันทึก จากนั้น ปิด

7. เผยแพร่เอเจนต์อีกครั้งเพื่อให้ลูกค้าของคุณสามารถใช้งานการเปลี่ยนแปลงล่าสุดได้

8. เลือก ดูเอเจนต์ใน Teams เพื่อเริ่มการสนทนาใหม่กับเอเจนต์ของคุณใน Teams และตรวจสอบว่ามีการลงชื่อเข้าใช้โดยอัตโนมัติหรือไม่

ปัญหาที่ทราบกันดี

หากคุณเผยแพร่เอเจนต์ของคุณเป็นครั้งแรกโดยใช้การรับรองความถูกต้องด้วยตนเองโดยไม่มี SSO ของ Teams เอเจนต์ใน Teams จะแจ้งให้ผู้ใช้เข้าสู่ระบบอย่างต่อเนื่อง