--- title: Conexão com Proxy slug: conexao-com-proxy docTags: createdAt: 2023-12-18T13:49:38.850Z --- ## Introdução Em ambientes de rede complexos ou por razões de segurança, pode ser necessário rotear as solicitações de integração através de um servidor proxy. A configuração de uma conexão com proxy permite que você gerencie o tráfego entre o seu sistema e a internet ou entre diferentes serviços internos. ## Ativação do Proxy Para habilitar o uso de um proxy na sua conexão: 1. Localize a opção **Conexão com Proxy** na tela de configuração da conexão: 2. Ative o toggle para **Conexão com Proxy**. - **Tooltip**: Ative esta opção se desejar configurar uma conexão com proxy para esta conexão. A conexão com proxy pode ser útil para rotear o tráfego da sua integração através de um servidor proxy para fins de segurança ou para contornar restrições de rede. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/mUD3xsoY00_pLkITI-iUU_image.png" size="80" width="663" height="314" position="center" darkWidth="663" darkHeight="314" showCaption="false"} ## Configuração do Proxy Após ativar o proxy, configure-o da seguinte maneira: 1. No campo **URL**, insira a URL do servidor proxy. - **Tooltip**: Insira a URL do servidor proxy que você deseja usar para esta conexão. Certifique-se de que a URL esteja correta e seja acessível para garantir uma conexão bem-sucedida através do proxy. 2. Verifique se o servidor proxy está operacional e que as credenciais de acesso (se necessárias) estão atualizadas. 3. Teste a conexão para assegurar que as solicitações possam passar pelo proxy sem erros. ## Considerações Importantes - Lembre-se de que a utilização de um proxy pode afetar a latência das solicitações, dependendo da localização e da carga do servidor proxy. - A segurança de sua conexão proxy é tão robusta quanto as políticas de segurança aplicadas ao servidor proxy. Garanta que as configurações de segurança estejam em conformidade com os padrões da sua organização. - Em ambientes de produção, evite usar proxies que não foram aprovados ou configurados pela sua equipe de segurança de rede. - Após a configuração do proxy, um cabeçalho padrão da Fluid — **X-Fluid-Flow** — será automaticamente adicionado às requisições, contendo o nome do fluxo em execução. Esse cabeçalho tem como finalidade facilitar a rastreabilidade e o monitoramento dos fluxos. ## Criando conexão com proxy via API ```curl curl --location 'https://4w28c612e7.execute-api.us-east-1.amazonaws.com/staging/graphql?key=4eb1b60d-b4f2-458f-b59e-b2f81f9fc921' \ --header 'Accept-Encoding: gzip, deflate, br' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Connection: keep-alive' \ --header 'x-tenant-id: ${tenant_id}' \ --data '{"query":"mutation Create{\n createConnection(\n config: \"{\\\"client_id\\\":\\\"nonono\\\",\\\"client_secret\\\":\\\"nonono\\\",\\\"url\\\":\\\"nonono\\\"}\"\n connector: {\n id : \"${connector_id}\"\n }\n proxy: {\n is_proxy: true,\n is_proxy_credentials: true,\n proxy_url: \"localhost:8080\",\n proxy_url_credentials: \"localhost:8080/credentials\"\n }\n name: \"nome da conexao\"\n description: \"string\"\n ) {\n config\n connector {\n icon_url\n id\n name\n slug\n }\n description\n id\n name\n proxy {\n is_proxy\n is_proxy_credentials\n proxy_url\n proxy_url_credentials\n headers\n }\n status\n }\n}\n\n# query Find{\n# Connection(\n# id: \"${connection_id}\"\n# ) {\n# config\n# connector {\n# icon_url\n# id\n# name\n# slug\n# }\n# description\n# id\n# name\n# proxy {\n# is_proxy\n# is_proxy_credentials\n# proxy_url\n# proxy_url_credentials\n# headers\n# }\n# status\n# }\n# }\n\n# query All{\n# allConnections(\n# filter: {\n# name: \"teste-29/10\"\n# }\n# ) {\n# config\n# connector {\n# icon_url\n# id\n# name\n# slug\n# }\n# description\n# id\n# name\n# proxy {\n# is_proxy\n# is_proxy_credentials\n# proxy_url\n# proxy_url_credentials\n# headers\n# }\n# status\n# }\n# }","variables":{}}' ``` ### Setando headers no proxy via API Caso seja necessário setar algum header na configuração de proxy, essa é a forma via API: ```curl curl --location '${host}/graphql?key=${api_key}' \ --header 'Accept-Encoding: gzip, deflate, br' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Connection: keep-alive' \ --header 'x-tenant-id: ${tenant_id}' \ --data '{"query":"mutation Create{\n createConnection(\n config: \"{\\\"client_id\\\":\\\"nonono\\\",\\\"client_secret\\\":\\\"nonono\\\",\\\"url\\\":\\\"nonono\\\"}\"\n connector: {\n id : \"${connector_id}\"\n }\n proxy: {\n headers: {\n header-1: \"valor_header_1\",\n header-2: \"valor_header_2\"\n }\n }\n name: \"teste-header\"\n description: \"string\"\n ) {\n config\n connector {\n icon_url\n id\n name\n slug\n }\n description\n id\n name\n proxy {\n is_proxy\n is_proxy_credentials\n proxy_url\n proxy_url_credentials\n headers\n }\n status\n }\n}\n\n# query Find{\n# Connection(\n# id: \"${connection_id}\"\n# ) {\n# config\n# connector {\n# icon_url\n# id\n# name\n# slug\n# }\n# description\n# id\n# name\n# proxy {\n# is_proxy\n# is_proxy_credentials\n# proxy_url\n# proxy_url_credentials\n# headers\n# }\n# status\n# }\n# }\n\n# query All{\n# allConnections(\n# filter: {\n# name: \"teste-29/10\"\n# }\n# ) {\n# config\n# connector {\n# icon_url\n# id\n# name\n# slug\n# }\n# description\n# id\n# name\n# proxy {\n# is_proxy\n# is_proxy_credentials\n# proxy_url\n# proxy_url_credentials\n# headers\n# }\n# status\n# }\n# }","variables":{}}' ``` ## Suporte e Ajuda Para assistência adicional ou esclarecimento sobre a configuração de conexão com proxy, entre em contato com o suporte técnico ou consulte a seção de Perguntas Frequentes [FAQ - Perguntas frequentes](docId\:QywCSbSRcT6Tak5QXIvP6) relacionada ao uso de proxies em nossa plataforma.