Compartilhar via

Gerenciar a autenticação e a autorização para a versão prévia do Microsoft Playwright Testing

  • Artigo

Neste artigo, você aprenderá a gerenciar a autenticação e a autorização para a versão prévia do Microsoft Playwright Testing. A autenticação é necessária para executar testes do Playwright em navegadores hospedados na nuvem e para publicar resultados de testes e artefatos no serviço.

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

Importante

O Microsoft Playwright Testing está atualmente em pré-visualização. Para os termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral, confira os Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

Tela de fundo

O Microsoft Playwright Testing Preview foi compilado com base na estrutura de código aberto do Playwright. Ele executa testes do Playwright em navegadores hospedados na nuvem e publica relatórios e artefatos de volta ao serviço.

Para usar o serviço, o cliente deve se autenticar no serviço para acessar os navegadores. Da mesma forma, a publicação de resultados e artefatos requer interações de API autenticadas. O serviço oferece dois métodos de autenticação: Microsoft Entra ID e tokens de acesso.

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

Habilitar a autenticação usando tokens de acesso

O serviço Microsoft Playwright Testing também oferece suporte à autenticação usando tokens de acesso. Esse método de autenticação é menos seguro. Recomendamos usar o Microsoft Entra ID para se autenticar no serviço.

Cuidado

Os tokens de acesso ao espaço de trabalho são semelhantes a uma senha para o espaço de trabalho do Microsoft Playwright Testing. Tenha sempre o cuidado de proteger seus tokens de acesso. Evite distribuir tokens de acesso para outros usuários, fazer hard-coding com elas ou salvá-las em qualquer lugar em texto sem formatação que seja acessível a outras pessoas.

Revogue e recrie seus tokens se você achar que eles estão comprometidos.

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

  1. Entre no Portal do Playwright com sua conta do Azure e selecione seu espaço de trabalho.

  2. Selecione o ícone de configurações na página inicial para acessar as configurações do espaço de trabalho.

  3. Selecione a página Autenticação e ative Habilitar autenticação usando tokens de acesso

    Captura de tela que mostra a página de configurações dos tokens de acesso no portal do Playwright.

Cuidado

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

Configurar a autenticação usando tokens de acesso

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

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

  2. Criar token de acesso

    Siga as etapas para criar um token de acesso

  3. Configure seu ambiente

    Para configurar seu ambiente, é necessário configurar a variável de ambiente PLAYWRIGHT_SERVICE_ACCESS_TOKEN com o valor obtido nas etapas anteriores.

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

    1. Adicione o módulo dotenv ao seu projeto:

      npm i --save-dev dotenv

    2. Crie um arquivo .env acompanhado do arquivo playwright.config.ts no projeto do Playwright:

      PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}

      Certifique-se de substituir o espaço reservado para texto {MY-ACCESS-TOKEN} pelo valor que você copiou anteriormente.

Executar testes no serviço e publicar os resultados

Execute os testes do Playwright em navegadores hospedados na nuvem e publique os resultados no serviço usando a configuração que você criou acima.

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

Conteúdo relacionado