Start Free Trial
Back to guides

Run Authenticated Scans in UserWay’s Accessibility Monitor

What is an accessibility statement?
March 04, 2024

Basic Authentication

HTTP Basic authentication simply means the application sends a username and password with every request, and those credentials are also often stored or saved on the device.

To add a site that is under HTTP basic authentication, follow the steps below:

  1. Log in to your Accessibility Monitor account.
  2. Click on + New Scan to create a new scan.
  3. Switch to the Authenticated Scan tab to choose the authentication method.
    Form auth
  4. Add the site or page you would like to scan, then change to Basic Authentication.
    Basic authentication
  5. Add the Username and Password, then click the Start Scan button.
    Basic Authentication credentials

Form Authentication

The authentication form is implemented directly on the website in form format. The user needs to enter a username and password to access protected content, e.g., our Accessibility Monitor login page.

The following example shows how selectors would look using our Accessibility Monitor authentication form: User Name Field Selector, Password Field Selector, and the Submit button Selector.

To add a site that is under Form Authentication, follow the steps below:

  1. Inspect your website authentication form in a web browser using the developer tool.
    Browser console inspect element
  2. Click + New Scan and Authenticated Scan.
  3. Click Form Authenticated Scan.
    Form authentication URL
  4. Add your Username and Password, and fill in the form based on the inspection result from Step 1.
    Form authentication credentials
  5. Fill in the form using the selectors from the contact form.
  6. Click Start Scan to add the authenticated form page to the Accessibility Monitor.
    Form authentication start scan

The selectors and IDs above are just examples. They can vary according to the structure of the page. Use your browser’s inspect tool to obtain the information or consult with a developer.

Scenario Authentication

Scenario Authentication is used when the authentication system has a specific scenario, e.g., Authentication requires multiple steps or Authentication requires more than just a username/email and password.

In the following example, we will use the https://login.live.com/ website as an example, along with some commonly used commands, to create an authentication scenario:

Commands/code:What the command/code does:
clickOnSelector('selector: string')Performs a mouse click on a given CSS selector.
typeInSelector('selector: string, text: string')Performs text typing to an input (or text area) within a given CSS selector.
waitForTimeout(timeout: milliseconds)Pauses scenario execution for a given timeout. We recommend using this command whenever the page or the page’s DOM changes.
  1. Go to https://login.live.com/ and inspect the username form (find the CSS field selector for email, e.g.: typeInSelector('input[type="email"]', 'test@test.com');
    Scenario Authentication checking elements
  2. Find the CSS field selector for the password, e.g.:
    typeInSelector('input[type="password"]', 'testing');
    Scenario Authentication adding credentials
  3. Log in to your Accessibility Monitor account.
  4. Go to + New Scan > Authenticated Scan > Scenario authentication.
  5. Add the site or page you would like to scan & monitor, along with the authentication access details:
    Adding the script for the scenario

If you require additional assistance, feel free to contact us at desk@support.userway.org.

Explore UserWay’s Accessibility Widget

Discover More