IBM Support

Error message 407 Proxy Authentication Required

How To


Summary

The error message 407 Proxy Authentication Required indicates the request to download the Admin UI content payload was blocked by a proxy server that requires authentication.

Objective

Steps to Troubleshoot and Fix Proxy Issue:

Steps

1. Verify Proxy Settings:

   - Check if your network uses a proxy server. If so, ensure your application or system is configured with the correct proxy settings, including the proxy address, port, and credentials (username/password).

   - For Windows:

     - Go to Settings > Network & Internet > Proxy and check the proxy configuration.

     - Alternatively, run `netsh winhttp show proxy` in Command Prompt to view the current proxy settings.

   - For Linux/macOS:

     - Check environment variables like `http_proxy`, `https_proxy`, or `all_proxy` using `echo $http_proxy` in the terminal.

2. Provide Proxy Authentication:

   - If the proxy requires authentication, ensure the credentials are correctly configured in your application or system.

   - For command-line tools (e.g., `curl`, `wget`):

     - Example for `curl`: `curl --proxy-user username:password -x http://proxy-server:port <URL>`

     - Example for environment variables: `export http_proxy=http://username:password@proxy-server:port`

   - For applications, check their configuration files or settings for proxy authentication options.

3. Bypass Proxy for Internal URLs (if applicable):

   - If the Admin UI content is hosted on an internal server, configure a no-proxy rule for the specific URL or domain.

   - For example, set the `no_proxy` environment variable: `export no_proxy=localhost,127.0.0.1,internal-domain.com`

4. Check Application-Specific Proxy Settings:

   - If the error occurs in a specific application (e.g., a web browser or admin tool), check its proxy settings.

   - For browsers:

     - Chrome: Settings > System > Open your computer’s proxy settings.

     - Firefox: Settings > General > Network Settings.

   - For custom applications, refer to their documentation for proxy configuration instructions.

5. Network Configuration:

   - Contact your network administrator to confirm the proxy server details and obtain valid credentials.

   - Ensure the proxy server is accessible and not misconfigured.

6. Test Connectivity:

   - Try accessing the URL directly (e.g., using `curl` or a browser) to confirm if the issue is proxy-related or if the server itself is unreachable.

   - Example: `curl -v <URL>` to see detailed error messages.

7. Update or Clear Proxy Cache:

   - If the proxy server caches authentication or content, clear the cache or restart the proxy service (if you have administrative access).

   - Ensure your proxy client or application is updated to the latest version to avoid compatibility issues.

8. Firewall or Security Software:

   - Check if a firewall or security software is intercepting the connection and enforcing proxy authentication. Temporarily disable it to test, or configure it to allow the connection.

Additional Information

If You’re a Developer: (OPTIONAL)

- Code-Level Fix:

  - If your application makes HTTP requests, ensure the HTTP client library (e.g., `HttpClient` in .NET, `requests` in Python) is configured with proxy credentials.

  - Example for .NET (`HttpClient`):

    ```csharp

    var handler = new HttpClientHandler

    {

        Proxy = new WebProxy("http://proxy-server:port", false)

        {

            Credentials = new NetworkCredential("username", "password")

        }

    };

    var client = new HttpClient(handler);

    ```

  - Example for Python (`requests`):

    ```python

    import requests

    proxies = {

        "http": "http://username:password@proxy-server:port",

        "https": "http://username:password@proxy-server:port"

    }

    response = requests.get("URL", proxies=proxies)

    ```

  - Ensure the proxy server allows HTTP range requests and partial responses (e.g., “Allow HTTP partial response” in Palo Alto firewalls).

Example:

image-20250811094654-1

Example within Microsoft’s “Proxy server support in Configuration Manager‘s support page:”

image-20250811094654-2

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSC323V","label":"HTTP Monitor"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":""}]

Document Information

Modified date:
11 August 2025

UID

ibm17241955