แชร์ผ่าน

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

  • บทความ

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

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

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

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

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

  3. กำหนดค่าการรับรองความถูกต้องใน Copilot Studio เพื่อเปิดใช้งาน SSO

  4. กำหนดค่าโค้ด HTML พื้นที่ทำงานแบบกำหนดเองของคุณ เพื่อเปิดใช้งาน SSO

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

หมายเหตุ

หากต้องการกำหนดค่า SSO โดยใช้ตัวให้บริการ OAuth 2.0 อื่นๆ โปรดดู กำหนดค่าการลงชื่อเข้าระบบครั้งเดียวด้วยตัวให้บริการ OAuth ทั่วไป

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

ตารางต่อไปนี้ให้รายละเอียด ช่องทาง ที่รองรับ SSO ในปัจจุบัน คุณสามารถแนะนำการสนับสนุนสำหรับช่องทางเพิ่มเติม ที่ฟอรัมไอเดีย Copilot Studio

ช่องทาง รองรับ
ช่องทางบริการ Azure Bot ไม่รองรับ
เว็บไซต์ที่กำหนดเอง รองรับ
เว็บไซต์สาธิต ไม่รองรับ
Facebook ไม่รองรับ
Microsoft Teams1 รองรับ
แอปสำหรับอุปกรณ์เคลื่อนที่ ไม่รองรับ
ช่องทาง Omni สำหรับ Customer Service2 รองรับ

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

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

สำคัญ

ขณะนี้ SSO ยังไม่รองรับเมื่อ ตัวแทน ได้รับอย่างใดอย่างหนึ่งต่อไปนี้

อย่างไรก็ตาม SSO ได้รับการสนับสนุนสำหรับเอเจนต์ที่ได้รับการเผยแพร่ไปยังเว็บไซต์ SharePoint เป็น คอมโพเนนต์ SPFx

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

ในการเปิดใช้งาน SSO คุณต้องสร้างการลงทะเบียนแอปสองรายการแยกกัน:

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

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

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

  2. ปฏิบัติตามคำแนะนำในการสร้างการลงทะเบียนแอปการรับรองความถูกต้องอีกครั้ง เพื่อสร้างการลงทะเบียนแอปครั้งที่สอง ซึ่งทำหน้าที่เป็นการลงทะเบียนแอปพื้นที่ทำงานของคุณ

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

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

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

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

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

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

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

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

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

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

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

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

    ภาพหน้าจอของหน้าการกำหนดค่าเว็บ

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

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

ค้นหา URL ปลายทางโทเค็น ตัวแทน ของคุณ

  1. ใน Copilot Studio เปิดเอเจนต์ของคุณแล้วเลือก ช่องทาง

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

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

    ภาพหน้าจอการคัดลอก URL ตำแหน่งข้อมูลโทเค็นใน Copilot Studio

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

ใช้รหัสที่ให้ไว้ในe Copilot Studio GitHub repo เพื่อสร้างเว็บเพจสำหรับ URL เปลี่ยนเส้นทาง คัดลอกโค้ดจากที่เก็บ GitHub และแก้ไขโดยใช้คำแนะนำต่อไปนี้

หมายเหตุ

โค้ดในที่เก็บ GitHub ต้องการให้ผู้ใช้เลือกปุ่มเข้าสู่ระบบหรือเข้าสู่ระบบจากไซต์อื่น หากต้องการเปิดใช้งานการเข้าสู่ระบบอัตโนมัติ ให้เพิ่มโค้ดต่อไปนี้ที่จุดเริ่มต้นของ aysnc function main()

    (async function main() {
        if (clientApplication.getAccount() == null) {
           await clientApplication.loginPopup(requestObj).then(onSignin).catch(function (error) {console.log(error) });
        }
        // Add your BOT ID below 
        var theURL =

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

    ภาพหน้าจอของหน้าภาพรวมการลงทะเบียนแอปในพอร์ทัล Azure โดยไฮไลต์ภาพรวม รหัสแอปพลิเคชัน และรหัสไดเรกทอรี

  2. การกำหนดค่า Microsoft Authentication Library (MSAL):

    • กำหนด clientId ให้กับ รหัสแอปพลิเคชัน (ไคลเอ็นต์)
    • กำหนด authority ไปยัง https://login.microsoftonline.com/ และเพิ่ม รหัสไดเรกทอรี (ผู้เช่า) ID ในส่วนท้าย

    ตัวอย่างเช่น

    var clientApplication;
    (function (){
    var msalConfig = {
        auth: {
            clientId: '00001111-aaaa-2222-bbbb-3333cccc4444',
            authority: 'https://login.microsoftonline.com/7ef988bf-xxxx-51af-01ab-2d7fd011db47'     
        },

  3. ตั้งค่าตัวแปร theURL เป็น URL ตำแหน่งข้อมูลโทเค็นที่คุณคัดลอกไว้ก่อนหน้านี้ ตัวอย่างเช่น

    (async function main() {

    var theURL = "https://<token endpoint URL>"

  4. แก้ไขค่าของ userId เพื่อรวมคำนำหน้าที่กำหนดเอง ตัวอย่าง

    var userId = clientApplication.account?.accountIdentifier != null ? 
        ("My-custom-prefix" + clientApplication.account.accountIdentifier).substr(0, 64) 
        : (Math.random().toString() + Date.now().toString()).substr(0,64);

  5. บันทึกการเปลี่ยนแปลงของคุณ

ทดสอบ ตัวแทน ของคุณโดยใช้หน้าเว็บของคุณ

  1. เปิดเว็บเพจของคุณในเบราว์เซอร์

  2. เลือกเข้าสู่ระบบ

    ภาพหน้าจอของการเข้าสู่ระบบโดยใช้รหัสการตรวจสอบ

    หมายเหตุ

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

    แท็บเบราว์เซอร์ใหม่จะเปิดขึ้น

  3. สลับไปที่แท็บใหม่และคัดลอกรหัสการตรวจสอบความถูกต้อง

  4. สลับกลับไปที่แท็บที่มี ตัวแทน ของคุณ และวางรหัสตรวจสอบลงในการสนทนา ตัวแทน

เนื้อหาที่เกี่ยวข้อง