Learn Information Security

HTTP error code 401

The HTTP 401 "Unauthorized" status code is a client error response that signifies the request lacks valid authentication credentials for the target resource. Unlike a 403 "Forbidden" error (where you're known but denied access), a 401 means you haven't properly identified yourself or the identification provided was invalid (e.g., incorrect password, expired token). The server needs you to log in or provide better credentials.

🧑‍💻 Solutions for End-Users

When you encounter a 401 error as a general user, the fixes are typically simple authentication or browser maintenance steps:

Log In Again: The most common solution is to log out and then log back in. This ensures your browser gets a fresh, valid session cookie or authentication token from the server.
Clear Browser Data: An outdated or corrupted cache and cookies can cause the browser to send old or malformed authentication credentials. Clearing this data and logging in again often resolves the issue.
Refresh the Page: Sometimes, the server issue is transient. A simple page refresh can prompt the server to reissue a challenge or complete a delayed authorization check.
Check Network Restrictions: If you're on a corporate or protected network, the network itself might be interfering with the authentication handshake. Testing the site from a different network can rule out this possibility.

💻 Solutions for Developers and Administrators

For those managing the website or application, troubleshooting involves verifying the integrity of the authentication process:

Verify Authentication Headers: Ensure the client is correctly sending the necessary authentication data in the Authorization header. This typically involves validating the format and content of Basic or Bearer tokens.
Debug API Tokens and Permissions: If the client is using an API token, confirm that the token itself is active, unexpired, and has the necessary scopes or permissions to access the requested resource.
Review Server Configuration: Check all server-side settings, including firewalls, security plugins, and API gateway rules, to ensure they are not incorrectly stripping authentication headers or blocking valid requests.
Monitor Server Logs: The most reliable way to diagnose the failure is to check the server's access and error logs. These logs often provide specific details on why the authentication challenge failed (e.g., "invalid signature," "token expired").

error code 502

The HTTP 502 "Bad Gateway" error is a definitive server-side error indicating a communication breakdown between servers. It means that a server, acting as a gateway or proxy to fulfill your request, received an invalid response from the upstream server it was trying to reach. Crucially, this is rarely an issue with your own computer or internet connection.

📡 The Communication Failure

The 502 error highlights a fundamental server-to-server failure within the website's infrastructure:

Server-Side Communication: When you access a website, your request often passes through several servers. A gateway server sits in front of the application or origin server. The 502 error occurs when the gateway expects a valid HTTP response from the upstream server but receives something that is malformed, corrupt, or, more often, no response at all.
Common Causes on the Server: The most frequent triggers are server overload (too many requests are crashing the upstream server), firewall misconfigurations (blocking the gateway's traffic), or simply errors in the website's code that prevent the application server from sending a proper response.
Network Problems: Less commonly, the error can point to a network issue between the two servers involved, or even a temporary routing failure on a global scale.

🧑‍💻 What to Do if You Encounter a 502

Since the issue usually isn't with your device, these simple steps are the best way to resolve it:

Reload the Page: This is the best first step. The issue is often temporary (e.g., a brief server overload), and a simple refresh can catch the server after it has recovered.
Clear Browser Data: An outdated or corrupted browser cache and cookies can sometimes lead to communication issues. Clearing them might resolve the error.
Try a Different Browser: Testing the site in a different browser or an incognito/private window rules out your primary browser's extensions or settings as the culprit.
Check Global Status: Use a third-party tool to see if the website is down for everyone. If it is, the problem is on their end, and the only solution is to wait for the administrators to fix the core server issue.

If all these steps fail, the problem is entirely out of your control, and you will simply need to try accessing the resource again later.

Request Error: HTTP 421

The HTTP 421 "Misdirected Request" client error status code signals that the server receiving the request is unable to produce a response. This happens because the server is not configured to handle the specific combination of the scheme (e.g., http or https) and authority (e.g., domain name like example.com) found in the request's URI. Essentially, the request has been routed to the wrong virtual host or configuration block on the server.

Szenarios Causing the 421 Error

This error often arises in complex networking setups involving proxies and multiple virtual hosts:

SSL Handshake Failure (Missing SNI): This is a very common cause, particularly when a proxy server (like Nginx) routes traffic to a backend server (like Apache). If the backend server requires Server Name Indication (SNI) during the TLS handshake to know which certificate to use, and the proxy fails to correctly forward the target hostname, the backend will reject the connection with a 421.
Incorrect Host Header Configuration: Servers are often configured to listen for a specific Host header value (www.domain.com). If an intermediary, such as a CDN or load balancer, rewrites or forwards the request with a Host header that the origin server doesn't expect or recognize, the server considers the request misdirected.
Connection Reuse Issues (HTTP/2): With protocols that allow connection multiplexing, like HTTP/2, a client might attempt to reuse an existing connection for a request that the server subsequently identifies as belonging to a different authority it cannot handle on that channel.

Troubleshooting and Solutions

Resolving a 421 error generally requires checking configurations across multiple system components:

Verify Server Configuration: Ensure the origin server has a correctly defined Virtual Host or server block that explicitly listens for and accepts the combination of the protocol (scheme) and domain (authority) in the request.
Review Proxy/Load Balancer Settings: If an intermediary is involved, check its settings to confirm it is correctly preserving or forwarding the original Host header and SNI information to the backend server.
Examine Client Behavior: If the error is intermittent, particularly with HTTP/2, investigate if the client is aggressively reusing connections in a way that violates the server's assumptions about that connection.
Handle FTP 421 Separately: Note that the FTP 421 "Too many connections" error is completely distinct from the HTTP error and requires managing the limit of simultaneous FTP connections from your IP address.

Request Error: HTTP 406

The HTTP 406 "Not Acceptable" status code is a client error response that occurs during proactive content negotiation. It means the server cannot produce a representation of the requested resource that is compatible with the preferences defined by the client in its request headers. In simple terms, the client asked for content in a specific format (or language, or encoding), and the server cannot fulfill that exact requirement.

🙅 Why the Content is Unacceptable

The core issue lies in the mismatch between the client's stated preferences and the server's available resources:

Accept Header Mismatch: The client's Accept header specifies a list of preferred MIME types (e.g., application/json, image/jpeg, text/html), but the server does not have, or is not configured to provide, a resource in any of those formats.
Other Accept-* Header Issues: The conflict isn't limited to content type. It can also involve:
- Accept-Language: The server cannot provide the resource in the requested language (e.g., French).
- Accept-Encoding: The server cannot use the requested compression algorithm (e.g., gzip).
- Accept-Charset: The server cannot use the preferred character encoding (e.g., UTF-8).
Server Misconfiguration: Even if the file exists, the server's settings (e.g., Apache's configuration or application-level rules) might incorrectly restrict it from serving the content with the appropriate header, leading to a 406.

🔧 Troubleshooting and Resolution Steps

Since this error is driven by the client's request headers, the solution usually involves modifying those headers or checking server capability:

Review and Adjust Accept Headers: If you are a developer using an API, carefully inspect the Accept headers your client is sending. Ensure the requested content type (e.g., application/json) is precisely what the server is expected to provide, as stated in the API documentation.
Allow Default Content: If feasible, try removing or simplifying the Accept header. This tells the server to return its preferred or default representation, which might be acceptable to the client.
Check Server Configuration (If You Control It): Verify that the server is correctly configured to map file types to the appropriate MIME types and that it is able to handle the content types being requested.
Clear Browser Data: For browser-based errors, clearing the cache and cookies can sometimes resolve temporary issues where stale data is causing the client to send incorrect or overly restrictive Accept headers.

Request Error: HTTP 426

The HTTP 426 "Upgrade Required" status code is a response from the server indicating that it refuses to process the request using the client's current communication protocol. The server is essentially saying, "I can't talk to you this way, but if you switch to a newer protocol, we might be able to proceed."

Crucially, when a server sends a 426 response, it must also include an Upgrade HTTP header. This header explicitly names the required protocol(s) that the client must switch to (e.g., Upgrade: HTTP/2.0, TLS/1.3).

🛑 Why an Upgrade is Required

The need for a protocol upgrade usually stems from security, performance, or compatibility mandates:

Protocol Incompatibility: The client is using an outdated or unsupported protocol version (e.g., an old version of HTTP or a deprecated TLS version), and the server has been configured to reject it.
Enforced Newer Protocols: The server is configured to enforce the use of a specific, newer protocol for better performance or features, such as demanding HTTP/2 instead of HTTP/1.1.
Security Requirements: The most common real-world scenario is when a server requires a secure connection (HTTPS) and uses the 426 status to reject requests arriving over an insecure HTTP connection, demanding an upgrade to the secure TLS protocol.

✅ How to Resolve a 426 Error

Resolving this error involves making a change on the client side based on the server's directive:

Modify the Request Protocol: Look at the Upgrade header in the server's response and change the client's request to use the specified protocol. For instance, if the header specifies TLS/1.2, the client needs to re-establish the connection using that TLS version.
Update Software: Ensure the client software, operating system, and networking libraries are fully updated to support the latest protocol versions required by the modern web (e.g., ensuring support for HTTP/2 or recent TLS versions).
Use HTTPS: If the error is due to security requirements, simply change the URL from http:// to https://.

If you are the server administrator, you may need to adjust the server's configuration to support a wider range of protocols or to correctly enforce the security and performance policies you intend.