Skip to main content

Running Authenticated Scans in UserWay's Accessibility Monitor

Many websites have pages that require authentication. UserWay's Accessibility Monitor supports different types of authentication.

Updated over a year ago

UserWay's Accessibility Monitor is the most dynamic.....

Some websites are entirely or partially behind a user login and require authentication. This can be a pre-production environment or a secure area of your website. The need for digital accessibility does not stop at your login screen. UserWay's Accessibility Monitor offers 3 different types of authentication; Basic authentication, Form authentication, and Scenario authentication as shown below:

1. Basic Authentication (Only used for HTTP basic authentication):

Basic Authentication Example - Screenshot

Example: https://jigsaw.w3.org/HTTP/Basic/,
User Name: "guest"
Password: "guest"

Basic Authentication - Screenshot

2. Form Authentication (Used to complete a form login):


​Requirements:

  • Required Form Fields

    • Login Url

    • User Name

    • User Name Field Selector

    • Password

    • Password Field Selector

    • Submit button selector

  • Understanding of CSS selectors.

  • We recommend providing unique IDs for each field and submit button.

Check out here for more info about CSS selectors: https://www.w3schools.com/css/css_selectors.asp

Understanding of CSS selectors. We recommend providing unique IDs for each field and submit button. For Reference: https://www.w3schools.com/css/css_selectors.asp

Email field ID: #email

email ID - Screenshot

Password field ID: #password

Password ID - Screenshot

Submit button selector: button[type="submit"]

Submit Button - Screenshot
Form authentication - Screenshot

3. Scenario Authentication (Used for any other type of login):
​
​Scenarios:

  • Authentication requires multiple steps.

  • Authentication requires more than username/email and password.

Requirements:

  • Understanding of CSS selectors.

  • Understanding of UserWay's Scenario Scan commands.

  • Understanding of basic Javascript.

Frequently used commands:

  • clickOnSelector('selector: string'): Performs mouse click on a given CSS selector

  • typeInSelector('selector: string, text: string'): Performs text typing to an input (or a textarea) 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. Find CSS field selector for email i.e. typeInSelector('input [type="email")','test@test.com';

2. Find CSS field selector for Password i.e. typeInSelector('input [type="password")','testing';

Microsoft Password - Screenshot

3. Add Custom Scenario Code Below the Login Url

Scenario Authentication Code - Screenshot

Final result:

Scenario Authentication - Sceenshot

If you have any questions, you can reach our support team at support@userway.org

Did this answer your question?