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


Power Apps टेस्ट इंजन के लिए प्रमाणीकरण मार्गदर्शिका (पूर्वावलोकन)

नोट

पूर्वावलोकन सुविधाएँ उत्पादन में उपयोग के लिए नहीं होती हैं और इनकी कार्यक्षमता प्रतिबंधित हो सकती हैं. यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.

यह मार्गदर्शिका टेस्ट इंजन में प्रमाणीकरण स्थापित करने के लिए चरण-दर-चरण निर्देश प्रदान करती है। प्रमाणीकरण विकल्पों के त्वरित अवलोकन के लिए, देखें टेस्ट इंजन में प्रमाणीकरण.

प्रमाणीकरण के साथ आरंभ करना

टेस्ट इंजन कैनवास और मॉडल-संचालित अनुप्रयोगों के लिए वेब-आधारित परीक्षणों हेतु दो प्रमाणीकरण विधियों का समर्थन करता है:

  • StorageState - व्यक्तिगत विकास के लिए डिफ़ॉल्ट, आसान सेटअप (वेब-आधारित कैनवास और मॉडल-संचालित ऐप परीक्षणों के लिए)
  • Dataverse - परीक्षण उपयोगकर्ताओं और CI/CD को साझा करने के लिए टीम-आधारित दृष्टिकोण (वेब-आधारित कैनवास और मॉडल-संचालित ऐप परीक्षणों के लिए)

PowerFx प्रदाता और प्रत्यक्ष परीक्षणों के लिए प्रमाणीकरण को अलग तरीके से प्रबंधित किया जाता है। Dataverse ये परीक्षण संसाधन पहुँच टोकन प्राप्त करने के लिए az कमांड का उपयोग करके आपके लॉग इन Azure CLI सत्र से सीधे पहुँच टोकन प्राप्त करते हैं। इस प्रकार के परीक्षण चलाने से पहले सुनिश्चित करें कि आप az login --allow-no-subscriptions से लॉग इन हैं।

त्वरित सेटअप: स्टोरेजस्टेट प्रमाणीकरण

स्टोरेजस्टेट प्रमाणीकरण आरंभ करने का सबसे सरल तरीका है। यह आपके स्थानीय मशीन पर प्रमाणीकरण टोकन को सुरक्षित रूप से संग्रहीत करने के लिए विंडोज डेटा प्रोटेक्शन एपीआई का उपयोग करता है।

चरण 1: डिफ़ॉल्ट प्रमाणीकरण के साथ अपना परीक्षण चलाएँ

yourसे शुरू होने वाले पैरामीटर्स को प्रतिस्थापित करते हुए निम्नलिखित PowerShell कमांड चलाएँ।

pac test run `
   --provider canvas `
   --test-plan-file your-test-plan.yaml `
   --tenant your-tenant-id `
   --environment-id your-environment-id

नोट

इस उदाहरण में pac परीक्षण रन--user-auth पैरामीटर का उपयोग नहीं किया गया है क्योंकि डिफ़ॉल्ट प्रदाता StorageState है. आप चाहें तो इसे शामिल कर सकते हैं।

चरण 2: इंटरैक्टिव साइन-इन पूरा करें

अपने परीक्षण उपयोगकर्ता खाते के क्रेडेंशियल दर्ज करें

  1. एक ब्राउज़र विंडो स्वचालित रूप से खुलती है
  2. अपने परीक्षण उपयोगकर्ता खाते से लॉग इन करें
  3. यदि संकेत दिया जाए, तो MFA को स्वीकृति दें और सहमति संकेत दें
  4. संकेत मिलने पर "लॉग इन रहें" का चयन करें

आपका प्रमाणीकरण अब सुरक्षित हो गया है.

  • टेस्ट इंजन आपके प्रमाणीकरण को सुरक्षित रूप से संग्रहीत करता है
  • भविष्य के परीक्षण रन साइन-इन की आवश्यकता के बिना सहेजे गए राज्य का उपयोग करते हैं
  • आवश्यकता पड़ने पर टोकन स्वचालित रूप से रिफ्रेश हो जाते हैं

टीम सेटअप: Dataverse प्रमाणीकरण

Dataverse प्रमाणीकरण टीमों और CI/CD पाइपलाइनों के लिए एकदम सही है। यह प्रमाणित उपयोगकर्ता स्थिति को X.509 प्रमाणपत्रों के साथ एन्क्रिप्ट करके सुरक्षित रूप से संग्रहीत करता है। Dataverse

चरण 1: टेस्ट इंजन समाधान डाउनलोड करें और आयात करें

  1. Power Platform से समाधान डाउनलोड करें https://aka.ms/TestEngineAuth.
  2. Power Apps में साइन इन करें.
  3. अपना लक्ष्य वातावरण चुनें.
  4. समाधान पर जाएं और समाधान आयात करेंचुनें.
  5. टेस्ट इंजन समाधान अपलोड और स्थापित करने के लिए विज़ार्ड का पालन करें.

