管理 Microsoft Playwright Testing 預覽版的驗證和授權

在本文中，您會了解如何管理 Microsoft Playwright Testing 預覽版的驗證和授權。 需要驗證，才能在雲端託管的瀏覽器上執行 Playwright 測試，以及將測試結果和成品發佈至服務。

根據預設，Microsoft Entra ID 用於驗證。 此方法更安全且是建議的驗證方法。 您無法使用 Microsoft Entra ID 停用驗證。 不過，您也可以使用存取權杖來驗證和授權。

重要

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 對服務進行驗證。

警告

您的工作區存取權杖類似於 Microsoft Playwright Testing 工作區的密碼。 請務必小心保護您的存取權杖。 避免將存取權杖散發給其他使用者、寫入程式碼，或將其以純文字儲存在他人可以存取的位置。

如果您認為權杖遭到入侵，請撤銷並重新建立您的權杖。

若要使用存取權杖啟用驗證：

1. 使用您的 Azure 帳戶登入 Playwright 入口網站，並選取您的工作區。

2. 選取首頁上的設定圖示，以移至工作區設定。

3. 選取 [驗證] 頁面，然後開啟 [使用存取權杖啟用驗證]

   

警告

使用存取權杖進行驗證較不安全。 了解如何管理存取權杖

使用存取權杖設定驗證

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>
   

2. 建立存取權杖

   請遵循步驟來 建立存取令牌。 複製產生的存取令牌值。

3. 設定您的環境

   若要設定環境， 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} 文字預留位置取代為您稍早複製的值。

3. 設定您的環境

   若要設定環境， 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

相關內容

• 深入了解管理存取權杖。