次の方法で共有

Microsoft Playwright Testing プレビューの認証と認可を管理する

  • [アーティクル]

この記事では、Microsoft Playwright Testing プレビューの認証と認可を管理する方法について説明します。 クラウドでホストされているブラウザーで Playwright テストを実行し、テスト結果と成果物をサービスに発行するには、認証が必要です。

既定では、Microsoft Entra ID が認証に使用されます。 この方法は、より安全であり、推奨される認証方法です。 Microsoft Entra ID を使用する認証を無効にすることはできません。 ただし、アクセス トークンを使用して認証と認可を行うこともできます。

重要

Microsoft Playwright Testing は現在、プレビュー段階です。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。

背景

Microsoft Playwright Testing Preview は、Playwright オープンソース フレームワーク上に構築されています。 クラウドでホストされているブラウザーで Playwright テストを実行し、レポートと成果物をサービスに発行します。

サービスを使用するには、クライアントがブラウザーにアクセスするためにサービスで認証を行う必要があります。 同様に、結果と成果物を発行するには、認証済みの API 操作が必要です。 このサービスには、2 つの認証方法 (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

関連するコンテンツ