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 straightforward way of handling authentication. You can authenticate 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. Learn more about Test Profiles.

Form Authentication

Calibre can also log in to 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 provide Calibre with 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.

Getting Help

If none of the above options quite work with your environment, reach out to our technical support team for further assistance.