---
title: Enable Override Request URL Protocol
description: Enable if the agent is behind a SSL/TLS off-loader, load balancer, or proxy, where the users and the agent use a different protocol. When true, the protocol is overridden with the value from Agent Deployment URI Prefix.
component: web-agents
version: 2025.11
page_id: web-agents:properties-reference:com.sun.identity.agents.config.override.protocol
canonical_url: https://docs.pingidentity.com/web-agents/2025.11/properties-reference/com.sun.identity.agents.config.override.protocol.html
---

# Enable Override Request URL Protocol

Enable if the agent is behind a SSL/TLS off-loader, load balancer, or proxy, where the users and the agent use a different protocol. When `true`, the protocol is overridden with the value from [Agent Deployment URI Prefix](com.sun.identity.agents.config.agenturi.prefix.html).

When the following headers are defined on the proxy or load-balancer, they override the value of [Agent Deployment URI Prefix](com.sun.identity.agents.config.agenturi.prefix.html):

* `X-Forwarded-Proto`

* `X-Forwarded-Host`

* `X-Forwarded-Port`

If you are using these headers, do not configure this property.

Default: `false`

|                    |                                                                                  |
| ------------------ | -------------------------------------------------------------------------------- |
| Property name      | `com.sun.identity.agents.config.override.protocol`   Introduced in Web Agent 4.x |
| Function           | Load balancing                                                                   |
| Type               | Boolean: `true` returns true; all other strings return `false`.                  |
| Bootstrap property | No                                                                               |
| Required property  | No                                                                               |
| Restart required   | No                                                                               |
| AM console         | Tab: `Advanced`Title: `Enable Override Request URL Protocol`                     |