Hitelesítési útmutató Power Apps tesztmotorhoz (elavult)

Megjegyzés:

A tesztmotor elavult, és egy későbbi kiadásban el lesz távolítva. Power Platform Playwright-minták használata a Power Platform és Dynamics 365 szolgáltatások automatizálási képességeinek teszteléséhez.

Ez az útmutató lépésről lépésre ismerteti a hitelesítés beállítását a Test Engine-ben. A hitelesítési lehetőségek gyors áttekintését lásd: Hitelesítés a tesztmotorban.

A hitelesítés első lépései

A Test Engine két hitelesítési módszert támogat a vászonalapú és modellvezérelt alkalmazások webalapú tesztjeihez:

  • StorageState – Alapértelmezett, egyszerű beállítás egyéni fejlesztéshez (webalapú vászon- és modellvezérelt alkalmazástesztekhez)
  • Dataverse - Csapatalapú megközelítés a tesztfelhasználók és a CI/CD megosztásához (webalapú vászon- és modellvezérelt alkalmazástesztekhez)

A hitelesítés kezelése a PowerFx-szolgáltató és a közvetlen Dataverse tesztek esetében eltérő. Az ezekben a tesztekben a hozzáférési jogkivonatok közvetlenül az Azure CLI-hez bejelentkezett munkamenetből lesznek megszerezve, az erőforrás-hozzáférési jogkivonatok lekérésére szolgáló az parancsok használatával. Az ilyen típusú tesztek futtatása előtt győződjön meg arról, hogy be van jelentkezve az login --allow-no-subscriptions .

Gyors telepítés: StorageState hitelesítés

A StorageState hitelesítés a legegyszerűbb módja az első lépéseknek. A Windows Data Protection API használatával biztonságosan tárolja a hitelesítési jogkivonatokat a helyi gépen.

1. lépés: A teszt futtatása alapértelmezett hitelesítéssel

Futtassa a következő PowerShell-parancsot, amely lecseréli a következővel your kezdődő paramétereket:

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

Megjegyzés:

Ebben a példában a pac tesztfuttatási--user-auth paraméter nem használatos, mert az alapértelmezett szolgáltató igen StorageState. Ha szeretné, beillesztheti.

2. lépés: Az interaktív bejelentkezés befejezése

Adja meg a tesztfelhasználói fiók hitelesítő adatait

  1. A böngészőablak automatikusan megnyílik
  2. Jelentkezzen be tesztfelhasználói fiókjával
  3. Ha a rendszer azt kéri, hagyja jóvá a többtényezős hitelesítést (MFA) és a hozzájárulási kéréseket.
  4. Válassza a "Bejelentkezve marad" lehetőséget, amikor a rendszer kéri

A hitelesítés mentésre került.

  • A Test Engine biztonságosan tárolja a hitelesítést
  • A jövőbeli tesztfuttatások a mentett állapotot használják bejelentkezés nélkül
  • Szükség esetén a tokenek automatikusan frissülnek

Csapatbeállítás: Dataverse hitelesítés

Dataverse-hitelesítés tökéletes csapatok, és CI/CD-folyamatok számára. Biztonságosan tárolja a hitelesített felhasználói állapotokat Dataverse, X.509 tanúsítványokkal titkosítva.

1. lépés: A Test Engine megoldás letöltése és importálása

  1. Töltse le a Power Platform megoldást innen https://aka.ms/TestEngineAuth.
  2. Jelentkezzen be a Power Apps rendszerbe.
  3. Válassza ki a célkörnyezetet.
  4. Lépjen a Megoldások elemre, és válassza a Megoldás importálása lehetőséget .
  5. A varázslót követve töltse fel és telepítse a Test Engine megoldást.

2. lépés: Tanúsítvány létrehozása titkosításhoz

Önaláírt tanúsítvány esetén (csak fejlesztés esetén) futtassa ezt a következő PowerShell-szkriptet:

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

Gyártási környezetben használja a vállalati hitelesítésszolgáltató tanúsítványát.

3. lépés: A tesztfelhasználó beállítása

A tesztfelhasználó beállításához hajtsa végre az alábbi lépéseket:

  1. Nyissa meg a terminált, és jelentkezzen ki a meglévő munkamenetekből:

    # Clear Power Platform CLI credentials
pac auth clear

# Clear Azure CLI credentials
az logout

  2. Jelentkezzen be az Azure CLI-vel (a hitelesítéshez Dataverse szükséges):

    az login --allow-no-subscriptions

  3. Állítsa be a tanúsítvány nevét egy PowerShell-környezeti változóként DataProtectionCertificateName:

    $env:DataProtectionCertificateName = "CN=testengine"

  4. Futtassa a tesztet a Dataverse hitelesítésével:

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

    Megjegyzés:

    A StorageState értékétől eltérően ebben az esetben a --user-auth paramétert az Dataverse értékkel kell használnia.

  5. Végezze el az interaktív bejelentkezést, amikor a rendszer kéri.

Szolgáltatásnevek beállítása (CI/CD esetén)

A CI/CD-folyamatok automatizált teszteléséhez interaktív felhasználói fiókok helyett szolgáltatásneveket használhat.

1. lépés: Alkalmazásregisztráció létrehozása a Microsoft Entra ID-ben

A következő lépésekkel hozhat létre egy alkalmazás regisztrációját a Microsoft Entra azonosítóban.

  1. Jelentkezzen be a Microsoft Entra felügyeleti központba
  2. Lépjen az Alkalmazások alkalmazásregisztrációk lapra>
  3. Válassza az Új regisztráció lehetőséget
  4. Adjon meg egy nevet (például "Tesztmotor automatizálása")
  5. Tartsa meg az alapértelmezett beállításokat, és válassza a Regisztráció lehetőséget
  6. A létrehozás után jegyezze fel az alkalmazás (ügyfél) azonosítóját és a címtár (bérlő) azonosítóját

