Add login configuration
Add basic or form authentication for visual scanning.
Web pages with sensitive or confidential content require users to authenticate themselves for access. With Visual scanner, you can add login configuration to ensure visual scanning by authenticated users. Visual scanner supports the following types of login configuration:
- Form authentication: Requires users to enter their credentials on a login form. The server then validates the credentials against a list of authorized users. Users can access the requested resource if their credentials are valid, otherwise they are denied access.
-
Basic authentication: Requires users to provide their credentials in a pop-up. These credentials are then sent to the server in plaintext, encoded with
Base64
.
- There can only be one authentication type per project. Visual scanner scans all pages in your project with the same authentication type and credentials. Having multiple authentication types on the same page, or having the same authentication type with different credentials, could cause inconsistencies.
- Basic authentication is not supported by the Safari browser.
Configure form authentication
To add a login configuration for form authentication, follow these steps:
Navigate to Visual Scanner from Percy dashboard, and you are redirected to the Website Scanner. Click New scan.
Add pages for the scan and click Next.
In Scan name, enter a Name for the scan.
Expand Scan settings and then click Add in Test pages behind login. The Add a new configuration window opens.
In Login page URL, enter the URL of the website you want to scan.
Enter the Username and Password to log in to the website.
To ensure security, use test accounts when testing.
Enter the selectors for the following fields:
- Username selector: The CSS selector for the username text field on the login page
- Password selector: The CSS selector for the password text field on the login page.
-
Submit button selector: The CSS selector for the button you click after entering the credentials on the login page
For more information, see Find CSS selectors.
Click Save & Confirm.
Configure basic authentication
To add a login configuration for basic authentication, follow these steps:
Navigate to Visual Scanner from Percy dashboard, and you are redirected to the Website Scanner. Click New scan.
Add pages for the scan and click Next.
In Scan name, enter a Name for the scan.
Expand Scan settings and then click Add in Test pages behind login. The Add a new configuration window opens.
Enter a configuration name, and ensure that Basic authentication is selected as the authentication type.
Enter the Username and Password to log in to the website.
Click Save & Confirm.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!