Conexões
Conexão com Proxy

7min
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.
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":{}}'
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":{}}'
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.
Updated 05 Nov 2024
Did this page help you?
Conexões
Workspaces