Manage workspace access tokens in Microsoft Playwright Testing Preview

In this article, you learn how to manage workspace access tokens in Microsoft Playwright Testing Preview. You use access tokens to authenticate and authorize access to your workspace.

Access tokens are associated with a user account and workspace. When you use an access token for running Playwright tests, the service checks your Azure role-based access control (Azure RBAC) role to verify if you're granted access to run tests on the service. Learn more about workspace access in Microsoft Playwright Testing.

You can create multiple access tokens per workspace, for example to distinguish between running tests interactively or as part of your continuous integration (CI) workflow. When you create an access token, the token has a limited lifespan.

Important

Microsoft Playwright Testing is currently in preview. For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see the Supplemental Terms of Use for Microsoft Azure Previews.

Prerequisites

• An Azure account with an active subscription. Create an account for free.
• A Microsoft Playwright Testing workspace. To create a workspace, see Quickstart: Run Playwright tests at scale.
• To create or delete access tokens, your Azure account needs to have the Contributor or Owner role at the workspace level. Learn more about managing access to a workspace.

Protect your access tokens

Your workspace access tokens are similar to a password for your Microsoft Playwright Testing workspace. Always be careful to protect your access tokens. Avoid distributing access tokens to other users, hard-coding them, or saving them anywhere in plain text that is accessible to others.

Revoke and recreate your tokens if you believe they may have been compromised.

View all workspace access tokens

You can view the list of access tokens for your workspace in the Playwright portal. For each token, the list displays the token name, status, and expiration date. You can't retrieve the access token value after it has been created.

You can only view the list of access tokens for the workspaces you have access to.

To view the list of workspace access tokens:

1. Sign in to the Playwright portal with your Azure account.

2. Select your workspace.

3. Select the settings icon on the home page to go to the workspace settings.

4. Select the Access tokens page to view the list of access tokens.

   The Access tokens page displays the list of access tokens for the workspace.

   

Generate a workspace access token

Create an access token to authorize access to your Microsoft Playwright Testing workspace, and to run existing Playwright tests in your workspace. You can create multiple access tokens for your workspace. When you create an access token, you have to specify an expiration date for the token. After a token expires, you need to create a new access token.

When you use an access token, the service checks the Azure RBAC role of the user that is associated with the access token to verify that the required permissions are granted. For example, if you have the Reader role, you can't run Playwright tests but you can view the test results. When there are role assignment changes, the service checks the permissions at the time you perform the action.

To create a new workspace access token:

1. Sign in to the Playwright portal with your Azure account.

2. Select your workspace.

3. Select the settings icon on the home page to go to the workspace settings.

4. On the Access tokens page, select Generate new token.

   

5. Enter the access token details, and then select Generate token.

   

6. Copy the access token for the workspace.

   You can save the access token in a CI/CD secrets store or use it in an environment variable for running tests interactively.

   

   Important

   You can only access the token value immediately after you've created it. You can't access the token value anymore at a later time.

Note

The number of access tokens per user and per workspace is limited. For more information, see the Microsoft Playwright Testing service limits.

Delete an access token

You can only delete access tokens that you created in a workspace. To create an access token:

1. Sign in to the Playwright portal with your Azure account.

2. Select your workspace.

3. Select the settings icon on the home page to go to the workspace settings.

4. On the Access tokens page, select Delete next to the access token that you want to delete.

   

5. Select Delete on the deletion confirmation page.

Caution

You can't undo the delete operation of an access token. Any existing scripts for running tests with this token will fail after deleting the access token.

Related content

• Learn more about managing access to a workspace.