다음을 통해 공유

Microsoft Playwright Testing 미리 보기에 대한 인증 및 권한 부여 관리

  • 아티클

이 문서에서는 Microsoft Playwright Testing 미리 보기에 대한 인증 및 권한 부여를 관리하는 방법을 알아봅니다. 클라우드 호스팅 브라우저에서 Playwright 테스트를 실행하고 테스트 결과 및 아티팩트를 서비스에 게시하려면 인증이 필요합니다.

기본적으로 Microsoft Entra ID가 인증에 사용됩니다. 이 방법은 보다 안전하며 권장되는 인증 방법입니다. Microsoft Entra ID를 사용한 인증은 비활성화할 수 없습니다. 그러나 액세스 토큰을 사용하여 인증 및 권한 부여를 수행할 수도 있습니다.

Important

Microsoft Playwright Testing은 현재 미리 보기 상태입니다. 베타, 미리 보기 또는 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 약관은 Microsoft Azure 미리 보기에 대한 보충 사용 약관을 참조하세요.

배경

Microsoft Playwright Testing 미리 보기는 Playwright 오픈 소스 프레임워크를 기반으로 합니다. 클라우드 호스팅 브라우저에서 Playwright 테스트를 실행하고 보고서와 아티팩트를 서비스에 다시 게시합니다.

서비스를 사용하려면 클라이언트가 서비스에 인증하여 브라우저에 액세스해야 합니다. 마찬가지로 결과 및 아티팩트를 게시하려면 인증된 API 상호 작용이 필요합니다. 이 서비스는 Microsoft Entra ID와 액세스 토큰이라는 두 가지 인증 방법을 제공합니다.

Microsoft Entra ID는 Azure 자격 증명을 사용하여 보안 액세스를 위해 Azure 계정에 로그인해야 합니다. 아니면 Playwright 작업 영역에서 액세스 토큰을 생성하고 설정에서 사용할 수 있습니다. 그러나 보안이 강화된 Microsoft Entra ID를 인증에 사용하는 것이 좋습니다. 액세스 토큰은 편리하기는 하지만 수명이 긴 암호처럼 작동하며 손상되기 쉽습니다.

액세스 토큰을 사용한 인증 활성화

Microsoft Playwright Testing 서비스는 액세스 토큰을 사용하는 인증도 지원합니다. 이 인증 방법은 보안 수준이 좀 더 낮습니다. Microsoft Entra ID를 사용하여 서비스에 인증하는 것이 좋습니다.

주의

작업 영역 액세스 토큰은 Microsoft Playwright Testing 작업 영역의 암호와 유사합니다. 항상 액세스 토큰을 보호하도록 주의해야 합니다. 액세스 토큰을 다른 사용자에게 배포하거나 하드 코딩하거나 다른 사용자가 액세스할 수 있는 일반 텍스트로 저장하지 않도록 합니다.

토큰이 손상되었다고 생각되면 토큰을 해지하고 다시 생성하세요.

액세스 토큰을 사용한 인증을 활성화하려면 다음을 수행합니다.

  1. Azure 계정으로 Playwright 포털에 로그인하고 작업 영역을 선택합니다.

  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. Playwright 프로젝트에서 playwright.config.ts 파일과 함께 .env 파일을 만듭니다.

      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

관련 콘텐츠