इसके माध्यम से साझा किया गया


Microsoft Entra आईडी के साथ एकल साइन-ऑन कॉन्फ़िगर करें

महत्त्वपूर्ण

Power Virtual Agents जनरेटिव एआई और उन्नत एकीकरण में महत्वपूर्ण निवेश के बाद, क्षमताएं और विशेषताएं अब इसका हिस्सा हैं। Microsoft Copilot Studio Microsoft Copilot

कुछ लेख और स्क्रीनशॉट इस बात का संदर्भ दे सकते हैं कि Power Virtual Agents जब हम दस्तावेज़ और प्रशिक्षण सामग्री को अपडेट करते हैं।

Copilot Studio एकल साइन-ऑन (SSO) का समर्थन करता है. SSO आपकी वेबसाइट पर सह-पायलटों को ग्राहकों को साइन इन करने की अनुमति देता है, यदि वे पहले से ही उस पृष्ठ या ऐप पर लॉग इन हैं जहां को-पायलट तैनात है।

पूर्वावश्यकताएँ

उदाहरण के लिए, को-पायलट को कॉर्पोरेट इंट्रानेट या किसी ऐसे ऐप में होस्ट किया जाता है, जिसमें उपयोगकर्ता पहले से लॉग इन है।

Copilot Studioके लिए SSO को कॉन्फ़िगर करने के चार मुख्य चरण हैं:

  1. अपने कस्टम कैनवास के लिए एक ऐप पंजीकरण in Microsoft Entra ID बनाएं.

  2. अपने को-पायलट के लिए एक कस्टम स्कोप परिभाषित करें।

  3. SSO को सक्षम करने के लिए Copilot Studio में प्रमाणीकरण कॉन्फ़िगर करें.

  4. SSO को सक्षम करने के लिए अपना कस्टम कैनवास HTML कोड कॉन्फ़िगर करें.

महत्त्वपूर्ण

SSO वर्तमान में समर्थित नहीं है जब को-पायलट निम्न में से कोई एक हो:

समर्थित चैनल

निम्न तालिका उन चैनलों का विवरण देती है जो वर्तमान में SSO का समर्थन करते हैं। आप आइडियाज़ फ़ोरम Microsoft Copilot Studio पर अतिरिक्त चैनलों के लिए समर्थन का सुझाव दे सकते हैं।

चैनल समर्थित
Azure बॉट सेवा चैनल समर्थित नहीं
कस्टम वेबसाइट समर्थित
डेमो वेबसाइट समर्थित नहीं
Facebook समर्थित नहीं
Microsoft Teams1 समर्थित
मोबाइल एप्लिकेशन समर्थित नहीं
Customer Service के लिए ओमनीचैनल2 समर्थित

1 यदि आपके पास टीम्स चैनल भी सक्षम है, तो आपको टीम्स चैनल के लिए SSO कॉन्फ़िगर करें दस्तावेज़ पर कॉन्फ़िगरेशन निर्देशों का पालन करना होगा. उस पृष्ठ पर दिए गए निर्देशों के अनुसार Teams SSO सेटिंग्स को कॉन्फ़िगर करने में विफल रहने पर, आपके उपयोगकर्ता Teams चैनल का उपयोग करते समय हमेशा प्रमाणीकरण में विफल हो जाते हैं।

2 केवल लाइव चैट चैनल समर्थित है। अधिक जानकारी के लिए, देखें हैंडऑफ़ को Dynamics 365 ग्राहक सेवा में कॉन्फ़िगर करें.

अपनी कस्टम वेबसाइट के लिए ऐप पंजीकरण बनाएँ

SSO सक्षम करने के लिए, आपको दो अलग-अलग ऐप पंजीकरण बनाने होंगे:

  • एक प्रमाणीकरण ऐप पंजीकरण, जो आपके को-पायलट के लिए ID उपयोगकर्ता प्रमाणीकरण सक्षम करता है Microsoft Entra
  • A कैनवास ऐप पंजीकरण, जो आपके कस्टम वेब पेज के लिए SSO सक्षम करता है

