Dela via

Hantera autentisering och auktorisering för förhandsversionen av Microsoft Playwright Testing

  • Artikel

I den här artikeln får du lära dig hur du hanterar autentisering och auktorisering för förhandsversionen av Microsoft Playwright Testing. Autentisering krävs för att köra Playwright-tester på molnbaserade webbläsare och för att publicera testresultat och artefakter till tjänsten.

Som standard används Microsoft Entra-ID för autentisering. Den här metoden är säkrare och är den rekommenderade autentiseringsmetoden. Du kan inte inaktivera autentisering med Microsoft Entra-ID. Du kan dock också använda åtkomsttoken för att autentisera och auktorisera.

Viktigt!

Microsoft Playwright Testing är för närvarande i förhandsversion. Juridiska villkor som gäller för Azure-funktioner som är i betaversion, förhandsversion eller som ännu inte har släppts i allmän tillgänglighet finns i Kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.

Bakgrund

Förhandsversionen av Microsoft Playwright Testing bygger på ramverket för dramatiker med öppen källkod. Den kör Playwright-tester i molnbaserade webbläsare och publicerar rapporter och artefakter tillbaka till tjänsten.

Om du vill använda tjänsten måste klienten autentisera med tjänsten för att få åtkomst till webbläsarna. På samma sätt kräver publicering av resultat och artefakter autentiserade API-interaktioner. Tjänsten erbjuder två autentiseringsmetoder: Microsoft Entra-ID och åtkomsttoken.

Microsoft Entra-ID använder dina Azure-autentiseringsuppgifter och kräver en inloggning till ditt Azure-konto för säker åtkomst. Du kan också generera en åtkomsttoken från din Playwright-arbetsyta och använda den i konfigurationen. Vi rekommenderar dock starkt Microsoft Entra-ID för autentisering på grund av den förbättrade säkerheten. Åtkomsttoken fungerar, även om de är praktiska, som långlivade lösenord och är mer mottagliga för att komprometteras.

Aktivera autentisering med hjälp av åtkomsttoken

Microsoft Playwright Testing Service stöder även autentisering med hjälp av åtkomsttoken. Den här autentiseringsmetoden är mindre säker. Vi rekommenderar att du använder Microsoft Entra-ID för att autentisera till tjänsten.

Varning

Åtkomsttoken för arbetsytan liknar ett lösenord för din Microsoft Playwright Testing-arbetsyta. Var alltid noga med att skydda dina åtkomsttoken. Undvik att distribuera åtkomsttoken till andra användare, hårdkoda dem eller spara dem var som helst i oformaterad text som är tillgänglig för andra.

Återkalla och återskapa dina token om du tror att de har komprometterats.

Så här aktiverar du autentisering med hjälp av åtkomsttoken:

  1. Logga in på Playwright-portalen med ditt Azure-konto och välj din arbetsyta.

  2. Välj inställningsikonen på startsidan för att gå till arbetsyteinställningarna.

  3. Välj sidan Autentisering och aktivera Aktivera autentisering med hjälp av åtkomsttoken

    Skärmbild som visar inställningssidan för åtkomsttoken i Playwright-portalen.

Varning

Autentisering med åtkomsttoken är mindre säkert. Lär dig hur du hanterar åtkomsttoken

Konfigurera autentisering med hjälp av åtkomsttoken

  1. När du kör testerna aktiverar du autentisering av åtkomsttoken i filen i konfigurationen playwright.service.config.ts .

    /* Learn more about service configuration at https://aka.ms/mpt/config */
export default defineConfig(config, getServiceConfig( config {
    serviceAuthType:'ACCESS_TOKEN'
}));

  1. När du kör testerna aktiverar du autentisering av åtkomsttoken i filen i konfigurationen .runsettings .

    <TestRunParameters>
    <!-- Use this option when you want to authenticate using access tokens. This mode of auth should be enabled for the workspace. -->
     <Parameter name="ServiceAuthType" value="AccessToken" />
</TestRunParameters>

  1. Skapa åtkomsttoken

    Följ stegen för att skapa en åtkomsttoken. Kopiera värdet för den åtkomsttoken som genererats.

  1. Konfigurera din miljö

    Konfigurera miljön genom att konfigurera PLAYWRIGHT_SERVICE_ACCESS_TOKEN miljövariabeln med det värde som du fick i föregående steg. Se till att den här miljövariabeln är tillgänglig i konfigurationen där du kör tester.

    Vi rekommenderar att du använder modulen dotenv för att hantera din miljö. Med dotenvdefinierar du dina miljövariabler i .env filen.

    1. Lägg till modulen i dotenv projektet:

      npm i --save-dev dotenv

    2. Skapa en .env fil tillsammans med playwright.config.ts filen i ditt Playwright-projekt:

      PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}

      Ersätt {MY-ACCESS-TOKEN} textplatshållaren med det värde som du kopierade tidigare.

  1. Konfigurera din miljö

    Konfigurera miljön genom att konfigurera PLAYWRIGHT_SERVICE_ACCESS_TOKEN miljövariabeln med det värde som du fick i föregående steg. Se till att den här miljövariabeln är tillgänglig i konfigurationen där du kör tester.

Köra tester på tjänsten och publicera resultat

Kör Playwright-tester mot molnbaserade webbläsare och publicera resultatet till tjänsten med hjälp av konfigurationen som du skapade ovan.

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

dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20

Relaterat innehåll