2. lépés: API-engedélyek konfigurálása Dataverse

A Dataverse számára az API-engedélyek konfigurálásához kövesse az alábbi lépéseket.

  1. Az alkalmazásregisztrációban lépjen az API-engedélyek elemre
  2. Válassza az Engedély hozzáadása lehetőséget
  3. A szervezet által használt API-k kiválasztása
  4. Keresse meg és válassza ki Dataverse
  5. Válassza a Delegált engedélyek lehetőséget
  6. Ellenőrizze user_impersonation
  7. Válassza az Engedélyek hozzáadása lehetőséget
  8. Válassza a Rendszergazdai jóváhagyás megadása lehetőséget

3. lépés: Titkos ügyfélkód létrehozása

Titkos ügyfélkód létrehozásához kövesse az alábbi lépéseket.

  1. Ugrás a Tanúsítványok és titkos kulcsok elemre
  2. Válassza az Új titkos ügyfélkód lehetőséget
  3. Adjon hozzá egy leírást és válassza ki a lejáratot
  4. Azonnal másolja ki a titkos értéket (nem láthatja újra)

4. lépés: Az alkalmazás felhasználójának hozzáadása Dataverse

Az alkalmazás felhasználójának Dataverse hozzáadásához kövesse az alábbi lépéseket.

  1. Nyissa meg a Power Platform Felügyeleti központot
  2. Válassza ki a környezetét
  3. Lépjen a Beállítások Felhasználók + engedélyek>elemre>Alkalmazásfelhasználók
  4. Válassza a + új alkalmazásfelhasználó lehetőséget
  5. Keresse meg és válassza ki az alkalmazást
  6. Rendelje hozzá a megfelelő részleget és biztonsági szerepköröket (beleértve a "Tesztmotor felhasználója" szerepkört)
  7. Mentse a módosításokat.

5. lépés: A CI/CD-folyamat konfigurálása

Adja hozzá a következő változókat a folyamathoz:

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)

Mert Azure DevOps biztonságosan tárolja ezeket változócsoportokban a megfelelő engedélyekkel.

PowerFx és közvetlen Dataverse teszthitelesítés

A PowerFx-szolgáltatói tesztek és a közvetlen Dataverse tesztek esetében a hitelesítés másképp működik, mint a webalapú teszteknél.

A PowerFx/Dataverse hitelesítés működése

  1. A tesztmotor az Azure CLI-t használja egy erőforrás-specifikus hozzáférési jogkivonat beszerzéséhez
  2. A token közvetlen hitelesítésre szolgál a Dataverse API-kal
  3. Nincs szükség böngészőre vagy webalapú hitelesítésre

A PowerFx/Dataverse hitelesítés beállítása

  1. Győződjön meg arról, hogy a Azure CLI telepítve van és naprakész:

    winget install -e --id Microsoft.AzureCLI
# Or update it if already installed
az upgrade

  2. Bejelentkezés az Azure CLI-vel:

    # The --allow-no-subscriptions flag is important as you may not have Azure subscriptions
az login --allow-no-subscriptions

  3. Futtassa a tesztet a PowerFx-szolgáltatóval:

    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"

Hitelesítés hibaelhárítása

Ez a szakasz a Test Engine hitelesítéssel kapcsolatos hibaelhárításról tartalmaz információkat.

A StorageState gyakori problémái

  • Probléma: A hitelesítési kérés minden futtatáskor megjelenik.

    • Megoldás: Ellenőrizze, hogy a bejelentkezés során a Bejelentkezve maradás lehetőséget választotta-e .

  • Probléma: Cannot access secure storage hiba.

    • Megoldás: Győződjön meg arról, hogy megfelelő hozzáféréssel rendelkezik a felhasználói profil mappájához.

A hitelesítéssel kapcsolatos Dataverse gyakori problémák

  • Probléma: Certificate not found hiba.

    • Megoldás: Ellenőrizze, hogy a tanúsítvány neve pontosan megegyezik-e a tanúsítványtárolóban található névvel.

  • Probléma: Unable to connect to Dataverse hiba.

    • Megoldás: Ellenőrizze, hogy az Azure CLI be van-e jelentkezve az login --allow-no-subscriptions.

  • Probléma: Access denied hiba a szolgáltatás főképviselővel.

    • Megoldás: Ellenőrizze, hogy az alkalmazás rendelkezik-e megfelelő engedélyekkel Dataverse és megfelelő biztonsági szerepkörökkel.

A PowerFx/Dataverse hitelesítéssel kapcsolatos gyakori problémák

  • probléma: Unable to obtain access token hiba

    • Megoldás: Ellenőrizze, hogy be van-e jelentkezve az Azure CLI használatával az account get-access-token

  • Probléma: Access denied a Dataverse

    • Megoldás: Győződjön meg arról, hogy a bejelentkezett felhasználó rendelkezik a megfelelő engedélyekkel a Dataverse környezetben

  • Probléma: Token lejárata hosszú tesztfuttatások során

    • Megoldás: Használjon szolgáltatási főkomponenst hosszabb lejáratú jogkivonattal, vagy kezelje az újrahitelesítést a tesztelési lépések során.

Hitelesítési biztonsági architektúra
Tesztelje a vászonalkalmazásokat
Modellvezérelt alkalmazások tesztelése
Dataverse bővítmények tesztelése

  • Last updated on