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\u003eThis documentation covers version 1.7 of Apigee hybrid, which is end-of-life, and users should upgrade to a newer version.\u003c/p\u003e\n"],["\u003cp\u003eApigee hybrid can be configured to use a forward proxy, which acts as an intermediary between API proxies and external target servers for enforcing security and logging requests.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring an HTTP forward proxy in Apigee hybrid requires setting the \u003ccode\u003eenvs.httpProxy\u003c/code\u003e property in the overrides file with the scheme, host, and port.\u003c/p\u003e\n"],["\u003cp\u003eBy default, all traffic from API proxies within a configured environment will go through the forward proxy, but this can be overridden on a per-target basis by setting the \u003ccode\u003euse.proxy\u003c/code\u003e property to "false" in the TargetEndpoint.\u003c/p\u003e\n"],["\u003cp\u003eSetting \u003ccode\u003euse.proxy\u003c/code\u003e to "true" in a TargetEndpoint ensures that traffic to that target will go through the configured HTTP forward proxy.\u003c/p\u003e\n"]]],[],null,["# Configure forward proxying for API proxies\n\n| You are currently viewing version 1.7 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. 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\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.7/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` can be HTTP or HTTPS 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.7/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```"]]
