Sdílet prostřednictvím

Správa ověřování a autorizace pro Microsoft Playwright Testing Ve verzi Preview

  • Článek

V tomto článku se dozvíte, jak spravovat ověřování a autorizaci pro Microsoft Playwright Testing Ve verzi Preview. Ověřování se vyžaduje ke spuštění testů Playwright v prohlížečích hostovaných v cloudu a k publikování výsledků testů a artefaktů do služby.

Ve výchozím nastavení se k ověřování používá ID Microsoft Entra. Tato metoda je bezpečnější a jedná se o doporučenou metodu ověřování. Ověřování se nedá zakázat pomocí ID Microsoft Entra. Přístupové tokeny ale můžete použít také k ověřování a autorizaci.

Důležité

Microsoft Playwright Testing je aktuálně ve verzi Preview. Právní podmínky, které se vztahují na funkce Azure, které jsou ve verzi beta, ve verzi Preview nebo které ještě nejsou vydány v obecné dostupnosti, najdete v dodatečných podmínkách použití pro verze Microsoft Azure Preview.

Pozadí

Microsoft Playwright Testing Preview je založen na opensourcové platformě Playwright. Spouští testy Playwright v prohlížečích hostovaných v cloudu a publikuje sestavy a artefakty zpět do služby.

Aby bylo možné službu používat, musí se klient ověřit ve službě, aby měl přístup k prohlížečům. Podobně publikování výsledků a artefaktů vyžaduje ověřené interakce rozhraní API. Služba nabízí dvě metody ověřování: ID Microsoft Entra a přístupové tokeny.

Microsoft Entra ID používá vaše přihlašovací údaje Azure, které vyžadují přihlášení k vašemu účtu Azure pro zabezpečený přístup. Případně můžete vygenerovat přístupový token z pracovního prostoru Playwright a použít ho v nastavení. Kvůli rozšířenému zabezpečení však důrazně doporučujeme microsoft Entra ID pro ověřování. Přístupové tokeny, zatímco pohodlné, fungují jako dlouhodobá hesla a jsou náchylnější k ohrožení zabezpečení.

Povolení ověřování pomocí přístupových tokenů

Služba Microsoft Playwright Testing také podporuje ověřování pomocí přístupových tokenů. Tato metoda ověřování je méně zabezpečená. K ověření ve službě doporučujeme použít ID Microsoft Entra.

Upozornění

Přístupové tokeny pracovního prostoru se podobají heslu pro pracovní prostor Microsoft Playwright Testing. Při ochraně přístupových tokenů buďte vždy opatrní. Vyhněte se distribuci přístupových tokenů jiným uživatelům, jejich pevnému kódování nebo jejich uložení kdekoli ve formátu prostého textu, který je přístupný ostatním uživatelům.

Pokud se domníváte, že dojde k ohrožení zabezpečení, odvolávejte a znovu vytvořte tokeny.

Povolení ověřování pomocí přístupových tokenů:

  1. Přihlaste se k portálu Playwright pomocí svého účtu Azure a vyberte svůj pracovní prostor.

  2. Výběrem ikony nastavení na domovské stránce přejděte do nastavení pracovního prostoru.

  3. Vyberte stránku Ověřování a zapněte povolit ověřování pomocí přístupových tokenů.

    Snímek obrazovky znázorňující stránku nastavení přístupových tokenů na portálu Playwright

Upozornění

Ověřování pomocí přístupových tokenů je méně bezpečné. Informace o správě přístupových tokenů

Nastavení ověřování pomocí přístupových tokenů

  1. Při spouštění testů povolte v souboru v nastavení ověřování přístupového tokenu 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. Při spouštění testů povolte v souboru v nastavení ověřování přístupového tokenu .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. Vytvoření přístupového tokenu

    Podle pokynů vytvořte přístupový token. Zkopírujte hodnotu vygenerovaného přístupového tokenu.

  1. Nastavení prostředí

    Pokud chcete nastavit prostředí, nakonfigurujte PLAYWRIGHT_SERVICE_ACCESS_TOKEN proměnnou prostředí s hodnotou, kterou jste získali v předchozích krocích. Ujistěte se, že je tato proměnná prostředí dostupná v nastavení, ve kterém spouštíte testy.

    Ke správě prostředí doporučujeme použít dotenv modul. V dotenvsouboru .env definujete proměnné prostředí.

    1. Přidejte modul dotenv do projektu:

      npm i --save-dev dotenv

    2. Vytvořte .env soubor společně se souborem playwright.config.ts v projektu Playwright:

      PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}

      Nezapomeňte zástupný text nahradit {MY-ACCESS-TOKEN} hodnotou, kterou jste zkopírovali dříve.

  1. Nastavení prostředí

    Pokud chcete nastavit prostředí, nakonfigurujte PLAYWRIGHT_SERVICE_ACCESS_TOKEN proměnnou prostředí s hodnotou, kterou jste získali v předchozích krocích. Ujistěte se, že je tato proměnná prostředí dostupná v nastavení, ve kterém spouštíte testy.

Spouštění testů ve službě a publikování výsledků

Spusťte testy Playwright v prohlížečích hostovaných v cloudu a výsledky publikujte do služby pomocí konfigurace, kterou jste vytvořili výše.

npx playwright test --config=playwright.service.config.ts --workers=20

dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20

Související obsah