Testing pages with authentication

Calibre can authenticate to your site before a test starts.

There are three methods of authentication available:

  • Test Profiles: Cookies and custom headers
  • Form based login
  • HTTP Basic Authentication

Test Profiles: Cookies and custom headers

Test profiles are the most straight-forward way of handling authentication. Authentication is generally achieved by setting cookies or custom headers on some, or all of the test profiles configured for a site.

The Calibre agent will use those cookies and headers for each request made to your site during a test.

For more information on what test profiles are, see the Test Profiles guide page.

Form authentication

Calibre can also log into your site as if it was one of your users. Just like when automating a test suite using a tool like Selenium.

While setting up a new site, or in the settings area for each site, check "This site requires authentication".

This site requires authentication

From here, you’ll need to give Calibre a URL to find the login form, a username and password, as well as the CSS selectors that are required to find the form.

URL
Form selector
Username selector
Password selector
Username
Password

HTTP Basic Authentication

HTTP Basic Authentication is most often used for staging sites or pages that are temporarily behind authentication.

Authentication information can be added to the URL of your site:

Name of your site
URL

Other options and getting help

Our friendly support staff have helped hundreds of companies authenticate their sites with Calibre. If none of the options above quite work for your environment, please contact support for further assistance.