Conexão com Proxy
6 min
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:
- Localize a opção Conexão com Proxy na tela de configuração da conexão:
- 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.
Configuração do Proxy
Após ativar o proxy, configure-o da seguinte maneira:
- 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.
- Verifique se o servidor proxy está operacional e que as credenciais de acesso (se necessárias) estão atualizadas.
- 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 --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 --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 relacionada ao uso de proxies em nossa plataforma.