@intility/cypress-msal

A cypress plugin for projects using @azure/msal-browser.

Installation

npm install @intility/cypress-msal

Usage

Register the package in cypress/support/e2e.js:

1import "@intility/cypress-msal/command";

Configure the login command, and add it as a task in cypress.config.js:

1import { defineConfig } from "cypress"
2import generateLogin from "@intility/cypress-msal"
3
4let publicClientConfig = {
5  auth: {
6    clientId: "APP_CLIENT_ID",
7    authority: "https://login.microsoftonline.com/TENANT_ID",
8  },
9};
10
11let requests = [
12  {
13    scopes: ["User.Read"],
14  },
15];
16
17let login = generateLogin(publicClientConfig, requests);
18
19export default defineConfig({
20  // ...other cypress settings here...
21  e2e: {
22    setupNodeEvents(on, config) {
23      // `on` is used to hook into various events Cypress emits
24      on("task", {
25        // register a task named login which calls the generated login from @intility/cypress-msal
26        login,
27      });
28    }
29  }
30})

You can now login by using the login command before running your tests.

1before(() => cy.login());

Azure Configuration

The App registration needs to be a Public Application to be able to use the Device Code flow.

generateLogin

Syntax

1let login = generateLogin(publicClientConfiguration, requests);

Parameters

publicClientConfiguration

A Configuration that will be used to initialize a PublicClientApplication from @azure/msal-node.

requests

An array of Requests ({ scopes: string[] }) that will be used for acquireTokenByDeviceCode and acquireTokenSilent.

Return value

A task plugin named login that should be registered with on("task", { login }).

cy.login

Syntax

cy.login()

Return value

A Promise that get resolves when all tokens are acquired and registered in sessionStorage to be used by @azure/msal-browser.