Presto - Como configurar um proxy autenticado para uso com o Presto

Titulo: Como configurar um proxy autenticado para uso com o Presto

Alguns clientes da Oystr têm preferido configurar um proxy autenticado em vez de utilizar uma VPN. Essa abordagem permite que nossos robôs do Presto se conectem à infraestrutura do cliente de forma segura e eficiente.

Passo a Passo para Configuração do Proxy

1. Rodar o container com o proxy

O cliente deve rodar o seguinte comando em sua máquina, utilizando nosso container pré-configurado:

docker run --name proxy -v /opt/oystr:/opt/oystr/ -p 8888:8888 -d leandrocruz/oystr-tinyproxy:v1.0.0

Esse comando irá:

• Criar e rodar um container chamado proxy;
• Mapear a pasta local /opt/oystr para dentro do container;
• Expor a porta 8888 para acesso externo.
  

2. Criar o arquivo de configuração

Na pasta local /opt/oystr o cliente deve criar um arquivo chamado tinyproxy.cfg com o seguinte conteúdo:

Port 8888
Listen 0.0.0.0
Timeout 600
DisableViaHeader Yes
BasicAuth oystr-bot SENHA

O container roda um proxy http autenticado na porta 8888

Importante:

• SENHA deve ser substituída pela senha de autenticação que o cliente deverá criar e nos informar para ser usado pela nossa solução para autenticar os robôs na infraestrutura do cliente.
• A configuração define que o proxy ficará escutando na porta 8888 em todas as interfaces de rede (0.0.0.0).
  

3. Garantir o acesso externo
A porta 8888 precisa estar publicamente acessível na infraestrutura do cliente, para que os robôs do Presto consigam se conectar ao proxy.

4. Testar o funcionamento do proxy

Após a configuração, o cliente deve executar o seguinte comando para verificar se o proxy está funcionando corretamente:

curl --proxy http://oystr-bot:SENHA@IP:8888 http://ipinfo.io

Substitua:

• SENHA pela senha de autenticação fornecida;
• IP pelo endereço IP público ou interno da máquina onde o proxy foi configurado (ou do gateway).
  

Se o comando retornar um JSON com as informações do IP da infraestrutura do cliente, significa que o proxy está configurado corretamente.

✅ Exemplo de retorno esperado:

{
"city": "São Paulo",
"country": "BR",
"hostname": "customer.splobra1.pop.starlinkisp.net",
"ip": "216.234.208.75",
"loc": "-23.5475,-46.6361",
"org": "AS14593 Space Exploration Technologies Corporation",
"postal": "01000-000",
"readme": "https://ipinfo.io/missingauth",
"region": "São Paulo",
"timezone": "America/Sao_Paulo"
}

⚠️ Importante
Enquanto esse teste não for bem-sucedido, os robôs do Presto não conseguirão utilizar o proxy do cliente.
Suporte
Em caso de dúvidas ou dificuldades durante a configuração, entre em contato com nosso time de suporte técnico.

27 de mai. de 2025 

------------------------------------------------------------------------------------------------------------------------------------------------