共用方式為


在 Playwright Workspaces 中管理工作區存取令牌

在本文中,您將瞭解如何在 Playwright Workspaces 中管理工作區存取令牌。 您可以使用存取權杖來驗證和授權對工作區的存取。

存取權杖會與使用者帳戶和工作區相關聯。 當您使用存取權杖來執行 Playwright 測試時,服務會檢查您的 Azure 角色型存取控制 (Azure RBAC) 角色,以確認您是否已獲得對服務執行測試的存取權。 深入瞭解 Playwright Workspaces 中的工作區存取權。

您可以為每個工作區建立多個存取權杖,例如,用以區分以互動方式或透過持續整合 (CI) 工作流程執行的測試。 當您建立存取權杖時,權杖的存留期有其限制。

先決條件

保護您的存取權杖

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

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

使用存取令牌啟用驗證

根據預設,Playwright Workspaces 會使用 Microsoft Entra ID 進行驗證,這是建議的方法。 雖然支援存取令牌驗證,但預設會停用,因為它較不安全。 若要使用存取令牌,您必須為工作區明確啟用此選項。

謹慎

您的工作區存取令牌類似於 Playwright 工作區的密碼。 請務必小心保護您的存取權杖。 避免將存取權杖散發給其他使用者、寫入程式碼,或將其以純文字儲存在他人可以存取的位置。 如果您認為權杖遭到入侵,請撤銷並重新建立您的權杖。

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

  1. 使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。

  2. 在 [ 設定] 區段中,選取 [ 存取管理]。

  3. 核取 Playwright 服務存取令牌 的方塊以啟用它。

顯示使用存取令牌開啟驗證的螢幕快照。

謹慎

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

檢視所有工作區存取權杖

您可以在 Azure 入口網站中檢視工作區的存取權杖清單。 對於每個權杖,清單會顯示權杖名稱、狀態和到期日。 存取權杖值建立後,您將無法加以擷取。

您只能檢視您有權存取之工作區的存取權杖清單。

若要檢視工作區存取權杖清單:

  1. 使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。

  2. 在 [ 設定] 區段中,選取 [ 存取管理]。

  3. 如果核取 Playwright 服務存取令牌 選項,頁面會列出工作區的所有存取令牌。

產生工作區存取權杖

建立存取令牌以授權存取您的 Playwright 工作區,並在工作區中執行現有的 Playwright 測試。 您可以為工作區建立多個存取權杖。 建立存取權杖時,您必須指定權杖的到期日。 權杖到期後,您必須建立新的存取權杖。

當您使用存取權杖時,服務會檢查與存取權杖相關聯之使用者的 Azure RBAC 角色,以確認已授與必要的權限。 例如,如果您具有讀者角色,您將無法執行 Playwright 測試,但可以檢視測試結果。 角色指派變更時,服務會在您執行動作時檢查權限。

若要建立新的工作區存取權杖:

  1. 使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。

  2. 在 [ 設定] 區段中,選取 [ 存取管理]。

  3. 在 [ 存取管理] 頁面上,選取 [產生令牌]。

    顯示 Azure 入口網站中存取令牌設定頁面的螢幕快照,其中醒目提示 [產生新令牌] 按鈕。

  4. 輸入存取權杖的詳細資料,然後選取 [產生權杖]

    顯示 Azure 入口網站中設定指南的螢幕快照,其中醒目提示 [產生令牌] 按鈕。

  5. 複製工作區的存取權杖。

    您可以在 CI/CD 秘密存放區中儲存存取權杖,或將其用於環境變數中,以執行互動式測試。

    顯示如何在 Azure 入口網站中複製所產生存取令牌的螢幕快照

    這很重要

    您只能在建立權杖後立即存取權杖值。 後續您就無法再存取權杖值。

備註

每個使用者和每個工作區的存取權杖數目有其限制。 如需詳細資訊,請參閱 Playwright Workspaces 限制

刪除存取權杖

您只能刪除在工作區中建立的存取權杖。 若要建立存取權杖:

  1. 使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。

  2. 在 [ 設定] 區段中,選取 [ 存取管理]。

  3. 如果核取 Playwright 服務存取令牌 選項,頁面會列出工作區的所有存取令牌。

  4. 選取您要刪除之存取令牌旁邊的 [ 刪除 ]。

  5. 選取刪除確認頁面上的 [刪除]

謹慎

您無法復原存取權杖的刪除作業。 任何執行測試的現有指令碼只要有此權杖,都會在刪除存取權杖後失敗。