> [!CAUTION]
> You are currently viewing version 1.14 of the Apigee hybrid documentation. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.14 </button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/forward-proxy.md.txt)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/forward-proxy.md.txt)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/forward-proxy.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/forward-proxy.md.txt)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/forward-proxy.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/forward-proxy.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/forward-proxy.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/forward-proxy.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/forward-proxy.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/forward-proxy.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/forward-proxy.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/forward-proxy.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/forward-proxy.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/forward-proxy.md.txt)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/forward-proxy.md.txt)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/forward-proxy.md.txt)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/forward-proxy.html)

> [!NOTE]
> **Note:** Both Apigee and Apigee hybrid support [forward proxy functionality](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/environments-overview.md.txt#forward-proxying). Use the instructions on this page to configure forward proxies for hybrid rather than the general Apigee functionality.

Forward proxies provide a single point through which multiple machines send requests to an
external server. They can enforce security policies, log and analyze requests, and perform other
actions so that requests adhere to your business rules.

Using a forward proxy in Apigee hybrid,
you can intercept and manage all egress traffic from your Kubernetes cluster. This includes API
proxy requests to Target Endpoints and communication with `*.googleapis.com` that the hybrid
runtime makes for its debug and analytics pipeline and for policies like [MessageLogging](https://docs.cloud.google.com/apigee/docs/api-platform/reference/policies/message-logging-policy.md.txt).

To use an HTTP forward proxy between hybrid and the TargetEndpoint, you must configure
the outbound proxy settings in your overrides file. These environment-scoped properties
route target requests from hybrid to the HTTP forward proxy. You also need to ensure
`use.proxy` is set to "true" for any TargetEndpoint that you want to go through an HTTP
forward proxy. See the bottom of the page for instructions.

To configure a hybrid environment for forwarding proxying, add
the [`envs.httpProxy` property](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/config-prop-ref.md.txt#envs) to your overrides file and apply it to the
cluster. For example:

```
envs:
  - name: test
    httpProxy:
      scheme: HTTP
      host: 10.12.0.47
      port: 3128
      ...
```

> [!NOTE]
> **NOTE:** The `scheme` must be HTTP and must be uppercase.

For details on each of the `envs.httpProxy` configuration properties refer to the
[Configuration property reference](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/config-prop-ref.md.txt#envs).

Forward proxying is configured for an environment; all traffic going from API
proxies in that environment to backend targets goes through the specified HTTP
forward proxy. If the traffic for a
specific target of an API proxy should go directly to the backend target, bypassing the forward
proxy, then set the following property in the TargetEndpoint to override the HTTP forward
proxy:

```
<Property name="use.proxy">false</Property>
```

For more information on setting the TargetEndpoint properties, including how to configure
the connection to the target endpoint, see [Endpoint properties reference](https://docs.cloud.google.com/apigee/docs/api-platform/reference/endpoint-properties-reference.md.txt).

Set `use.proxy` to "true" for any TargetEndpoint that you want to go through
an HTTP forward proxy:

```
<Property name="use.proxy">true</Property>
```

If you have a firewall on the backend which is configured to expect **Host Header** always to include the *backend* server host name, while the Message Processor is sending the *proxy server* hostname, perform the following to configure this option:

Set the property `use.proxy.host.header.with.target.uri `to true in the
TargetEndpoint as shown in the following example:

**Sample TargetEndpoint configuration:**

```text
  <TargetEndpoint name="default">
    <HTTPTargetConnection>
      <URL>https://mocktarget.apigee.net/json</URL>
      <Properties>
        <Property name="use.proxy.host.header.with.target.uri">true</Property>
      </Properties>
    </HTTPTargetConnection>
  </TargetEndpoint>
```

For details on the `use.proxy.host.header.with.target.uri` property, see [Endpoint properties reference](https://docs.cloud.google.com/apigee/docs/api-platform/reference/endpoint-properties-reference.md.txt).
**Important note on external calls:** Configuring non-API proxy forwarding using [`httpProxy`](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/config-prop-ref.md.txt#httpproxy) without also setting [`envs.httpProxy`](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/config-prop-ref.md.txt#envs) will not apply the proxy configuration to Apigee Runtime's external calls to services like Pub/Sub or other Google Cloud APIs.


If you only specify `httpProxy`, you must also ensure that `*.googleapis.com` is allowlisted for your Apigee Runtime pods to enable connectivity to these services.