HTTP Authentication
Monitor Password-Protected Pages
Website performance monitors can send an HTTP authentication header with every audit request. This lets you track pages that sit behind a login, such as staging environments, admin dashboards or member areas, the same way you monitor public pages.
Supported authentication types
- Basic Auth: enter a username and password and LoadFocus builds the
Authorization: Basicheader for you. - Bearer Token: paste an API or access token and it is sent as
Authorization: Bearer <token>. - Custom Header: send any single header name and value, for example
X-Api-Key, or aCookieheader for session-protected pages.
Steps to add authentication to a monitor
- Open the New Website Performance Monitor Configurator and click New Test.
- Fill in the URL, name, location and device as usual.
- In the Authentication (optional) dropdown, pick Basic Auth, Bearer Token or Custom Header.
- Fill in the credential fields that appear.
- Run the test now or save it with a schedule. Scheduled runs keep using the saved authentication automatically.
Monitoring pages behind a session login
If your page uses a session cookie instead of Basic Auth or a token, log in with your browser, copy the session cookie from the developer tools, then create a monitor with a Custom Header named Cookie and the value your_cookie_name=your_cookie_value. As long as the session stays valid, the monitor renders the logged-in page. If the session expires, the monitor quietly starts measuring your login page instead, so check the result screenshot if scores change unexpectedly.
Good to know
- The header is attached to every request Lighthouse makes during the audit, including assets loaded by the page.
- Credentials never appear in your reports. LoadFocus removes them from the stored results before anything is displayed or shared.
- Header values cannot contain single quotes or control characters, names are limited to 128 characters and values to 2048 characters.
- Combine authentication with alerts to get notified when a protected page slows down.