Condividi tramite


Gestire l'autenticazione e l'autorizzazione per l'anteprima di Microsoft Playwright Testing

In questo articolo vengono fornite informazioni su come gestire l'autenticazione e l'autorizzazione per l'anteprima di Microsoft Playwright Testing. L'autenticazione è necessaria per eseguire test Playwright nei browser ospitati nel cloud e per pubblicare i risultati e gli artefatti dei test nel servizio.

Per impostazione predefinita, Microsoft Entra ID viene usato per l'autenticazione. Questo metodo è più sicuro ed è il metodo di autenticazione consigliato. Non è possibile disabilitare l'autenticazione usando Microsoft Entra ID. Tuttavia, è anche possibile usare i token di accesso per l'autenticazione e l'autorizzazione.

Importante

Microsoft Playwright Testing è attualmente in anteprima. Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

Background

Microsoft Playwright Testing Preview è basato sul framework open source Playwright. Esegue test Playwright nei browser ospitati nel cloud e pubblica report e artefatti nel servizio.

Per usare il servizio, il client deve eseguire l'autenticazione con il servizio per accedere ai browser. Analogamente, la pubblicazione di risultati e artefatti richiede interazioni API autenticate. Il servizio offre due metodi di autenticazione: Microsoft Entra ID e token di accesso.

Microsoft Entra ID usa le credenziali di Azure, richiedendo il log-in all'account Azure per l'accesso sicuro. In alternativa, è possibile generare un token di accesso dall'area di lavoro Playwright e usarlo nella configurazione. Tuttavia, è consigliabile usare Microsoft Entra ID per l'autenticazione per la sua sicurezza avanzata. I token di accesso, sebbene siano pratici, funzionano come password di lunga durata e sono più soggetti a essere compromessi.

Abilitare l'autenticazione tramite token di accesso

Il servizio Microsoft Playwright Testing supporta anche l'autenticazione con i token di accesso. Questo metodo di autenticazione è meno sicuro. È consigliabile usare Microsoft Entra ID per l'autenticazione al servizio.

Attenzione

I token di accesso dell'area di lavoro sono simili a una password per l'area di lavoro Microsoft Playwright Testing. Proteggere sempre con cura i token di accesso. Evitare di distribuire i token di accesso ad altri utenti, impostarli come hardcoded o salvarli in un file di testo normale accessibile ad altri.

Revocare e ricreare i token se si ritiene che siano compromessi.

Per abilitare l'autenticazione tramite i token di accesso:

  1. Accedere al portale Playwright con l'account Azure e selezionare l'area di lavoro.

  2. Selezionare l'icona delle impostazioni nella home page per passare alle impostazioni dell'area di lavoro.

  3. Selezionare la pagina Autenticazione e attivare Abilitare l'autenticazione usando i token di accesso

    Screenshot che mostra la pagina delle impostazioni dei token di accesso nel portale di Playwright.

Attenzione

L'autenticazione tramite token di accesso è meno sicura. Informazioni su come gestire i token di accesso

Configurare l'autenticazione tramite i token di accesso

  1. Durante l'esecuzione dei test, abilitare l'autenticazione tramite token di accesso nel file playwright.service.config.ts nel programma di installazione.

    /* Learn more about service configuration at https://aka.ms/mpt/config */
    export default defineConfig(config, getServiceConfig( config {
        serviceAuthType:'ACCESS_TOKEN'
    }));
    
  1. Durante l'esecuzione dei test, abilitare l'autenticazione tramite token di accesso nel file .runsettings nel programma di installazione.

    <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. Creare un token di accesso

    Seguire la procedura per creare un token di accesso. Copiare il valore del token di accesso generato.

  1. Configurare l'ambiente

    Per configurare l'ambiente, configurare la PLAYWRIGHT_SERVICE_ACCESS_TOKEN variabile di ambiente con il valore ottenuto nei passaggi precedenti. Assicurarsi che questa variabile di ambiente sia disponibile nell'installazione in cui si eseguono i test.

    È consigliabile usare il modulo per gestire l'ambiente dotenv. Con dotenv, si definiscono le variabili di ambiente nel file .env.

    1. Aggiungere il modulo dotenv al progetto:

      npm i --save-dev dotenv
      
    2. Creare un file .env insieme al file playwright.config.ts nel progetto Playwright:

      PLAYWRIGHT_SERVICE_ACCESS_TOKEN={MY-ACCESS-TOKEN}
      

      Assicurarsi di sostituire il segnaposto di testo {MY-ACCESS-TOKEN} con il valore copiato in precedenza.

  1. Configurare l'ambiente

    Per configurare l'ambiente, configurare la PLAYWRIGHT_SERVICE_ACCESS_TOKEN variabile di ambiente con il valore ottenuto nei passaggi precedenti. Assicurarsi che questa variabile di ambiente sia disponibile nell'installazione in cui si eseguono i test.

Eseguire test nel servizio e pubblicare i risultati

Eseguire test Playwright su browser ospitati nel cloud e pubblicare i risultati nel servizio usando la configurazione creata in precedenza.

npx playwright test --config=playwright.service.config.ts --workers=20
dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20