सुरक्षा कारणों से हम आपके को-पायलट और आपकी कस्टम वेबसाइट दोनों के लिए एक ही ऐप पंजीकरण का पुनः उपयोग करने की अनुशंसा नहीं करते हैं।

  1. प्रमाणीकरण ऐप पंजीकरण बनाने के लिए ID के साथ उपयोगकर्ता प्रमाणीकरण कॉन्फ़िगर करें Microsoft Entra में दिए गए निर्देशों का पालन करें।
  2. दूसरा ऐप पंजीकरण बनाने के लिए फिर से उन्हीं निर्देशों का पालन करें, जो आपके कैनवास ऐप पंजीकरण के रूप में कार्य करता है.

अपना कैनवास ऐप पंजीकरण कॉन्फ़िगर करें

  1. अपना कैनवास ऐप पंजीकरण बनाने के बाद, प्रमाणीकरण पर जाएँ, और फिर प्लेटफ़ॉर्म जोड़ें चुनें.

  2. प्लेटफ़ॉर्म कॉन्फ़िगरेशन के अंतर्गत, एक प्लेटफ़ॉर्म जोड़ें चुनें, और फिर वेब चुनें।

  3. रीडायरेक्ट URI के अंतर्गत, अपने वेब पृष्ठ का URL दर्ज करें; उदाहरण के लिए, http://contoso.com/index.html

    वेब पेज कॉन्फ़िगर करें का स्क्रीनशॉट.

  4. निहित अनुदान और हाइब्रिड प्रवाह अनुभाग में, एक्सेस टोकन (अंतर्निहित प्रवाह के लिए प्रयुक्त) और ID टोकन (अंतर्निहित और हाइब्रिड प्रवाह के लिए प्रयुक्त) दोनों को चालू करें.

  5. कॉन्फ़िगर करें को चुनें.

अपना को-पायलट टोकन एंडपॉइंट URL खोजें

  1. Copilot Studioमें, सेटिंग्स पर जाएं, और फिर चैनल का चयन करें।

  2. मोबाइल ऐप चुनें.

  3. टोकन एंडपॉइंट के अंतर्गत, कॉपी करें का चयन करें.

     Copilot Studioमें टोकन एंडपॉइंट URL की प्रतिलिपि बनाने का स्क्रीनशॉट।

अपने वेब पेज में SSO कॉन्फ़िगर करें

रीडायरेक्ट URL के लिए वेब पेज बनाने के लिए Copilot Studio GitHub रेपो में दिए गए कोड का उपयोग करें। GitHub repo से कोड कॉपी करें और नीचे दिए गए निर्देशों का उपयोग करके इसे संशोधित करें।

  1. Azure पोर्टल में अवलोकन पृष्ठ पर जाएं और अपने कैनवास ऐप पंजीकरण से एप्लिकेशन (क्लाइंट) ID और निर्देशिका (टेनेंट) ID की प्रतिलिपि बनाएँ.

    Azure पोर्टल में ऐप पंजीकरण अवलोकन पृष्ठ का स्क्रीनशॉट, जिसमें अवलोकन, एप्लिकेशन ID और निर्देशिका ID हाइलाइट किए गए हैं।

  2. Microsoft प्रमाणीकरण लाइब्रेरी (MSAL) को कॉन्फ़िगर करने के लिए:

    • clientIdअपने आवेदन (क्लाइंट) आईडी को असाइन करें
    • को authority असाइन https://login.microsoftonline.com/ करें और अपनी डायरेक्ट्री (टेनेंट) आईडी को अंत में जोड़ें।

    उदाहरण के लिए:

    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. अपने को-पायलट वाले टैब पर वापस जाएं, और सत्यापन कोड को को-पायलट वार्तालाप में पेस्ट करें।