Skip to content

How does the Basic Auth warning work?

A staging or test website is usually locked behind Basic Auth (some hosts call it password protection or HTTP authentication): the browser asks for a user name and password before it shows anything, so search engines and visitors never see the site. The Basic Auth warning tells you when that lock is gone and anyone can open the website. It is a switch on the monitor, not a check of its own: the monitor keeps checking the page as you set it up.

What it checks

One monitor does it all. With the warning on, each check of the website's uptime monitor first asks for the page without the password:

  • The website asks for its user name and password: Basic Auth is on. The check asks again with the saved password and judges the page by its usual settings (its status, its keyword).
  • The website shows its page without asking: Basic Auth is off. That page is judged as usual too.

So the monitor still tells you whether the page works, keyword and all, and the warning only adds what it saw about Basic Auth.

Only a page that loads on the website's own address counts as off. A deleted website, a page that is not there (404 or 410), a server's default page or no answer at all is the monitor's own problem, as for any website, never a "Basic Auth is off". Sent to a sign-in address of the website's own domain, such as auth.example.com, the check counts Basic Auth as on (behind a sign-in page).

The password is only sent over https://, so the warning needs an https:// address and a saved user name and password.

What you see

The check finds The monitor shows Counts as
The website asks for its password, and the saved one lets us in Its usual state, such as Up Basic Auth on, as it should be
The website opens without asking, twice in a row Basic Auth is off since 09:14. Anyone can open it. Needs attention
The website asks, and no password is saved Basic Auth password needed: we cannot check the page. Needs attention
The website asks, and refuses the saved password Basic Auth password refused: it was probably changed. Needs attention

None of them is ever Down, and none lowers the uptime figure: the website answers. The state icon is amber, and the monitor is listed under Needs attention in the Monitors list. One answer without Basic Auth never counts: it takes two in a row, and two with Basic Auth on in a row to end it. On the monitor's page, Save the user name and password opens its Settings for a needed or refused password.

"Password needed" and "Password refused" show on every monitor that meets a Basic Auth lock, with the warning on or not.

When you hear

  • An email when Basic Auth is off: when the website opens without asking twice in a row. One odd answer never emails.
  • Reminders after 1 hour, 4 hours and 1 day, then every day, while it stays off.
  • An email when Basic Auth is back on: when the website asks for its password twice in a row.
  • One email when a password is needed or refused, and again only after it was fixed and broke again.

Your account chooses how many emails about Basic Auth being off you get: reminders every day (the default), one reminder, no reminders, or none at all (Basic Auth warnings).

These emails go to your account's alert email only, never to a group's addresses (which emails you get).

Switch it on or off

The Basic Auth warning comes with the paid plans.

  • Switch it on: open the monitor's Settings. In the Basic Auth section, save the user name and password, then switch on Warn me when Basic Auth is off: it is saved at once. The monitor is marked Staging. Without a saved user name and password the switch is greyed out and says Save the user name and password first.
  • A live-looking address: when the address is the website's main address, such as example.com, or has no word such as staging, dev or test, an amber line under the switch says the Basic Auth warning warns whenever the website opens without a password. You can still save.
  • On by default with a password: when you add a monitor with a password under Basic Auth, Warn me when Basic Auth is off is on beside it. Saving a first password on a monitor switches the warning on too. A warning someone switched off stays off.
  • Switch it off: switch it off in the Basic Auth section of Settings; it is saved at once. Nothing to type; the monitor's page then says "Basic Auth warning switched off by" your name and the date. It stays off until someone switches it on again, also when a password is saved.
  • By itself: removing the saved password, or changing the address to http://, switches the warning off, and the monitor's history says why. Pausing the monitor, switching the warning off or changing the address ends a warning that was open, without an email.

Pause warnings for 24 hours

Working on a test website and opening it for a while? On the monitor's page, under its uptime check in What we check, click Pause Basic Auth warnings for 24 hours, or Pause warnings for 24 hours in the Basic Auth section of its Settings. The checks keep running, and the page says who paused the warnings and until when. No email about Basic Auth being off comes while they are paused, and reminders due meanwhile are skipped; if the website is still open when the pause ends, the email comes then, with the time it opened. When a website you were already told about asks for its password again, that email still comes during a pause. With your account's warnings set to Off, the page says so instead, and there is nothing to pause. Resume Basic Auth warnings ends the pause at once. Owners and Admins can pause, on the paid plans.

Monitors with a saved password and the warning off are counted in a tip on top of the page: a password but its Basic Auth warning is off.