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

Copilot Studio สนับสนุนการลงชื่อเข้าระบบครั้งเดียว (SSO) SSO ช่วยให้เอเจนต์ในเว็บไซต์ของคุณสามารถลงชื่อเข้าใช้ลูกค้าได้หากพวกเขาเข้าสู่ระบบหน้าเว็บหรือแอปที่มีการปรับใช้เอเจนต์อยู่แล้ว

ตัวอย่างเช่น เอเจนต์ถูกโฮสต์บนอินทราเน็ตขององค์กรหรือในแอปที่ผู้ใช้ลงเข้าใช้อยู่แล้ว

มีห้าขั้นตอนหลักในการกําหนดค่า SSO สําหรับ Copilot Studio:

  1. กําหนดค่าการตรวจสอบสิทธิ์ด้วยตนเองสําหรับเอเจนต์ของคุณด้วย Microsoft Entra ID

  2. สร้างการลงทะเบียนแอปใน Microsoft Entra ID สําหรับพื้นที่ทํางานแบบกําหนดเองของคุณ

  3. อนุญาตให้แอป Canvas ใช้ขอบเขตที่กําหนดเองของแอปตรวจสอบสิทธิ์

  4. เพิ่มขอบเขตแบบกำหนดเองให้กับการกำหนดค่าเอเจนต์ของคุณ

  5. กําหนดค่าโค้ด Canvas แบบกําหนดเองฝั่งไคลเอนต์สําหรับ SSO

ข้อกำหนดเบื้องต้น

Note

สําหรับผู้ให้บริการ OAuth 2.0 รายอื่น ๆ ดูข้อมูลเพิ่มเติมในหัวข้อ กําหนดค่าการลงชื่อเข้าใช้ครั้งเดียวกับผู้ให้บริการ OAuth ทั่วไป

ช่องทางที่รองรับ

ตารางต่อไปนี้แสดง ช่องทาง ที่รองรับ SSO บทความนี้อธิบายเกี่ยวกับ SSO สำหรับพื้นที่ทำงานเว็บไซต์แบบกำหนดเอง สําหรับการติดตั้ง Teams ให้ปฏิบัติตาม คําแนะนํา Teams SSO แยกต่างหาก

แชนเนล ได้รับการสนับสนุน
ช่อง Azure Bot Service ไม่รองรับ
เว็บไซต์ที่กำหนดเอง ได้รับการสนับสนุน
เว็บไซต์สาธิต ไม่รองรับ
เฟสบุ๊ค ไม่รองรับ
Microsoft Teams1 ได้รับการสนับสนุน
แอปสำหรับอุปกรณ์เคลื่อนที่ ไม่รองรับ
ออมนิแชนแนลสำหรับการบริการลูกค้า2 ได้รับการสนับสนุน
SharePoint ได้รับการสนับสนุน

1รับรองความถูกต้องด้วย Microsoft มี SSO อัตโนมัติสําหรับการแชทของ Teams ที่รองรับ หากการปรับใช้ของคุณต้องการการตรวจสอบสิทธิ์ด้วยตนเอง ให้ปฏิบัติตามคําแนะนําการลงทะเบียนและปรับใช้แอปใน กําหนดค่าการลงชื่อเข้าใช้ครั้งเดียวด้วย Microsoft Entra ID สําหรับเอเจนต์ใน Teams

2 รองรับเฉพาะช่องทางสนทนาสดเท่านั้น เรียนรู้เพิ่มเติมในหัวข้อ กําหนดค่าการส่งต่อไปยัง Dynamics 365 Customer Service

สำคัญ

ไม่รองรับ SSO เมื่อเผยแพร่เอเจนต์ไปยัง Power Pages

ค้นหา URL ปลายทางโทเค็นเอเจนต์ของคุณ

ทั้งสองขั้นตอนใช้ URL token endpoint ของเอเจนต์ บันทึกไว้ก่อนที่คุณจะกําหนดค่าแคนวาสที่กําหนดเอง

  1. ใน Copilot Studio เปิดเจ้าหน้าที่ของคุณ จากนั้นเลือก Channels

  2. เลือก แอปบนมือถือ

  3. ภายใต้ ตำแหน่งข้อมูลโทเค็น เลือก คัดลอก

    ภาพหน้าจอของการคัดลอก URL สำหรับจุดสิ้นสุดโทเค็นใน Copilot Studio

สร้างการลงทะเบียนแอปสำหรับเว็บไซต์ที่กำหนดเองของคุณ

ในการกําหนดค่า SSO ให้สร้างการลงทะเบียนแอปสองรายการแยกกัน:

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

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

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

  2. สร้างการลงทะเบียนแอปที่สองเพื่อใช้เป็นการลงทะเบียนแอป Canvas ของคุณ

เพิ่ม URL การแลกเปลี่ยนโทเค็น

