在本文中,您將瞭解如何在 Playwright Workspaces 中管理工作區存取令牌。 您可以使用存取權杖來驗證和授權對工作區的存取。
存取權杖會與使用者帳戶和工作區相關聯。 當您使用存取權杖來執行 Playwright 測試時,服務會檢查您的 Azure 角色型存取控制 (Azure RBAC) 角色,以確認您是否已獲得對服務執行測試的存取權。 深入瞭解 Playwright Workspaces 中的工作區存取權。
您可以為每個工作區建立多個存取權杖,例如,用以區分以互動方式或透過持續整合 (CI) 工作流程執行的測試。 當您建立存取權杖時,權杖的存留期有其限制。
先決條件
- 具有有效訂閱的 Azure 帳戶。 免費建立帳戶。
- Playwright 工作區。 若要建立工作區,請參閱快速入門:大規模執行 Playwright 測試。
- 若要建立或刪除存取權杖,您的 Azure 帳戶必須具有工作區層級的參與者或擁有者角色。 深入了解管理工作區的存取權 (部分機器翻譯)。
保護您的存取權杖
您的工作區存取令牌類似於 Playwright 工作區的密碼。 請務必小心保護您的存取權杖。 避免將存取權杖散發給其他使用者、寫入程式碼,或將其以純文字儲存在他人可以存取的位置。
如果您認為權杖可能遭到入侵,請撤銷並重新建立權杖。
使用存取令牌啟用驗證
根據預設,Playwright Workspaces 會使用 Microsoft Entra ID 進行驗證,這是建議的方法。 雖然支援存取令牌驗證,但預設會停用,因為它較不安全。 若要使用存取令牌,您必須為工作區明確啟用此選項。
謹慎
您的工作區存取令牌類似於 Playwright 工作區的密碼。 請務必小心保護您的存取權杖。 避免將存取權杖散發給其他使用者、寫入程式碼,或將其以純文字儲存在他人可以存取的位置。 如果您認為權杖遭到入侵,請撤銷並重新建立您的權杖。
若要使用存取權杖啟用驗證:
使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。
在 [ 設定] 區段中,選取 [ 存取管理]。
核取 Playwright 服務存取令牌 的方塊以啟用它。
謹慎
使用存取權杖進行驗證較不安全。 了解如何管理存取權杖
檢視所有工作區存取權杖
您可以在 Azure 入口網站中檢視工作區的存取權杖清單。 對於每個權杖,清單會顯示權杖名稱、狀態和到期日。 存取權杖值建立後,您將無法加以擷取。
您只能檢視您有權存取之工作區的存取權杖清單。
若要檢視工作區存取權杖清單:
使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。
在 [ 設定] 區段中,選取 [ 存取管理]。
如果核取 Playwright 服務存取令牌 選項,頁面會列出工作區的所有存取令牌。
產生工作區存取權杖
建立存取令牌以授權存取您的 Playwright 工作區,並在工作區中執行現有的 Playwright 測試。 您可以為工作區建立多個存取權杖。 建立存取權杖時,您必須指定權杖的到期日。 權杖到期後,您必須建立新的存取權杖。
當您使用存取權杖時,服務會檢查與存取權杖相關聯之使用者的 Azure RBAC 角色,以確認已授與必要的權限。 例如,如果您具有讀者角色,您將無法執行 Playwright 測試,但可以檢視測試結果。 角色指派變更時,服務會在您執行動作時檢查權限。
若要建立新的工作區存取權杖:
使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。
在 [ 設定] 區段中,選取 [ 存取管理]。
在 [ 存取管理] 頁面上,選取 [產生令牌]。
輸入存取權杖的詳細資料,然後選取 [產生權杖]。
複製工作區的存取權杖。
您可以在 CI/CD 秘密存放區中儲存存取權杖,或將其用於環境變數中,以執行互動式測試。
這很重要
您只能在建立權杖後立即存取權杖值。 後續您就無法再存取權杖值。
備註
每個使用者和每個工作區的存取權杖數目有其限制。 如需詳細資訊,請參閱 Playwright Workspaces 限制。
刪除存取權杖
您只能刪除在工作區中建立的存取權杖。 若要建立存取權杖:
使用 您的 Azure 帳戶登入 Azure 入口網站,並流覽至您的工作區。
在 [ 設定] 區段中,選取 [ 存取管理]。
如果核取 Playwright 服務存取令牌 選項,頁面會列出工作區的所有存取令牌。
選取您要刪除之存取令牌旁邊的 [ 刪除 ]。
選取刪除確認頁面上的 [刪除]。
謹慎
您無法復原存取權杖的刪除作業。 任何執行測試的現有指令碼只要有此權杖,都會在刪除存取權杖後失敗。