Delen via

Verificatie en autorisatie beheren voor Playwright-werkruimten

In dit artikel leert u hoe u verificatie en autorisatie voor Playwright-werkruimten beheert. Verificatie is vereist om Playwright-tests uit te voeren op in de cloud gehoste browsers.

Microsoft Entra-id wordt standaard gebruikt voor verificatie. Deze methode is veiliger en is de aanbevolen verificatiemethode. U kunt verificatie niet uitschakelen met behulp van Microsoft Entra-id. U kunt echter ook toegangstokens gebruiken om te verifiëren en autoriseren.

Achtergrond

Playwright Workspaces is gebouwd op het opensource-framework playwright. Er worden Playwright-tests uitgevoerd op in de cloud gehoste browsers.

Als u de service wilt gebruiken, moet de client worden geverifieerd met de service om toegang te krijgen tot de browsers. De service biedt twee verificatiemethoden: Microsoft Entra ID en toegangstokens.

Microsoft Entra ID maakt gebruik van uw Azure-referenties, waarvoor een aanmelding bij uw Azure-account is vereist voor beveiligde toegang. U kunt ook een toegangstoken genereren vanuit uw Playwright-werkruimte en deze gebruiken in uw installatie. We raden Microsoft Entra ID echter ten zeerste aan voor verificatie vanwege de verbeterde beveiliging. Toegangstokens zijn weliswaar handig, maar functioneren als wachtwoorden met een lange levensduur en zijn vatbaarder voor compromittering.

Verificatie inschakelen met toegangstokens

Playwright Workspaces maakt standaard gebruik van Microsoft Entra ID voor verificatie. Dit is de aanbevolen benadering. Hoewel verificatie van toegangstokens wordt ondersteund, wordt deze standaard uitgeschakeld omdat het minder veilig is. Als u toegangstokens wilt gebruiken, moet u deze optie expliciet inschakelen voor uw werkruimte.

Waarschuwing

Uw toegangstokens voor werkruimten zijn vergelijkbaar met een wachtwoord voor uw Playwright-werkruimte. Wees altijd voorzichtig met het beveiligen van uw toegangstokens. Vermijd het distribueren van toegangstokens naar andere gebruikers, het coderen ervan of het opslaan van tokens in tekst zonder opmaak die toegankelijk is voor anderen. Uw tokens intrekken en opnieuw maken als u denkt dat ze zijn aangetast.

Verificatie inschakelen met behulp van toegangstokens:

  1. Meld u aan bij Azure Portal met uw Azure-account en navigeer naar uw werkruimte.

  2. Selecteer Access Management in de sectie Instellingen.

  3. Schakel het selectievakje voor het Token voor playwright-servicetoegang in om dit in te schakelen.

Schermopname van het inschakelen van verificatie met behulp van toegangstokens.

Waarschuwing

Verificatie met behulp van toegangstokens is minder veilig. Meer informatie over het beheren van toegangstokens

Verificatie instellen met behulp van toegangstokens

  1. Schakel tijdens het uitvoeren van de tests verificatie van het toegangstoken in het playwright.service.config.ts bestand in uw installatie in.

    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. Schakel tijdens het uitvoeren van de tests verificatie van het toegangstoken in het installatiebestand in.

    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
    }
}

  1. Maak een toegangstoken.

    Volg de stappen om een toegangstoken te maken. Kopieer de waarde van het gegenereerde toegangstoken.

Stel uw omgeving in.

Als u uw omgeving wilt instellen, configureert u de PLAYWRIGHT_SERVICE_ACCESS_TOKEN omgevingsvariabele met de waarde die u in de vorige stappen hebt verkregen. Zorg ervoor dat deze omgevingsvariabele beschikbaar is in uw installatie waar u tests uitvoert.

U wordt aangeraden de dotenv module te gebruiken om uw omgeving te beheren. Met dotenv, definieert u uw omgevingsvariabelen in het .env bestand.

  1. Voeg de dotenv module toe aan uw project:

    npm i --save-dev dotenv

  2. Maak een .env bestand naast het bestand in uw playwright.config.ts Playwright-project:

    PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}

    Zorg ervoor dat u de tijdelijke aanduiding voor tekst {MY-ACCESS-TOKEN} vervangt door de waarde die u eerder hebt gekopieerd.

Als u uw omgeving wilt instellen, configureert u de PLAYWRIGHT_SERVICE_ACCESS_TOKEN omgevingsvariabele met de waarde die u in de vorige stappen hebt verkregen. Zorg ervoor dat deze omgevingsvariabele beschikbaar is in uw installatie waar u tests uitvoert.

Tests uitvoeren op de service

Voer Playwright-tests uit op browsers die in de cloud worden gehost met behulp van de configuratie die u hierboven hebt gemaakt.

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

dotnet test -- NUnit.NumberOfTestWorkers=20

Verwante inhoud

  • Last updated on