ใช้ URI ขอบเขตแบบเต็มที่การลงทะเบียนแอปการรับรองความถูกต้องแสดงเป็น URL สำหรับการแลกเปลี่ยนโทเค็น หากคุณไม่ได้สร้างขอบเขตที่กําหนดเอง ให้ดําเนินการ กําหนดค่าการตรวจสอบสิทธิ์ผู้ใช้ด้วย Microsoft Entra ID ก่อน

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

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

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

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

  5. เลือก บันทึก แล้วเผยแพร่เอเจนต์ของคุณ

อนุญาตให้แอป Canvas ใช้ขอบเขตการอนุญาตของแอปตรวจสอบสิทธิ์

  1. ในพอร์ทัล Azure เปิดการลงทะเบียนแอป Canvas ของคุณและไปที่ Overview

  2. คัดลอกค่า ID แอปพลิเคชัน (ไคลเอนต์) ภายใต้ Essentials

  3. เปิดการลงทะเบียนแอปการรับรองความถูกต้อง ของคุณ จากนั้นเลือก จัดการ>แสดง API

  4. ภายใต้แอปพลิเคชันไคลเอ็นต์ที่ได้รับอนุญาต เลือกเพิ่มแอปพลิเคชันไคลเอ็นต์

  5. ใน Client ID ให้วาง client ID ของแอป canvas

  6. ภายใต้ขอบเขตที่ได้รับอนุญาต ให้เลือกขอบเขตที่คุณสร้างสําหรับการแลกเปลี่ยนโทเค็น จากนั้นเลือก เพิ่มแอปพลิเคชัน

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

  1. เปิดารลงทะเบียนแอปพื้นที่ทำงานของคุณ และไปที่ การรับรองความถูกต้อง

  2. ภายใต้ การกำหนดค่าแพลตฟอร์ม ให้เลือก เพิ่มแพลตฟอร์ม จากนั้นเลือก SPA

  3. ภายใต้ เปลี่ยนเส้นทาง URI ให้ป้อน URL สําหรับหน้าเว็บของคุณ ตัวอย่างเช่น: https://www.contoso.com/index.html

  4. ในส่วน ผังลำดับอนุญาตและไฮบริดโดยนัย ให้เปิดทั้ง โทเค็นการเข้าใช้ (ใช้สำหรับผังลำดับโดยนัย) และ โทเค็นรหัส (ใช้สำหรับผังลำดับอนุญาตและไฮบริดโดยนัย)

  5. เลือก กำหนดค่า

กำหนดค่า SSO ในเว็บเพจของคุณ

สำคัญ

ผู้ใช้แบบ Guest ไม่สามารถเข้าถึงคําตอบที่สร้างโดย AI จากแหล่งข้อมูล SharePoint และ Graph Connector ในแอปที่ตั้งค่าสําหรับ SSO ได้

ใช้ตัวอย่าง Microsoft Entra ID SSO ทั้งหมด รวมถึงไลบรารีและมิดเดิลแวร์ เนื้อหาการคุยผ่านเว็บ ทำตาม README ของตัวอย่างและอัปเดตตัวยึดตำแหน่งการกำหนดค่าใน index.html

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

  2. ใน Overview ให้คัดลอก Application (client) ID และ Directory (tenant) ID

    Screenshot ของหน้าภาพรวมการลงทะเบียนแอปในพอร์ทัล Azure ด้วยภาพรวม ID แอปพลิเคชัน และ ID ไดเรกทอรีที่เน้น

  3. แทนที่ตัวยึดตำแหน่ง client ID และ tenant ID ของตัวอย่างด้วยค่าจากการลงทะเบียนแอป Canvas อย่าใช้ client ID ของแอปตรวจสอบสิทธิ์ที่นี่

  4. แทนที่ตัวยึดตำแหน่ง token endpoint ด้วย URL token endpoint ของเอเจนต์

  5. หากคุณปรับแต่งรหัสผู้ใช้ ให้เก็บไว้ภายในขีดจำกัด 64 อักขระที่ตัวอย่างกำหนด

  6. บันทึกการเปลี่ยนแปลง

  7. โฮสต์หน้าที่ URL เปลี่ยนเส้นทางที่คุณลงทะเบียนไว้ ลงชื่อเข้าใช้โดยใช้ปุ่มลงชื่อเข้าใช้ของตัวอย่าง จากนั้นเริ่มสนทนาที่ต้องการการยืนยันตัวตน

    เมื่อการแลกเปลี่ยนโทเคนสําเร็จ ตัวแทนจะไม่ขอให้คุณลงชื่อเข้าใช้ใหม่หรือคัดลอกรหัสยืนยันเข้าไปในแชท ถ้ามี ให้ตรวจสอบตัวระบุแอป Canvas, ขอบเขตที่ได้รับอนุญาต, URL แลกเปลี่ยนโทเค็น และการเผยแพร่เอเจนต์

    Note

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

ลงทะเบียนแอปพลิเคชันใน Microsoft Entra ID

  • อัปเดตล่าสุดเมื่อ