Compartir a través de


Administración de tokens de acceso del área de trabajo en Playwright Workspaces

En este artículo, aprenderá a administrar tokens de acceso del área de trabajo en Playwright Workspaces. Puede usar tokens de acceso para autenticar y autorizar el acceso a su área de trabajo.

Los tokens de acceso están asociados a una cuenta de usuario y un área de trabajo. Cuando se usa un token de acceso para ejecutar pruebas de Playwright, el servicio comprueba el rol de control de acceso basado en rol de Azure (RBAC de Azure) para comprobar si se le ha concedido acceso para ejecutar pruebas en el servicio. Obtenga más información acerca del acceso al área de trabajo en Playwright Workspaces.

Puede crear varios tokens de acceso por área de trabajo, por ejemplo, para distinguir entre las pruebas en ejecución interactiva o como parte del flujo de trabajo de integración continua (CI). Al crear un token de acceso, el token tiene una duración limitada.

Prerrequisitos

Proteja sus tokens de acceso

Los tokens de acceso del área de trabajo son similares a una contraseña para el área de trabajo de Playwright. Siempre debe proteger los tokens de acceso. Evite distribuirlos a otros usuarios, codificarlos de forma rígida o guardarlos en un archivo de texto sin formato al que puedan acceder otros usuarios.

Revoque y vuelva a crear los tokens si cree que podrían estar en peligro.

Habilitación de la autenticación mediante tokens de acceso

De forma predeterminada, Playwright Workspaces usan Microsoft Entra ID para la autenticación, que es el enfoque recomendado. Aunque se admite la autenticación de token de acceso, está deshabilitada de forma predeterminada porque es menos segura. Para usar tokens de acceso, debe habilitar explícitamente esta opción para el área de trabajo.

Precaución

Los tokens de acceso del área de trabajo son similares a una contraseña para el área de trabajo de Playwright. Siempre debe proteger los tokens de acceso. Evite distribuirlos a otros usuarios, codificarlos de forma rígida o guardarlos en un archivo de texto sin formato al que puedan acceder otros usuarios. Revoque y vuelva a crear los tokens si cree que están en peligro.

Para habilitar la autenticación mediante tokens de acceso:

  1. Inicie sesión en Azure Portal con su cuenta de Azure y vaya al área de trabajo.

  2. En la sección Configuración, seleccione Administración de acceso.

  3. Active la casilla Token de acceso del servicio Playwright para habilitarlo.

Recorte de pantalla que muestra cómo activar la autenticación mediante tokens de acceso.

Precaución

La autenticación mediante tokens de acceso es menos segura. Obtenga información sobre cómo administrar tokens de acceso

Ver todos los tokens de acceso al área de trabajo

Puede ver la lista de tokens de acceso para su área de trabajo en Azure Portal. Para cada token, la lista muestra el nombre del token, el estado y la fecha de expiración. No se puede recuperar el valor del token de acceso después de crearlo.

Solo puede ver la lista de tokens de acceso para las áreas de trabajo a las que tiene acceso.

Para ver la lista de tokens de acceso del área de trabajo:

  1. Inicie sesión en Azure Portal con su cuenta de Azure y vaya al área de trabajo.

  2. En la sección Configuración, seleccione Administración de acceso.

  3. Si la opción Token de acceso al servicio Playwright, está activada, la página mostrará todos los tokens de acceso para el área de trabajo.

Generar un token de acceso de área de trabajo

Cree un token de acceso para autorizar el acceso a su área de trabajo de Playwright y ejecutar las pruebas de Playwright existentes en su área de trabajo. Puede crear varios tokens de acceso para el área de trabajo. Al crear un token de acceso, debe especificar una fecha de expiración para el token. Después de que expire un token, debe crear un nuevo token de acceso.

Cuando se usa un token de acceso, el servicio comprueba el rol RBAC de Azure del usuario asociado al token de acceso para comprobar que se conceden los permisos necesarios. Por ejemplo, si tiene el rol Lector, no puede ejecutar pruebas de Playwright, pero puede ver los resultados de la prueba. Cuando hay cambios en la asignación de roles, el servicio comprueba los permisos en el momento en que realice la acción.

Para crear un nuevo token de acceso a área de trabajo:

  1. Inicie sesión en Azure Portal con su cuenta de Azure y vaya al área de trabajo.

  2. En la sección Configuración, seleccione Administración de acceso.

  3. En la página Administración de acceso, seleccione Generar token.

    Captura de pantalla que muestra la página de configuración de tokens de acceso en Azure Portal, con el botón 'Generar nuevo token' resaltado.

  4. Escriba los detalles del token de acceso y, a continuación, seleccione Generar token.

    Captura de pantalla que muestra la guía de configuración en Azure Portal, resaltando el botón

  5. Copie el token de acceso del área de trabajo.

    Puede guardar el token de acceso en un almacén de secretos de CI/CD o usarlo en una variable de entorno para ejecutar pruebas de forma interactiva.

    Captura de pantalla que muestra cómo copiar el token de acceso generado en Azure Portal

    Importante

    Solo puede acceder al valor del token inmediatamente después de crearlo. Ya no puede acceder al valor del token más adelante.

Nota:

El número de tokens de acceso por usuario y por área de trabajo es limitado. Para más información, consulte límites de Playwright Workspaces.

Eliminar un token de acceso

Solo puede eliminar los tokens de acceso que creó en un área de trabajo. Para crear un token de acceso:

  1. Inicie sesión en Azure Portal con su cuenta de Azure y vaya al área de trabajo.

  2. En la sección Configuración, seleccione Administración de acceso.

  3. Si la opción Token de acceso al servicio Playwright, está activada, la página mostrará todos los tokens de acceso para el área de trabajo.

  4. Seleccione Eliminar junto al token de acceso que desea eliminar.

  5. Seleccione Eliminar en la página de confirmación de eliminación.

Precaución

No se puede deshacer la operación de eliminación de un token de acceso. Los scripts existentes para ejecutar pruebas con este token producirán un error después de eliminar el token de acceso.