चरण 2: एन्क्रिप्शन के लिए प्रमाणपत्र बनाएँ

स्व-हस्ताक्षरित प्रमाणपत्र (केवल विकास) के लिए, निम्नलिखित PowerShell स्क्रिप्ट चलाएँ:

$Params = @{
  DnsName = @("testengine", "testengine")
  CertStoreLocation = "Cert:\CurrentUser\My"
  NotAfter = (Get-Date).AddMonths(6)
  KeyAlgorithm = "RSA"
  KeyLength = 2048
}
New-SelfSignedCertificate @Params

उत्पादन के लिए, अपने उद्यम प्रमाणपत्र प्राधिकारी से प्राप्त प्रमाणपत्र का उपयोग करें।

चरण 3: अपना परीक्षण उपयोगकर्ता सेट करें

अपना परीक्षण उपयोगकर्ता सेट अप करने के लिए निम्नलिखित चरण पूरे करें:

  1. अपना टर्मिनल खोलें और किसी भी मौजूदा सत्र से साइन आउट करें:

    # Clear Power Platform CLI credentials
    pac auth clear
    
    # Clear Azure CLI credentials
    az logout
    
  2. Azure CLI के साथ लॉग इन करें (प्रमाणीकरण के लिए आवश्यक): Dataverse

    az login --allow-no-subscriptions
    
  3. अपने प्रमाणपत्र का नाम PowerShell पर्यावरण चर नाम DataProtectionCertificateName के रूप में सेट करें:

    $env:DataProtectionCertificateName = "CN=testengine"
    
  4. अपना परीक्षण Dataverse प्रमाणीकरण के साथ चलाएँ:

    pac test run `
       --provider canvas `
       --user-auth Dataverse `
       --auth Certstore `
       --test-plan-file testplan.yaml `
       --tenant your-tenant-id `
       --environment-id your-environment-id
    

    नोट

    StorageState के विपरीत, इस मामले में आपको --user-auth पैरामीटर का उपयोग Dataverse के मान के साथ करना होगा।

  5. संकेत मिलने पर इंटरैक्टिव साइन-इन पूरा करें.

सेवा प्रिंसिपल सेट अप करना (CI/CD के लिए)

CI/CD पाइपलाइनों में स्वचालित परीक्षण के लिए, आप इंटरैक्टिव उपयोगकर्ता खातों के बजाय सेवा प्रिंसिपल का उपयोग कर सकते हैं।

चरण 1: Microsoft Entra आईडी में एक एप्लिकेशन पंजीकरण बनाएं

Microsoft Entra आईडी में एप्लिकेशन पंजीकरण बनाने के लिए निम्नलिखित चरणों को पूरा करें।

  1. Microsoft Entra व्यवस्थापक केंद्र में लॉग इन करें
  2. एप्लिकेशन>ऐप पंजीकरण पर जाएँ
  3. नया पंजीकरण चुनें
  4. नाम दर्ज करें (उदाहरण के लिए "टेस्ट इंजन ऑटोमेशन")
  5. डिफ़ॉल्ट विकल्प रखें और रजिस्टर करें चुनें
  6. निर्माण के बाद, एप्लिकेशन (क्लाइंट) आईडी और डायरेक्टरी (टेनेंट) आईडी नोट करें

चरण 2: इसके लिए API अनुमतियाँ कॉन्फ़िगर करें Dataverse

API अनुमतियाँ कॉन्फ़िगर करने के लिए निम्न चरणों को पूरा करें Dataverse.

  1. अपने एप्लिकेशन पंजीकरण में, API अनुमतियों पर जाएं
  2. अनुमति जोड़ें चुनें
  3. मेरे संगठन द्वारा उपयोग किए जाने वाले API चुनें
  4. खोजें और चुनें Dataverse
  5. प्रत्यायोजित अनुमतियाँ चुनें
  6. जाँच करें user_impersonation
  7. अनुमतियाँ जोड़ें चुनें
  8. व्यवस्थापक सहमति प्रदान करें चुनें

चरण 3: क्लाइंट सीक्रेट बनाएँ

क्लाइंट सीक्रेट बनाने के लिए निम्नलिखित चरणों को पूरा करें.

  1. प्रमाणपत्र और गोपनीयता पर जाएँ
  2. नया क्लाइंट सीक्रेट चुनें
  3. विवरण जोड़ें और समाप्ति तिथि चुनें
  4. गुप्त मान को तुरंत कॉपी करें (आप इसे दोबारा नहीं देख पाएंगे)

चरण 4: एप्लिकेशन उपयोगकर्ता को इसमें जोड़ें Dataverse

एप्लिकेशन उपयोगकर्ता को Dataverse में जोड़ने के लिए निम्नलिखित चरणों को पूरा करें.

  1. Power Platform व्यवस्थापक केंद्र खोलें
  2. अपना परिवेश चुनें
  3. सेटिंग>उपयोगकर्ता + अनुमतियाँ>एप्लिकेशन उपयोगकर्ता पर जाएँ
  4. + नया ऐप उपयोगकर्ता चुनें
  5. अपना आवेदन खोजें और चुनें
  6. उपयुक्त व्यावसायिक इकाई और सुरक्षा भूमिकाएँ असाइन करें (जिसमें "परीक्षण इंजन उपयोगकर्ता" भूमिका शामिल है)
  7. परिवर्तनों को सहेजें

