Gerenciar autenticação e autorização para espaços de trabalho Playwright

Neste artigo, você aprenderá a gerenciar a autenticação e a autorização para espaços de trabalho de Playwright. A autenticação é necessária para executar testes Playwright em navegadores hospedados na nuvem.

Por padrão, o Microsoft Entra ID é usado para autenticação. Este método é mais seguro e é o método de autenticação recomendado. Não é possível desativar a autenticação usando o Microsoft Entra ID. No entanto, você também pode usar tokens de acesso para autenticar e autorizar.

Contexto geral

Playwright Workspaces é construído sobre a estrutura de código aberto Playwright. Ele executa testes Playwright em navegadores hospedados na nuvem.

Para usar o serviço, o cliente deve autenticar-se com o serviço para acessar os navegadores. O serviço oferece dois métodos de autenticação: ID do Microsoft Entra e tokens de acesso.

O Microsoft Entra ID usa suas credenciais do Azure, exigindo uma entrada em sua conta do Azure para acesso seguro. Como alternativa, você pode gerar um token de acesso a partir do seu espaço de trabalho Playwright e usá-lo em sua configuração. No entanto, recomendamos vivamente o Microsoft Entra ID para autenticação devido à sua segurança melhorada. Os tokens de acesso, embora convenientes, funcionam como senhas de longa duração e são mais suscetíveis a serem comprometidos.

Habilitar autenticação usando tokens de acesso

Por padrão, o Playwright Workspaces usa o Microsoft Entra ID para autenticação, que é a abordagem recomendada. Embora a autenticação de token de acesso seja suportada, ela é desabilitada por padrão porque é menos segura. Para usar tokens de acesso, você deve habilitar explicitamente essa opção para seu espaço de trabalho.

Atenção

Os tokens de acesso ao espaço de trabalho são semelhantes a uma senha para o espaço de trabalho Playwright. Tenha sempre o cuidado de proteger os seus tokens de acesso. Evite distribuir tokens de acesso para outros usuários, codificá-los ou salvá-los em qualquer lugar em texto simples acessível a outras pessoas. Revogue e recrie seus tokens se acreditar que eles estão comprometidos.

Para habilitar a autenticação usando tokens de acesso:

Entre no portal do Azure com sua conta do Azure e navegue até seu espaço de trabalho.
Na seção Configurações , selecione Gerenciamento de acesso.
Marque a caixa para Playwright Service Access Token para ativá-lo.

Atenção

A autenticação usando tokens de acesso é menos segura. Saiba como gerenciar tokens de acesso

Configurar a autenticação usando tokens de acesso

Ao executar os testes, habilite a autenticação do token de acesso no playwright.service.config.ts arquivo em sua configuração.

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

Ao executar os testes, habilite a autenticação do token de acesso no arquivo de instalação.

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

Crie um token de acesso.

Siga as etapas para criar um token de acesso. Copie o valor do token de acesso gerado.

Configure seu ambiente.

Para configurar seu ambiente, configure a PLAYWRIGHT_SERVICE_ACCESS_TOKEN variável de ambiente com o valor obtido nas etapas anteriores. Verifique se essa variável de ambiente está disponível em sua configuração onde você está executando testes.

Recomendamos que você use o dotenv módulo para gerenciar seu ambiente. Com dotenvo , você define suas variáveis de .env ambiente no arquivo.

Adicione o dotenv módulo ao seu projeto:
```
npm i --save-dev dotenv
```
Crie um .env arquivo ao lado do playwright.config.ts arquivo em seu projeto Playwright:
```
PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}
```
Certifique-se de substituir o espaço reservado para texto {MY-ACCESS-TOKEN} pelo valor copiado anteriormente.

Executar testes no serviço

Execute testes Playwright em navegadores hospedados na nuvem usando a configuração que você criou acima.

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

dotnet test -- NUnit.NumberOfTestWorkers=20

Saiba mais sobre como gerenciar tokens de acesso.

Feedback

Esta página foi útil?

Last updated on 2025-08-30