अंग्रेज़ी में पढ़ें

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


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

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

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

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

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

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

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

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

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

नोट

अन्य OAuth 2.0 प्रदाताओं का उपयोग करके SSO को कॉन्फ़िगर करने के लिए, जेनेरिक OAuth प्रदाताओं के साथ एकल साइन-ऑन कॉन्फ़िगर करें देखें.

समर्थित चैनल

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

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

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

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

महत्वपूर्ण

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

हालाँकि, SSO उस एजेंट के लिए समर्थित है जिसे SharePoint वेबसाइट पर SPFx घटक के रूप में प्रकाशित किया गया है।

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

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

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

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

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

  2. प्रमाणीकरण ऐप पंजीकरण को फिर से बनाने के लिए निर्देशों का पालन करें, दूसरा ऐप पंजीकरण बनाएं, जो आपके कैनवास ऐप पंजीकरण के रूप में कार्य करता है.

  3. प्रमाणीकरण ऐप पंजीकरण में कैनवास ऐप पंजीकरण ID जोड़ें.

टोकन एक्सचेंज URL जोड़ें

Microsoft Entra आईडी प्रमाणीकरण सेटिंग को Copilot Studio में अपडेट करने के लिए, आपको अपने ऐप और Copilot Studio को जानकारी साझा करने की अनुमति देने के लिए टोकन एक्सचेंज URL जोड़ना होगा।

  1. अपने प्रमाणीकरण ऐप पंजीकरण ब्लेड पर Azure पोर्टल में, API एक्सपोज़ करें पर जाएँ.

  2. स्कोप्स के अंतर्गत, क्लिपबोर्ड पर कॉपी करें आइकन का चयन करें.

  3. Copilot Studioमें, सेटिंग्स के अंतर्गत नेविगेशन मेनू में, सुरक्षा का चयन करें, और फिर प्रमाणीकरण टाइल का चयन करें।

  4. टोकन एक्सचेंज URL (SSO के लिए आवश्यक) के लिए, आपके द्वारा पहले कॉपी किया गया स्कोप पेस्ट करें.

  5. सहेजें चुनें.

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

  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 से कोड कॉपी करें और निम्नलिखित निर्देशों का उपयोग करके इसे संशोधित करें।

नोट

GitHub रिपो में दिए गए कोड के लिए आवश्यक है कि उपयोगकर्ता लॉगिन बटन का चयन करें या किसी अन्य साइट से लॉगिन करें। स्वचालित लॉगिन सक्षम करने के लिए, aysnc function main() के आरंभ में निम्नलिखित कोड जोड़ें:

JavaScript
    (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 पोर्टल में अवलोकन पृष्ठ पर जाएं और अपने कैनवास अनुप्रयोग पंजीकरण से अनुप्रयोग (क्लाइंट) ID और निर्देशिका (टेनेंट) ID की प्रतिलिपि बनाएँ.

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

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

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

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

    JavaScript
    var clientApplication;
        (function (){
        var msalConfig = {
            auth: {
                clientId: '00001111-aaaa-2222-bbbb-3333cccc4444',
                authority: 'https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'     
            },
    
  3. theURL वैरिएबल को आपके द्वारा पहले कॉपी किए गए टोकन एंडपॉइंट URL पर सेट करें। उदाहरण के लिए:

    JavaScript
    (async function main() {
    
        var theURL = "https://<token endpoint URL>"
    
  4. एक कस्टम उपसर्ग शामिल करने के लिए userId के मान को संपादित करें। उदाहरण के लिए:

    JavaScript
    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. अपने परिवर्तन सहेजें.

  6. सत्यापित करें कि आपने SSO को सफलतापूर्वक कॉन्फ़िगर किया है.

    अपने एजेंट का परीक्षण करते समय, यदि SSO सफलतापूर्वक कॉन्फ़िगर नहीं किया गया है, तो आपको लॉग इन करने के लिए कहा जाएगा, जो आपको एक सत्यापन कोड देगा जिसे आपको चैट विंडो में कॉपी करना होगा।

    यदि आपको साइन-इन संकेत दिखाई दे, तो सत्यापित करें कि आपने इस प्रक्रिया के चरण 1 से 5 तक को सही ढंग से पूरा किया है। यदि SSO सफलतापूर्वक कॉन्फ़िगर हो जाता है, तो आपको लॉग इन करने के लिए संकेत नहीं दिया जाता है।