SQLly em uma página: modo proxy do relay

funcional

Execute a versão para navegador contra seus próprios bancos de dados através de um relay que você controla - ele guarda as credenciais, então a página nunca vê uma senha.

O versão para navegador do SQLly normalmente é executado contra dados de exemplo na sua aba, porque uma página web não pode abrir um socket de banco de dados. Modo proxy de relay fornece servidores reais: um sqlly-relay que você executa é entregue a um arquivo de credenciais, e a versão para navegador, aberta no endereço daquele relay, consulta todos os servidores e bancos de dados do arquivo — explorador de objetos, IntelliSense, planos de execução e edição de linhas incluídos — enquanto as senhas nunca saem do host do relay.

Para quem é isso. Uma equipe que quer um SQLly sem instalação em uma página, um portal interno, um console de suporte, uma sala de aula, contra um conjunto fixo de bancos de dados que um administrador controla. É não do aplicativo desktop Via retransmissão caminho: aquele é criptografado de ponta a ponta para que o relay não possa ler seu tráfego. Aqui, o relay é deliberadamente quem detém as credenciais, para que uma aba do navegador nunca precise.

Como tudo se encaixa

browser (SQLly on a page)  --wss-->  sqlly-relay proxy  --local-->  SQLly engine  --TDS / PG / MySQL / ...-->  your databases
                                     holds the credential file        one per browser session
  • O relay serve um arquivo de credenciais. Cada conexão nele, servidor, banco de dados, login e senha, logins compartilhados, túneis SSH e proxies, e os rótulos de cliente, projeto e ambiente - é o que o navegador pode alcançar. Nada mais.
  • Um mecanismo por sessão. Cada sessão do navegador recebe seu próprio mecanismo SQLly no host do relay, iniciado em modo restrito que só abre conexões a partir do arquivo. Uma requisição que indica seu próprio servidor ou traz sua própria senha é recusada.
  • O navegador recebe nomes, não segredos. Ele recebe a lista de conexões com senhas, configurações de túnel e tokens removidos, e nunca a armazena; o relay a envia de novo a cada carregamento de página.
  • A outra função do relay permanece inalterada. O proxy é um ouvinte separado e opcional. Um relay que não o habilita encaminha o tráfego Via Relay exatamente como antes.

Configure o relay

Em um host que possa acessar os bancos de dados e tenha sqlly-cli instalado ao lado de sqlly-relay, escreva um arquivo de credenciais (exporte um do aplicativo de desktop com Arquivo → Exportar conexão com credenciais…, ou escreva-o à mão) e inicie o relay com as flags de proxy adicionadas à configuração usual dele:

sqlly-relay \
  --tls-cert /certs/relay.crt --tls-key /certs/relay.key \
  --proxy-credentials /etc/sqlly/browser-connections.json \
  --proxy-token 'a-long-random-secret' \
  --proxy-bind 0.0.0.0:8444 \
  --proxy-allowed-origins https://sqlly.app
FlagO que faz
--proxy-credentialsO arquivo de credenciais. Defini-lo é o que ativa o proxy. O arquivo é relido a cada nova sessão do navegador, então as edições entram em vigor sem precisar de reinício.
--proxy-tokenUm segredo compartilhado que o navegador deve apresentar. Obrigatório: sem ele, o relay se recusa a iniciar, a menos que você passe --proxy-insecure-no-token, que serve todos os bancos de dados listados para qualquer pessoa que consiga acessar a porta.
--proxy-bindOnde o proxy escuta; o padrão é a porta 8444. Ele usa o certificado TLS do relay para wss://; --proxy-plain serve ws:// para testes locais ou atrás de um proxy reverso que termine TLS.
--proxy-allowed-originsOrigens da web separadas por vírgula autorizadas a abrir uma sessão, para que apenas páginas hospedadas por você possam usar o proxy. Omita o campo para permitir qualquer origem (o token continua valendo).
--proxy-max-sessionsQuantas sessões de navegador podem ficar abertas ao mesmo tempo (cada uma é um processo do mecanismo); o padrão é 32. Um proxy cheio pede que as novas sessões tentem novamente mais tarde.
--proxy-engine-binaryOnde sqlly-cli é, se não estiver ao lado sqlly-relay ou no PATH.

Cada flag tem uma forma de variável de ambiente (RELAY_PROXY_CREDENTIALS, RELAY_PROXY_TOKEN, e assim por diante) para implantações em contêiner. A imagem de contêiner do relay inclui o mecanismo quando compilada com --build-arg WITH_PROXY_ENGINE=1.

Duas regras diferem de uma importação de desktop: logins compartilhados e perfis de túnel devem ser definidos no mesmo arquivo (o relay não tem conexões salvas para recorrer), e uma via-relay rota em uma conexão é ignorada, porque o host do relay conecta diretamente a cada servidor.

Abra a versão para navegador apontada para ele

Adicione o endereço do proxy e o token à URL do build do navegador:

https://sqlly.app/app/?proxy=wss://relay.example.com:8444/proxy&token=a-long-random-secret

Uma página que incorpora o build pode definir SQLLY_PROXY_URL e SQLLY_PROXY_TOKEN as variáveis globais antes de o aplicativo iniciar, em vez de colocá-las na barra de endereços. Ao carregar, o aplicativo se conecta, a linha de status informa o relay e quantas conexões ele atende, e essas conexões aparecem no explorador prontas para uso. Os bancos de dados de exemplo nem são baixados nesse modo.

Hospedando a página você mesmo. Os navegadores só permitem que uma página abra sockets para origens que sua política de segurança permite. O build servido em sqlly.app permite sua própria origem; um proxy em outro host precisa que essa política seja ampliada, ou sirva o build a partir do próprio domínio do relay. Se a página carrega mas reporta que não pôde alcançar o proxy do relay, esta é a primeira coisa a verificar.

O que muda no aplicativo

  • As conexões são somente leitura. A lista é a do relay. Adicionar servidor, Duplicar, Excluir e Importar conexões ficam desativados; os botões de adicionar, remover e duplicar do gerenciador de conexões, além dos editores de cliente, projeto e ambiente, ficam bloqueados; e abrir uma conexão a mostra como Ver conexão com Salvar desativado e uma nota de que o relay mantém suas credenciais. Altere o arquivo de credenciais no relay para mudar o que os usuários veem.
  • O teste de conexão continua funcionando - ele passa pelo proxy como qualquer consulta, e o mesmo vale para todos os recursos de consulta, o explorador de objetos, a sincronização do catálogo do IntelliSense, os planos de execução, scripts e edição de linhas.
  • Os rótulos vêm junto. Nomes, cores e opções de segurança de clientes, projetos e ambientes do arquivo organizam o explorador da mesma forma que no desktop; os ícones ficam de fora para deixar a página leve.
  • Se o relay sair do ar - a linha de status avisa, e as consultas em conexões via proxy falham com uma mensagem clara até a página ser recarregada.