SQLly em uma página: modo proxy do relay
funcionalExecute 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.
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
| Flag | O que faz |
|---|---|
--proxy-credentials | O 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-token | Um 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-bind | Onde 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-origins | Origens 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-sessions | Quantas 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-binary | Onde 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.
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.