Os proxies de encaminhamento fornecem um único ponto em que várias máquinas enviam solicitações para um
servidor externo. Eles podem aplicar políticas de segurança, registrar e analisar solicitações, e executar outras
ações para que as solicitações sigam as regras comerciais. Com a Apigee híbrida, é possível configurar um proxy de encaminhamento
que intermedia os proxies de API e um TargetEndpoint externo (um servidor de destino de back-end).
Para usar um proxy de encaminhamento HTTP entre híbrido e o TargetEndpoint, é preciso definir
as configurações de proxy de saída no arquivo de modificação. Essas propriedades com escopo do ambiente
roteiam as solicitações de destino do híbrido para o proxy de encaminhamento HTTP. Você também precisa garantir
que use.proxy esteja definido como "true" para qualquer TargetEndpoint que queira passar por um proxy de
encaminhamento HTTP. Veja instruções na parte inferior da página.
Para configurar um ambiente híbrido para usar encaminhamento por proxy, adicione
a propriedade envs.httpProxy (em inglês) ao arquivo de modificação e aplique-a ao
cluster. Exemplo:
O encaminhamento por proxy está configurado em um ambiente. Todo o tráfego que flui dos proxies de
API nesse ambiente para os destinos de back-end passa pelo proxy de encaminhamento
HTTP especificado. Se o tráfego para um
destino específico de um proxy de API precisa ir diretamente para o destino do back-end, ignorando o proxy de
encaminhamento, defina a seguinte propriedade no TargetEndpoint para modificar o proxy de encaminhamento
HTTP:
<Property name="use.proxy">false</Property>
Para mais informações sobre como configurar as propriedades do TargetEndpoint, incluindo como configurar
a conexão com o endpoint de destino, consulte Referência de propriedades do endpoint.
Defina use.proxy como "true" para qualquer TargetEndpoint que você queira passar
por um proxy de encaminhamento HTTP:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[[["\u003cp\u003eForward proxies allow multiple machines to send requests through a single point, enforcing security and logging policies.\u003c/p\u003e\n"],["\u003cp\u003eApigee hybrid allows configuring a forward proxy that intermediates API proxies and external TargetEndpoints, routing target requests from hybrid.\u003c/p\u003e\n"],["\u003cp\u003eTo use an HTTP forward proxy in Apigee hybrid, configure the \u003ccode\u003eenvs.httpProxy\u003c/code\u003e property in your overrides file, ensuring the \u003ccode\u003escheme\u003c/code\u003e is set to HTTP in uppercase.\u003c/p\u003e\n"],["\u003cp\u003eBy default, all traffic from API proxies to backend targets in a configured environment goes through the forward proxy, but you can bypass this by setting the \u003ccode\u003euse.proxy\u003c/code\u003e property to "false" in the TargetEndpoint.\u003c/p\u003e\n"],["\u003cp\u003eTo force a specific TargetEndpoint through the proxy, ensure that \u003ccode\u003euse.proxy\u003c/code\u003e is set to "true".\u003c/p\u003e\n"]]],[],null,["# Configure forward proxying for API proxies\n\n| You are currently viewing version 1.13 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nForward proxies provide a single point through which multiple machines send requests to an\nexternal server. They can enforce security policies, log and analyze requests, and perform other\nactions so that requests adhere to your business rules. With Apigee hybrid, you can configure a forward proxy\nthat intermediates your API proxies and an external TargetEndpoint (a backend target server).\n| **Important:** Apigee also supports a [forward proxy functionality for non-hybrid\n| installations](/apigee/docs/api-platform/fundamentals/environments-overview#forward-proxy). Use the instructions provided on this page to configure forward proxies for hybrid rather than the general Apigee functionality.\n\nTo use an HTTP forward proxy between hybrid and the TargetEndpoint, you must configure\nthe outbound proxy settings in your overrides file. These environment-scoped properties\nroute target requests from hybrid to the HTTP forward proxy. You also need to ensure\n`use.proxy` is set to \"true\" for any TargetEndpoint that you want to go through an HTTP\nforward proxy. See the bottom of the page for instructions.\n\nTo configure a hybrid environment for forwarding proxying, add\nthe [`envs.httpProxy` property](/apigee/docs/hybrid/v1.13/config-prop-ref#envs) to your overrides file and apply it to the\ncluster. For example: \n\n```text\nenvs:\n - name: test\n httpProxy:\n scheme: HTTP\n host: 10.12.0.47\n port: 3128\n ...\n```\n| **NOTE:** The `scheme` must be HTTP and must be uppercase.\n\nFor details on each of the `envs.httpProxy` configuration properties refer to the\n[Configuration property reference](/apigee/docs/hybrid/v1.13/config-prop-ref#envs).\n\nForward proxying is configured for an environment; all traffic going from API\nproxies in that environment to backend targets goes through the specified HTTP\nforward proxy. If the traffic for a\nspecific target of an API proxy should go directly to the backend target, bypassing the forward\nproxy, then set the following property in the TargetEndpoint to override the HTTP forward\nproxy: \n\n```text\n\u003cProperty name=\"use.proxy\"\u003efalse\u003c/Property\u003e\n```\n\nFor more information on setting the TargetEndpoint properties, including how to configure\nthe connection to the target endpoint, see [Endpoint properties reference](/apigee/docs/api-platform/reference/endpoint-properties-reference).\n\nSet `use.proxy` to \"true\" for any TargetEndpoint that you want to go through\nan HTTP forward proxy: \n\n```text\n\u003cProperty name=\"use.proxy\"\u003etrue\u003c/Property\u003e\n```"]]