Pular para o conteúdo principal

Configuração da VPN Corporativa

A VPN é obrigatória para acessar todos os recursos de desenvolvimento (Git e PostgreSQL).

📋 Pré-requisitos​

  • Usuário criado no servidor VPN
  • Código 2FA configurado (Google Authenticator)
  • Cliente VPN instalado

🔧 Instalação do Cliente VPN​

Ubuntu/Linux​

Opção 1: OpenVPN Nativo (Recomendado)​

sudo apt update
sudo apt install -y openvpn

Opção 2: Pritunl Client​

# Ubuntu 24.04
sudo tee /etc/apt/sources.list.d/pritunl.list >/dev/null <<'EOF'
deb [signed-by=/usr/share/keyrings/pritunl.gpg] https://repo.pritunl.com/stable/apt noble main
EOF

curl -fsSL https://raw.githubusercontent.com/pritunl/pgp/master/pritunl_repo_pub.asc \
  | sudo gpg --dearmor --yes -o /usr/share/keyrings/pritunl.gpg

sudo apt update
sudo apt install -y pritunl-client-electron

Windows​

  1. Baixar OpenVPN Connect: https://openvpn.net/client/
  2. Instalar e importar arquivo .ovpn

macOS​

  1. Baixar OpenVPN Connect na App Store
  2. Importar arquivo .ovpn

📱 Obter Perfil VPN​

No Painel Administrativo​

  1. Acessar: https://engenharia-vpn.bitio.com.br
  2. Login: pritunl / senha_obtida_com_admin
  3. Users → Engenharia-Bitio → Seu usuário
  4. Get Profile → URI Link ou Download .ovpn

Via Administrador​

Solicite ao administrador de sistema:

  • Arquivo .ovpn do seu perfil
  • Ou URI Link para importação

🚀 Conectando​

OpenVPN Nativo (Linux/Terminal)​

# Conectar usando arquivo .ovpn
sudo openvpn --config seu-arquivo.ovpn

# Quando solicitado:
# Username: seu_usuario
# Password: sua_senha + codigo_2FA (junto, sem espaço)
# Exemplo: minhasenha123456

Pritunl Client / OpenVPN Connect (GUI)​

  1. Import Profile URI ou Import File
  2. Username: seu_usuario
  3. Password: sua_senha + codigo_2FA (junto)
  4. Connect

✅ Verificar Conexão​

Status da VPN​

# Verificar interface VPN
ip addr show tun0

# Deve mostrar algo como:
# inet 10.250.0.X/24 scope global tun0

Teste de Conectividade​

# Testar acesso aos recursos internos
ping 172.31.11.156  # Servidor Pritunl interno
ping 10.0.11.230    # PostgreSQL

# Testar Git (deve funcionar apenas com VPN)
curl -I https://engenharia-git.bitio.com.br/

⚙️ Configuração Obrigatória: /etc/hosts​

IMPORTANTE: Para acessar o Git via VPN, configure o arquivo hosts:

Linux/Ubuntu/macOS​

echo "172.31.11.156 engenharia-git.bitio.com.br" | sudo tee -a /etc/hosts

Windows (Executar como Administrador)​

echo 172.31.11.156 engenharia-git.bitio.com.br >> C:\Windows\System32\drivers\etc\hosts

Por que é necessário?​

  • O Git resolve para IP privado (172.31.11.156) apenas via VPN
  • Sem esta configuração, o navegador tenta acessar o IP público
  • Com VPN + hosts configurado: Git funciona ✅
  • Sem VPN: Git inacessível (erro de conexão) ✅

🔍 Solução de Problemas​

VPN não conecta​

# Verificar logs OpenVPN
sudo openvpn --config arquivo.ovpn --verb 4

# Verificar portas abertas no firewall
sudo ufw status

Git inacessível mesmo com VPN​

# Verificar se hosts está configurado
grep "engenharia-git.bitio.com.br" /etc/hosts

# Testar resolução DNS
nslookup engenharia-git.bitio.com.br
# Deve retornar: 172.31.11.156

PostgreSQL inacessível​

# Testar conectividade
telnet bitio-staging-database.c03q40ewsobq.us-east-1.rds.amazonaws.com 5432

# Verificar rota VPN
ip route show | grep "10.0"
# Deve mostrar: 10.0.0.0/16 via 10.250.0.1 dev tun0
Segurança

Mantenha sempre a VPN conectada durante o desenvolvimento. Desconectar a VPN torna os recursos inacessíveis imediatamente.