Gerenciar tokens de acesso do espaço de trabalho em Playwright Workspaces

Neste artigo, você aprenderá a gerenciar tokens de acesso do espaço de trabalho em Playwright Workspaces. Os tokens de acesso são usados para autenticar e autorizar o acesso ao seu workspace.

Os tokens de acesso são associados a uma conta de usuário e um workspace. Quando você usa um token de acesso para executar testes do Playwright, o serviço verifica sua função de RBAC (controle de acesso baseado em função) do Azure para verificar se você recebeu acesso para executar testes no serviço. Saiba mais sobre acesso ao espaço de trabalho em Playwright Workspaces.

Você pode criar vários tokens de acesso por workspace, por exemplo, para distinguir entre executar testes interativamente ou como parte do fluxo de trabalho de CI (integração contínua). Quando você cria um token de acesso, o token tem um tempo de vida limitado.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Um Workspace do Playwright. Para criar um espaço de trabalho, confira Início Rápido: executar testes do Playwright em escala.
• Para criar ou excluir tokens de acesso, sua conta do Azure precisa ter a função Colaborador ou Proprietário no nível do workspace. Saiba mais sobre como gerenciar o acesso a um workspace.

Como proteger seus tokens de acesso

Os tokens de acesso do workspace são semelhantes a uma senha do Playwright Workspaces. 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 foram comprometidos.

Habilitar autenticação usando tokens de acesso

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

Cuidado

Os tokens de acesso do workspace são semelhantes a uma senha do Playwright Workspaces. 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 Azure com sua conta do Azure e navegue até o workspace.

2. Na seção Configurações, selecione Gerenciamento de Acesso.

3. Marque a caixa Token de acesso do serviço Playwright para habilitá-lo.

Cuidado

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

Exibir todos os tokens de acesso do workspace

Você pode exibir a lista de tokens de acesso do seu espaço de trabalho no portal do Azure. Para cada token, a lista exibe o nome do token, o status e a data de validade. Você não pode recuperar o valor do token de acesso após sua criação.

Você só pode exibir a lista de tokens de acesso aos workspaces para os quais tem acesso.

Para exibir a lista de tokens de acesso ao workspace:

1. Entre no portal do Azure com sua conta do Azure e navegue até o workspace.

2. Na seção Configurações, selecione Gerenciamento de Acesso.

3. Se a opção Token de Acesso ao Serviço do Playwright estiver marcada, a página listará todos os tokens de acesso do espaço de trabalho.

Gerar um token de acesso ao workspace

Crie um token de acesso para autorizar o acesso ao seu espaço de trabalho do Playwright e executar testes do Playwright existentes no seu espaço de trabalho. Você pode criar vários tokens de acesso ao seu workspace. Ao criar um token de acesso, você precisa especificar uma data de validade para o token. Depois que um token expirar, você precisará criar um novo token de acesso.

Ao usar um token de acesso, o serviço verifica a função RBAC do Azure do usuário associado ao token para confirmar se as permissões necessárias foram concedidas. Por exemplo, se você tiver a função Leitor, não poderá executar testes do Playwright, mas poderá exibir os resultados do teste. Quando há alterações na atribuição de função, o serviço verifica as permissões no momento em que você executa a ação.

Para criar um novo token de acesso ao workspace:

1. Entre no portal do Azure com sua conta do Azure e navegue até o workspace.

2. Na seção Configurações, selecione Gerenciamento de Acesso.

3. Na página Gerenciamento de Acesso, selecione Gerar token.

   

4. Insira os detalhes do token de acesso e selecione Gerar token.

   

5. Copie o token de acesso para o espaço de trabalho.

   Você pode salvar o token de acesso em um repositório de segredos de CI/CD ou usá-lo em uma variável de ambiente para executar testes interativamente.

   

   Importante

   Você só pode acessar o valor do token imediatamente após criá-lo. Você não poderá acessar mais o valor do token em outro momento.

Observação

O número de tokens de acesso por usuário e por workspace é limitado. Para obter mais informações, confira os limites do Playwright Workspaces.

Excluir um token de acesso

Você só pode excluir tokens de acesso criados em um workspace. Para criar um token de acesso:

1. Entre no portal do Azure com sua conta do Azure e navegue até o workspace.

2. Na seção Configurações, selecione Gerenciamento de Acesso.

3. Se a opção Token de Acesso ao Serviço do Playwright estiver marcada, a página listará todos os tokens de acesso do espaço de trabalho.

4. Selecione Excluir ao lado do token de acesso que você deseja excluir.

5. Selecione Excluir na página de confirmação da exclusão.

Cuidado

Você não poderá desfazer a operação de exclusão de um token de acesso. Todos os scripts existentes para executar testes com esse token falharão após a exclusão do token de acesso.

Conteúdo relacionado

• Saiba mais sobre como gerenciar o acesso a um workspace.
• Saiba mais sobre como gerenciar a autenticação no workspace