دليل المصادقة لمحرك اختبار Power Apps (مهمل)

ملحوظة

تم إهمال محرك الاختبار وسيتم إزالته في إصدار مستقبلي. استخدم Power Platform Playwright samples لقدرات أتمتة الاختبار في Power Platform وخدمات Dynamics 365.

يوفر هذا الدليل إرشادات خطوة بخطوة لإعداد المصادقة في Test Engine. للحصول على نظرة عامة سريعة على خيارات المصادقة، راجع المصادقة في محرك الاختبار.

بدء استخدام المصادقة

يدعم Test Engine طريقتين للمصادقة للاختبارات المستندة إلى الويب للتطبيقات المستندة إلى اللوحة والتطبيقات المستندة إلى النموذج:

  • StorageState - إعداد افتراضي سهل للتطوير الفردي (لاختبارات اللوحة المستندة إلى الويب والتطبيقات المستندة إلى النموذج)
  • Dataverse - النهج المستند إلى الفريق لمشاركة مستخدمي الاختبار و CI/CD (لاختبارات اللوحة المستندة إلى الويب والتطبيقات المستندة إلى النموذج)

يتم التعامل مع المصادقة بشكل مختلف بين مزود PowerFx واختبارات Dataverse المباشرة. تحصل هذه الاختبارات على رموز الوصول مباشرة من الجلسة المسجلة في Azure CLI الخاصة بك باستخدام أوامر az للحصول على رموز الوصول إلى الموارد. تأكد من تسجيل الدخول باستخدام az login --allow-no-subscriptions قبل تشغيل هذه الأنواع من الاختبارات.

الإعداد السريع: مصادقة StorageState

مصادقة StorageState هي أبسط طريقة للبدء. يستخدم Windows Data Protection API لتخزين رموز المصادقة المميزة بشكل آمن على جهازك المحلي.

الخطوة 1: قم بتشغيل الاختبار باستخدام المصادقة الافتراضية

قم بتشغيل أمر PowerShell التالي لاستبدال المعلمات التي تبدأ ب your.

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. إذا طُلب منك، قم بالموافقة على المصادقة متعددة العوامل وإشعارات الموافقة
  4. حدد "البقاء قيد تسجيل الدخول" عندما يطلب منك ذلك

تم حفظ المصادقة الخاصة بك الآن.

  • يخزن محرك الاختبار المصادقة الخاصة بك بشكل آمن
  • تستخدم عمليات تشغيل الاختبار المستقبلية الحالة المحفوظة دون الحاجة إلى تسجيل الدخول
  • يتم تحديث الرموز المميزة تلقائيا عند الحاجة

إعداد الفريق: مصادقة 'Dataverse'

التحقق في Dataverse مثالي للفرق ومسارات CI/CD. يقوم بتخزين حالات المستخدم المصادق عليها بشكل آمن في Dataverse، وتشفيرها بشهادات X.509.

الخطوة 1: تنزيل حل Test Engine واستيراده

  1. قم بتنزيل الحل Power Platform من https://aka.ms/TestEngineAuth.
  2. سجل الدخول إلى Power Apps.
  3. حدد بيئتك المستهدفة.
  4. انتقل إلى الحلول وحدد استيراد الحل.
  5. اتبع معالج التثبيت لتحميل وتثبيت حل Test Engine.

الخطوة 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 ID

أكمل الخطوات التالية لإنشاء تسجيل تطبيق في Microsoft Entra ID.

  1. سجل الدخول إلى مركز مسؤولي Microsoft Entra
  2. انتقل إلى التطبيقات>تسجيلات التطبيقات
  3. حدد تسجيل جديد
  4. أدخل اسما (على سبيل المثال "اختبار أتمتة المحرك")
  5. احتفظ بالخيارات الافتراضية وحدد تسجيل
  6. بعد الإنشاء، لاحظ معرف التطبيق (العميل) ومعرف الدليل (المستأجر)

الخطوة 2: تكوين أذونات واجهة برمجة التطبيقات ل Dataverse

أكمل الخطوات التالية لتكوين أذونات واجهة برمجة تطبيقات Dataverse.

  1. في تسجيل التطبيق الخاص بك، انتقل إلى أذونات واجهة برمجة التطبيقات
  2. حدد إضافة إذن
  3. اختيار واجهات برمجة التطبيقات التي تستخدمها مؤسستي
  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. يستخدم Test Engine Azure CLI للحصول على رمز وصول خاص بالموارد
  2. يتم استخدام الرمز المميز للمصادقة مباشرة مع واجهات برمجة التطبيقات لـ 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

  • Last updated on