Skip to main content
SQLOZ
Funcionalidades Documentação Preços Roteiro Blog A nossa história Disponível na Mac App Store
Chapter 2 Core & Getting Started

Capítulo 2: Conexões e Túneis

Info: Este capítulo aborda o estabelecimento de conexões diretas, a configuração de túneis SSH Jump Host e HTTP PHP, identificadores visuais de ambiente e o armazenamento seguro de credenciais no Keychain.

Neste capítulo:

2.1 Estabelecendo uma Conexão Direta

Para conectar a instâncias de banco de dados locais ou na nuvem:

  1. Pressione Cmd + N ou acesse Arquivo → Nova Conexão….
  2. Na aba Geral, insira o nome da conexão, escolha o motor (MySQL, PostgreSQL, SQLite), informe host, porta e credenciais.
  3. Valide os dados com Testar Conexão e finalize em Salvar e Conectar.

2.2 Perfis de Conexão e Ambientes Seguros

Os perfis salvos guardam configurações não sensíveis. Todas as senhas e chaves são gravadas diretamente no Keychain (Acesso às Chaves) do macOS com criptografia do sistema.

  • Ative o modo Somente Leitura (Read-Only) no perfil antes de auditar bancos em produção.
  • Aplique cores aos ambientes para diferenciar visualmente suas abas de trabalho.

2.3 Túnel SSH Jump Host

Em infraestruturas corporativas, servidores de banco de dados não possuem IP público e exigem um servidor intermediário (Jump Host / Bastion).

  1. Na janela de conexão, vá até a aba Túnel SSH.
  2. Marque Ativar Túnel SSH, informe host SSH, porta (22) e usuário.
  3. Escolha o método de autenticação: Chave Privada (id_ed25519, id_rsa) ou senha.
  4. Conclua a verificação em Testar Conexão.

2.4 Túnel HTTP PHP (sqloz-tunnel.php)

Para hospedagens compartilhadas (cPanel/DirectAdmin) que bloqueiam a porta 3306 e não disponibilizam acesso SSH:

  1. Suba o script sqloz-tunnel.php para o diretório raiz web (public_html/).
  2. Altere o $TOKEN = "sua_senha_secreta"; no script para uma chave forte.
  3. Na aba Túnel HTTP no SQLOZ, configure o endpoint (https://seudominio.com/sqloz-tunnel.php) e o token correspondente.
  4. O tráfego do banco passa criptografado via HTTPS em formato binário encapsulado; a senha do banco nunca é gravada no arquivo PHP.

2.5 Etiquetas de Cores por Ambiente

Evite comandos destrutivos no ambiente errado usando sinalização por cores:

  • Prod (Vermelho - #E8334A): Servidores de produção ativos.
  • Staging (Laranja - #FF9500): Homologação e pré-lançamento.
  • Dev (Verde - #34C759): Ambiente de desenvolvimento local.
  • Test (Azul) e Sandbox (Roxo): Testes isolados e laboratórios.

2.6 Armazenamento Seguro de Credenciais

O SQLOZ não grava senhas em arquivos de texto plano ou logs locais. As credenciais confidenciais são enviadas com segurança ao cofre criptografado do Keychain do macOS.

Configuração de conexão direta

Configuração de túnel SSH

Tópicos relacionados