กำหนดค่าการลงชื่อเข้าระบบครั้งเดียวด้วย Azure Active Directory

  • บทความ

Power Virtual Agents รองรับการลงชื่อเข้าระบบครั้งเดียว (SSO) ซึ่งหมายความว่าแชทบอทสามารถลงชื่อผู้ใช้หากพวกเขาอยู่ในหน้าที่ใช้งานบอท

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

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

ใน Power Virtual Agents รุ่นพรีวิว SSO ได้รับการสนับสนุนสำหรับช่องทางเว็บไซต์ที่กำหนดเองเท่านั้น โดยไม่ได้รองรับช่องทางต่อไปนี้:

  • Azure Bot Service
  • เว็บไซต์สาธิต
  • Facebook
  • Microsoft Teams
  • แอปสำหรับอุปกรณ์เคลื่อนที่

หรือเมื่อบอทได้รับการ:

  • เผยแพร่ไปยัง Teams เว็บไซต์ SharePoint หรือพอร์ทัล Power Apps
  • รวมกับ Dynamics 365 Customer Service

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

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

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

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

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

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

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

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

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

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

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

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

ค้นหา URL ตำแหน่งข้อมูลโทเค็นของบอท

  1. ใน Power Virtual Agents ไปที่ การตั้งค่า แล้วเลือก ช่องทาง

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

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

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

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

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

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

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

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

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

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

    var clientApplication;
    (function (){
    var msalConfig = {
        auth: {
            clientId: '692e92c7-xxxx-4060-76d3-b381798f4d9c',
            authority: 'https://login.microsoftonline.com/7ef988bf-xxxx-51af-01ab-2d7fd011db47'     
        },

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

    (async function main() {

    var theURL = "https://1c0.0.environment.api.powerplatform.com/powervirtualagents/bots/5a099fd/directline/token?api-version=2022-03-01-preview"

  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. สลับกลับไปที่แท็บพร้อมกับบอทของคุณ และวางรหัสการตรวจสอบความถูกต้องลงในการสนทนาของบอท