Поделиться через

Управление проверкой подлинности и авторизацией для предварительной версии Microsoft Playwright Testing

  • Статья

В этой статье вы узнаете, как управлять проверкой подлинности и авторизацией для предварительной версии Microsoft Playwright Testing. Проверка подлинности необходима для запуска тестов Playwright в облачных браузерах и публикации результатов теста и артефактов в службе.

По умолчанию идентификатор Microsoft Entra используется для проверки подлинности. Этот метод является более безопасным и является рекомендуемым методом проверки подлинности. Невозможно отключить проверку подлинности с помощью идентификатора Microsoft Entra. Однако для проверки подлинности и авторизации можно также использовать маркеры доступа.

Внимание

Тестирование Microsoft Playwright в настоящее время находится в предварительной версии. Юридические условия, применимые к функциям Azure, которые находятся в бета-версии, предварительной версии или в противном случае еще не выпущены в общедоступную версию, см . в дополнительных условиях использования для предварительных версий Microsoft Azure.

Общие сведения

Предварительная версия тестирования Microsoft Playwright основана на платформе с открытым исходным кодом Playwright. Он выполняет тесты Playwright в облачных браузерах и публикует отчеты и артефакты обратно в службу.

Чтобы использовать службу, клиент должен пройти проверку подлинности с помощью службы для доступа к браузерам. Аналогичным образом, для публикации результатов и артефактов требуется взаимодействие с API с проверкой подлинности. Служба предлагает два метода проверки подлинности: идентификатор Microsoft Entra и маркеры доступа.

Идентификатор Microsoft Entra использует учетные данные Azure, требуя входа в учетную запись Azure для безопасного доступа. Кроме того, вы можете создать маркер доступа из рабочей области Playwright и использовать его в настройке. Однако настоятельно рекомендуется использовать идентификатор Microsoft Entra для проверки подлинности из-за повышенной безопасности. Маркеры доступа, в то время как удобные, функции, такие как долгоживущие пароли и более подвержены скомпрометации.

Включение проверки подлинности с помощью маркеров доступа

Служба тестирования Microsoft Playwright также поддерживает проверку подлинности с помощью маркеров доступа. Этот метод проверки подлинности является менее безопасным. Мы рекомендуем использовать идентификатор Microsoft Entra для проверки подлинности в службе.

Внимание

Маркеры доступа к рабочей области похожи на пароль для рабочей области Microsoft Playwright Testing. Всегда будьте осторожны, чтобы защитить маркеры доступа. Избегайте распространения маркеров доступа другим пользователям, жесткого написания кода или сохранения их в любом месте обычного текста, доступного другим пользователям.

Отмените и повторно создайте маркеры, если вы считаете, что они скомпрометированы.

Чтобы включить проверку подлинности с помощью маркеров доступа:

  1. Войдите на портал Playwright с учетной записью Azure и выберите рабочую область.

  2. Щелкните значок параметров на домашней странице, чтобы перейти к параметрам рабочей области.

  3. Выберите страницу проверки подлинности и включите проверку подлинности с помощью маркеров доступа

    Снимок экрана: страница параметров маркеров доступа на портале Playwright.

Внимание

Проверка подлинности с помощью маркеров доступа менее безопасна. Узнайте, как управлять маркерами доступа

Настройка проверки подлинности с помощью маркеров доступа

  1. Во время выполнения тестов включите проверку подлинности маркера доступа в файле в настройке playwright.service.config.ts .

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

  1. Во время выполнения тестов включите проверку подлинности маркера доступа в файле в настройке .runsettings .

    <TestRunParameters>
    <!-- Use this option when you want to authenticate using access tokens. This mode of auth should be enabled for the workspace. -->
     <Parameter name="ServiceAuthType" value="AccessToken" />
</TestRunParameters>

  1. Создание маркера доступа

    Выполните действия, чтобы создать маркер доступа. Скопируйте значение созданного маркера доступа.

  1. Настройка среды

    Чтобы настроить среду, настройте PLAYWRIGHT_SERVICE_ACCESS_TOKEN переменную среды со значением, полученным на предыдущих шагах. Убедитесь, что эта переменная среды доступна в настройке, в которой выполняются тесты.

    Мы рекомендуем использовать dotenv модуль для управления средой. При этом dotenvвы определяете .env переменные среды в файле.

    1. Добавьте модуль в dotenv проект:

      npm i --save-dev dotenv

    2. Создайте файл вместе с файлом .envplaywright.config.ts в проекте Playwright:

      PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}

      Обязательно замените {MY-ACCESS-TOKEN} заполнитель текста значением, скопированным ранее.

  1. Настройка среды

    Чтобы настроить среду, настройте PLAYWRIGHT_SERVICE_ACCESS_TOKEN переменную среды со значением, полученным на предыдущих шагах. Убедитесь, что эта переменная среды доступна в настройке, в которой выполняются тесты.

Выполнение тестов в службе и публикация результатов

Выполните тесты Playwright для браузеров, размещенных в облаке, и опубликуйте результаты в службе, используя созданную выше конфигурацию.

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

dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20

Связанный контент