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:
Accedere al portale Playwright con l'account Azure e selezionare l'area di lavoro.
Selezionare l'icona delle impostazioni nella home page per passare alle impostazioni dell'area di lavoro.
Selezionare la pagina Autenticazione e attivare Abilitare l'autenticazione usando i token di accesso
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
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' }));
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>
Creare un token di accesso
Seguire la procedura per creare un token di accesso. Copiare il valore del token di accesso generato.
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
. Condotenv
, si definiscono le variabili di ambiente nel file.env
.Aggiungere il modulo
dotenv
al progetto:npm i --save-dev dotenv
Creare un file
.env
insieme al fileplaywright.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.
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
Contenuto correlato
- Altre informazioni sulla gestione dei token di accesso.