Skip to main content

Investigate 401 Responses That Only Affect Your Uptime Probe

GuideWritten by oncall.fyi editorialPublication approved by Burak YApproval recorded 12 September 2026
Sources and verification
Source dates
Oldest source check: 12 September 2026.
Technical verification
Separate technical verification has not been recorded.

Publication approval and technical verification are recorded separately. Automated link checks establish reachability, not accuracy. A checked example verifies only its stated test cases, not the whole article or your production setup.

In short

Find which layer returns the 401, then compare the monitor’s actual request with a successful one. Match URL, method, headers, credentials, redirects, source network, and address family. A browser may be authenticated while the probe is not. Fix the intended machine-access contract or a scoped policy mistake; accepting 401 as healthy can hide the original failure.

Key takeaways

  • Identify the responding authentication layer before changing credentials.
  • Source-specific failures need edge and origin evidence.
  • A green status obtained by accepting an error may measure the wrong contract.

Capture the challenge and the responding layer

Record the failing response status, authentication challenge, relevant response headers, and timestamp. The HTTP semantics specification (opens in a new tab) defines 401 in terms of missing or invalid authentication credentials for the target resource. A reverse proxy, access gateway, or application may be the component enforcing that requirement.

Match the request in edge and origin logs using time, source address, path, and request identifier when available. If the origin never receives it, changing application credentials may not affect the layer returning the response. Do not infer the cause solely from the IP hosting provider or a response banner.

Compare equivalent requests

Export a redacted monitor configuration and compare it with a successful request. A logged-in browser supplies cookies and may complete redirects automatically. Another uptime provider may use a different method, user agent, source network, region, or authentication setting.

DifferenceHow it can change the result
Path or trailing slashDifferent application or access rule
GET versus HEADDifferent endpoint handling
Redirect destinationNew hostname or authentication boundary
Missing machine credentialExpected rejection
Different source networkEdge access policy or routing
Different address familyDifferent backend or edge path

Reproduce the request from the checking runtime's network. curl's request and connection controls (opens in a new tab) are useful for isolating one difference at a time. Keep verbose traces private and redact secrets before sharing them.

Inspect redirects before forwarding secrets

Capture the initial response and each destination in the chain. A redirect to a login page can produce either an explicit 401 or an apparently successful HTML response that is unsuitable for an application health check.

Do not enable unrestricted credential forwarding across redirects. Confirm that the destination is part of the intended authentication boundary and configure the correct endpoint directly where practical. A probe should not send a privileged token to an unrelated host because a redirect appeared in a response.

Fix the defined access contract

For a protected application endpoint, provision a machine identity with only the access needed for the health assertion. Test its expiry and rotation. If a minimal health endpoint is deliberately public, verify it reveals no sensitive application data and still detects the failures you care about.

If an edge rule incorrectly blocks an authorized probe, make the smallest justified adjustment: the specific endpoint, method, identity, or supported source policy. Avoid disabling authentication or the WAF broadly. Re-test from an unauthorized source so the monitoring fix does not erase the original protection.

Validate success and deliberate rejection

Use the valid test identity to obtain the expected application response and an invalid identity to obtain the expected denial. Break the test backend while keeping the authentication gateway available; the health assertion must still fail. Record response status and meaningful content, rather than merely checking that some page loads.

A monitor may intentionally verify that a protected endpoint rejects anonymous access, but name that as an authentication check. It cannot also stand in for proof that an authorized user can use the service. Keep the two contracts separate in routing and dashboards.

Did this help?

Your answer helps us improve this guide. We save only the page and your choice for 30 days.

No name, email, or incident details are requested.

Sources

Vendor facts change. Each source below shows the date this page last checked it.

  1. RFC 9110 HTTP semantics IETF. Checked 12 September 2026.
  2. curl command-line reference curl. Checked 12 September 2026.

Related

One practical idea, occasionally

The On-Call Brief: short field notes, templates, and operational lessons.

Follow the field guide

Email subscriptions are not open yet. Read new guides in your feed reader — no email address needed.

Subscribe with RSS