चरण 5: अपनी CI/CD पाइपलाइन कॉन्फ़िगर करें

इन चरों को अपनी पाइपलाइन में जोड़ें:

AZURE_CLIENT_ID: (your application ID)
AZURE_CLIENT_SECRET: (your client secret)
AZURE_TENANT_ID: (your tenant ID)
DataProtectionCertificateValue: (base64 encoded certificate)
ENVIRONMENT_URL: (your Dataverse environment URL)

Azure DevOpsके लिए, इन्हें उचित अनुमतियों के साथ चर समूहों में सुरक्षित रूप से संग्रहीत करें।

PowerFx और प्रत्यक्ष Dataverse परीक्षण प्रमाणीकरण

PowerFx प्रदाता परीक्षणों और प्रत्यक्ष परीक्षणों के लिए, प्रमाणीकरण वेब-आधारित परीक्षणों की तुलना में अलग तरीके से काम करता है। Dataverse

PowerFx/Dataverse प्रमाणीकरण कैसे काम करता है

  1. टेस्ट इंजन संसाधन-विशिष्ट पहुँच टोकन प्राप्त करने के लिए Azure CLI का उपयोग करता है
  2. टोकन का उपयोग सीधे APIs के साथ प्रमाणीकरण के लिए किया जाता है Dataverse
  3. इसमें कोई ब्राउज़र या वेब-आधारित प्रमाणीकरण शामिल नहीं है

PowerFx/Dataverse प्रमाणीकरण सेट अप करना

  1. सुनिश्चित करें कि Azure CLI स्थापित और अद्यतित है:

    winget install -e --id Microsoft.AzureCLI
    # Or update it if already installed
    az upgrade
    
  2. Azure CLI के साथ लॉग इन करें:

    # The --allow-no-subscriptions flag is important as you may not have Azure subscriptions
    az login --allow-no-subscriptions
    
  3. PowerFx प्रदाता के साथ अपना परीक्षण चलाएँ:

    pac test run `
       --provider powerfx `
       --test-plan-file testplan.yaml `
       --tenant your-tenant-id `
       --environment-id your-environment-id `
       --domain "https://your-environment.crm.dynamics.com"
    

प्रमाणीकरण समस्या निवारण

इस अनुभाग में टेस्ट इंजन के साथ प्रमाणीकरण समस्या निवारण के बारे में जानकारी है।

StorageState से संबंधित सामान्य समस्याएं

  • समस्या: प्रत्येक रन पर प्रमाणीकरण संकेत प्रकट होता है।

    • समाधान: जाँचें कि क्या आपने लॉगइन के दौरान लॉगइन रहना चुना है।
  • समस्या: Cannot access secure storage त्रुटि.

    • समाधान: सुनिश्चित करें कि आपके पास अपने उपयोगकर्ता प्रोफ़ाइल फ़ोल्डर तक उचित पहुंच है।

Dataverse प्रमाणीकरण से जुड़ी आम समस्याएं

  • समस्या: Certificate not found त्रुटि.

    • समाधान: सत्यापित करें कि प्रमाणपत्र का नाम आपके प्रमाणपत्र संग्रह में मौजूद नाम से बिल्कुल मेल खाता है।
  • समस्या: Unable to connect to Dataverse त्रुटि.

    • समाधान: जाँचें कि Azure CLI az login --allow-no-subscriptions के साथ लॉग इन है.
  • समस्या: Access denied सेवा प्रिंसिपल के साथ त्रुटि.

    • समाधान: सत्यापित करें कि ऐप में सही अनुमतियाँ और उचित सुरक्षा भूमिकाएँ हैं. Dataverse

PowerFx/Dataverse प्रमाणीकरण से जुड़ी आम समस्याएं

  • समस्या: Unable to obtain access token त्रुटि

    • समाधान: सत्यापित करें कि आप Azure CLI का उपयोग करके लॉग इन हैं az account get-access-token
  • समस्या: Access denied से Dataverse

    • समाधान: सुनिश्चित करें कि आपके लॉग-इन उपयोगकर्ता के पास वातावरण में उचित अनुमतियाँ हैं Dataverse
  • समस्या: लंबे परीक्षण के दौरान टोकन की समाप्ति

    • समाधान: अधिक लंबी टोकन समाप्ति अवधि वाले सेवा प्रिंसिपल का उपयोग करें या परीक्षण चरणों में पुनः प्रमाणीकरण को संभालें

प्रमाणीकरण सुरक्षा वास्तुकला
परीक्षण कैनवास अनुप्रयोग
मॉडल-संचालित अनुप्रयोगों का परीक्षण करें
टेस्ट Dataverse एक्सटेंशन