Playwright-munkaterületek hitelesítésének és engedélyezésének kezelése

Ebből a cikkből megtudhatja, hogyan kezelheti a Playwright-munkaterületek hitelesítését és engedélyezését. A Playwright-tesztek felhőben üzemeltetett böngészőkben való futtatásához hitelesítés szükséges.

A rendszer alapértelmezés szerint a Microsoft Entra-azonosítót használja a hitelesítéshez. Ez a módszer biztonságosabb, és az ajánlott hitelesítési módszer. Nem tilthatja le a hitelesítést a Microsoft Entra ID használatával. A hitelesítéshez és engedélyezéshez azonban hozzáférési jogkivonatokat is használhat.

Háttér

A Playwright-munkaterületek a Playwright nyílt forráskódú keretrendszerére épülnek. Playwright-teszteket futtat a felhőben üzemeltetett böngészőkben.

A szolgáltatás használatához az ügyfélnek hitelesítenie kell magát a szolgáltatással a böngészők eléréséhez. A szolgáltatás két hitelesítési módszert kínál: a Microsoft Entra-azonosítót és a hozzáférési jogkivonatokat.

A Microsoft Entra ID az Azure-beli hitelesítő adatait használja, és bejelentkezést igényel az Azure-fiókjába a biztonságos hozzáférés érdekében. Másik lehetőségként létrehozhat egy hozzáférési jogkivonatot a Playwright-munkaterületről, és használhatja azt a beállításban. A fokozott biztonság miatt azonban erősen ajánljuk a Microsoft Entra ID-t a hitelesítéshez. A hozzáférési jogkivonatok, bár kényelmesek, úgy működnek, mint a hosszú élettartamú jelszavak, és fokozottabban kitettek a kompromittálódás veszélyének.

Hitelesítés engedélyezése hozzáférési jogkivonatokkal

Alapértelmezés szerint a Playwright-munkaterületek a Microsoft Entra-azonosítót használják a hitelesítéshez, ami az ajánlott módszer. Bár a hozzáférési jogkivonat-hitelesítés támogatott, alapértelmezés szerint le van tiltva, mert kevésbé biztonságos. A hozzáférési jogkivonatok használatához explicit módon engedélyeznie kell ezt a beállítást a munkaterületen.

Figyelmeztetés

A munkaterület hozzáférési jogkivonatai hasonlóak a Playwright-munkaterület jelszavához. Mindig ügyeljen a hozzáférési jogkivonatok védelmére. Kerülje a hozzáférési jogkivonatok terjesztését más felhasználók számára, ne kódolódjanak be, és ne mentse őket más felhasználók számára hozzáférhető egyszerű szövegekben. Visszavonhatja és újból létrehozhatja a jogkivonatokat, ha úgy véli, hogy azok sérültek.

A hitelesítés engedélyezése hozzáférési jogkivonatokkal:

1. Jelentkezzen be az Azure Portalra az Azure-fiókjával, és lépjen a munkaterületre.

2. A Beállítások szakaszban válassza az Access Management lehetőséget.

3. Az engedélyezéshez jelölje be a Playwright szolgáltatás hozzáférési jogkivonatának jelölőnégyzetét.

Figyelmeztetés

A hozzáférési jogkivonatokkal végzett hitelesítés kevésbé biztonságos. A hozzáférési jogkivonatok kezelésének ismertetése

Hitelesítés beállítása hozzáférési jogkivonatokkal

1. A tesztek futtatása közben engedélyezze a hozzáférési jogkivonat hitelesítését a playwright.service.config.ts telepítő fájljában.

   import { createAzurePlaywrightConfig, ServiceAuth } from '@azure/playwright';
   
   /* Learn more about service configuration at https://aka.ms/pww/docs/config */
   export default defineConfig(config, createAzurePlaywrightConfig( config, {
       serviceAuthType: ServiceAuth.ACCESS_TOKEN
   }));
   

1. A tesztek futtatása közben engedélyezze a hozzáférési jogkivonat hitelesítését a telepítőfájlban.

   using Azure.Developer.Playwright.NUnit;
   using Azure.Developer.Playwright;
   using Azure.Identity;
   using System.Runtime.InteropServices;
   using System;
   
   namespace PlaywrightService.SampleTests; // Remember to change this as per your project namespace
   
   [SetUpFixture]
   public class PlaywrightServiceNUnitSetup : PlaywrightServiceBrowserNUnit
   {
       public PlaywrightServiceNUnitSetup() : base(
           credential: new DefaultAzureCredential(),
           options: new PlaywrightServiceBrowserClientOptions()
           {
               ServiceAuth = ServiceAuthType.AccessToken
           }
       )
       {
           // no-op
       }
   }
   

2. Hozzáférési jogkivonat létrehozása.

   A hozzáférési jogkivonat létrehozásához kövesse az alábbi lépéseket. Másolja ki a létrehozott hozzáférési jogkivonat értékét.

Állítsd be a környezetet.

A környezet beállításához konfigurálja a PLAYWRIGHT_SERVICE_ACCESS_TOKEN környezeti változót az előző lépésekben kapott értékkel. Győződjön meg arról, hogy ez a környezeti változó elérhető a beállításban, ahol teszteket futtat.

Javasoljuk, hogy a dotenv modullal kezelje a környezetet. Ezzel dotenvdefiniálja a környezeti változókat a .env fájlban.

1. Adja hozzá a modult dotenv a projekthez:

   npm i --save-dev dotenv
   

2. Hozzon létre egy .env fájlt a playwright.config.ts fájl mellett a Playwright-projektben:

   PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}
   

   Ügyeljen arra, hogy a {MY-ACCESS-TOKEN} szöveghelyőrzőt cserélje le a korábban másolt értékre.

A környezet beállításához konfigurálja a PLAYWRIGHT_SERVICE_ACCESS_TOKEN környezeti változót az előző lépésekben kapott értékkel. Győződjön meg arról, hogy ez a környezeti változó elérhető a beállításban, ahol teszteket futtat.

Tesztek futtatása a szolgáltatáson

Forgatókönyv-teszteket futtathat a felhőben üzemeltetett böngészőken a fent létrehozott konfigurációval.

npx playwright test --config=playwright.service.config.ts --workers=20

dotnet test -- NUnit.NumberOfTestWorkers=20

Kapcsolódó tartalom

• További információ a hozzáférési jogkivonatok kezeléséről.