Authenticating Calibre

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".

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.

HTTP Basic Authentication

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

Basic Authentication works by sending the password as a request header. Therefore, this should be considered safe only over HTTPS / TLS.

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.