SQLly auf einen Blick: Relay-Proxy-Modus

funktional

Führe den Browser-Build über ein eigenes Relay gegen deine eigenen Datenbanken aus - das Relay hält die Zugangsdaten, die Seite sieht also nie ein Passwort.

das Browser-Build von SQLly läuft normalerweise gegen Beispieldaten in deinem Tab, da eine Webseite keinen Datenbank-Socket öffnen kann. Relay-Proxy-Modus gibt ihm echte Server: ein sqlly-relay du ausführst, bekommt ein Zugangsdaten-Datei, und der Browser-Build fragt, mit der Adresse dieses Relays geöffnet, jeden Server und jede Datenbank in der Datei ab - Objekt-Explorer, IntelliSense, Ausführungspläne und Zeilenbearbeitung inklusive -, während die Passwörter nie den Relay-Host verlassen.

Für wen das gedacht ist. Ein Team, das SQLly ohne Installation auf einer Seite, einem internen Portal, einer Support-Konsole oder in einem Klassenzimmer nutzen will, gegen einen festen Satz von Datenbanken, den ein Admin kontrolliert. Es ist nicht der Desktop-App Über Relay Pfad: dieser ist Ende-zu-Ende-verschlüsselt, sodass das Relay deinen Traffic nicht lesen kann. Hier hält absichtlich das Relay die Anmeldeinformationen, sodass ein Browser-Tab sie nie haben muss.

Wie es zusammenpasst

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
  • Das Relay stellt eine Zugangsdaten-Datei bereit. Jede darin enthaltene Verbindung – Server, Datenbank, Login und Passwort, gemeinsam genutzte Logins, SSH-Tunnel und Proxys sowie die Client-, Projekt- und Umgebungsbezeichnungen – ist für den Browser erreichbar. Nichts anderes.
  • Eine Engine pro Sitzung. Jede Browsersitzung bekommt ihre eigene SQLly-Engine auf dem Relay-Host, gestartet in einem stark eingeschränkten Modus, der nur Verbindungen aus der Datei öffnet. Eine Anfrage, die ihren eigenen Server angibt oder ein eigenes Passwort mitbringt, wird abgelehnt.
  • Der Browser bekommt Namen, keine Secrets. Er erhält die Verbindungsliste mit entfernten Passwörtern, Tunnel-Einstellungen und Tokens und speichert die Liste niemals; das Relay sendet sie bei jedem Seitenaufruf frisch.
  • Die andere Aufgabe des Relays bleibt unberührt. Der Proxy ist ein separater Listener, den man extra einschalten muss. Ein Relay, das ihn nicht aktiviert, leitet Via-Relay-Datenverkehr genau wie bisher weiter.

Richten Sie das Relay ein

Auf einem Host, der die Datenbanken erreichen kann und sqlly-cli neben installiert sqlly-relay, erstelle eine Anmeldedatei (exportiere eine aus der Desktop-App mit Datei → Verbindungen mit Zugangsdaten exportieren…, oder schreib es von Hand) und starte das Relay mit den Proxy-Flags, die zu seiner üblichen Konfiguration dazukommen:

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
FlagWas es bewirkt
--proxy-credentialsDie Zugangsdaten-Datei. Ihr Setzen schaltet den Proxy ein. Die Datei wird bei jeder neuen Browsersitzung neu gelesen, sodass Änderungen ohne Neustart greifen.
--proxy-tokenEin gemeinsam genutztes Geheimnis, das der Browser vorlegen muss. Erforderlich: Ohne es wird der Start verweigert, außer du übergibst --proxy-insecure-no-token, der jede gelistete Datenbank jedem bereitstellt, der den Port erreichen kann.
--proxy-bindWo der Proxy lauscht; standardmäßig Port 8444. Er verwendet das TLS-Zertifikat des Relays für wss://; --proxy-plain bereitstellt ws:// für lokale Tests oder hinter einem TLS-terminierenden Reverse-Proxy.
--proxy-allowed-originsKommagetrennte Web-Ursprünge, die eine Sitzung öffnen dürfen, sodass nur Seiten, die du hostest, den Proxy nutzen können. Weglassen, um jeden Ursprung zu erlauben (das Token gilt weiterhin).
--proxy-max-sessionsWie viele Browsersitzungen gleichzeitig geöffnet sein dürfen (jede ist ein Engine-Prozess); der Standardwert ist 32. Ein voller Proxy fordert neue Sitzungen auf, es später erneut zu versuchen.
--proxy-engine-binaryWo sqlly-cli ist, wenn es nicht neben sqlly-relay oder auf dem PATH.

Jedes Flag hat eine Form als Umgebungsvariable (RELAY_PROXY_CREDENTIALS, RELAY_PROXY_TOKENusw.) für Container-Bereitstellungen. Das Relay-Container-Image enthält die Engine, wenn es mit --build-arg WITH_PROXY_ENGINE=1.

Zwei Regeln unterscheiden sich von einem Desktop-Import: gemeinsame Logins und Tunnel-Profile müssen in derselben Datei definiert werden (das Relay hat keine gespeicherten Verbindungen, auf die zurückgegriffen werden kann), und eine via-relay Route auf einer Verbindung wird ignoriert, weil der Relay-Host die Verbindung zu jedem Server selbst aufbaut.

Den Browser-Build damit öffnen

Füge die Proxy-Adresse und das Token zur URL des Browser-Builds hinzu:

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

Eine Seite, die den Build einbettet, kann festlegen SQLLY_PROXY_URL und SQLLY_PROXY_TOKEN als globale Variablen, bevor die App startet, anstatt sie in die Adressleiste zu setzen. Beim Laden verbindet sich die App, die Statuszeile nennt das Relay und wie viele Verbindungen es bedient, und diese Verbindungen erscheinen gebrauchsfertig im Explorer. Die Beispieldatenbanken werden in diesem Modus gar nicht heruntergeladen.

Die Seite selbst hosten. Browser lassen einer Seite nur Sockets zu Origins öffnen, die ihre Sicherheitsrichtlinie erlaubt. Der Build auf sqlly.app erlaubt seinen eigenen Origin; ein Proxy auf einem anderen Host braucht eine erweiterte Richtlinie, oder du lieferst den Build von der eigenen Domain des Relays aus. Wenn die Seite lädt, aber meldet, dass sie den Relay-Proxy nicht erreicht, ist genau das das Erste, was du prüfen solltest.

Was sich in der App ändert

  • Verbindungen sind schreibgeschützt. Die Liste gehört zum Relay. Server hinzufügen, Duplizieren, Löschen und Verbindungen importieren sind deaktiviert; die Schaltflächen des Verbindungsmanagers zum Hinzufügen, Entfernen und Duplizieren und seine Client-, Projekt- und Umgebungs-Editoren sind gesperrt; und das Öffnen einer Verbindung zeigt sie als Verbindung anzeigen mit deaktiviertem Speichern und einem Hinweis, dass das Relay die Zugangsdaten vorhält. Ändere die Anmeldedatei auf dem Relay, um zu ändern, was die Benutzer sehen.
  • „Verbindung testen“ funktioniert weiterhin - sie läuft durch den Proxy wie jede Abfrage, ebenso wie alle Abfragefunktionen, der Objektexplorer, die IntelliSense-Katalogsynchronisierung, Ausführungspläne, Skripterstellung und Zeilenbearbeitung.
  • Beschriftungen werden mit übernommen. Kunden-, Projekt- und Umgebungsnamen, Farben und Sicherheitsschalter aus der Datei gruppieren den Explorer genauso wie auf dem Desktop; auf Symbole wird verzichtet, um die Seite schlank zu halten.
  • Wenn das Relay weg ist - sagt die Statuszeile, und Abfragen über Proxy-Verbindungen scheitern mit einer klaren Meldung, bis die Seite neu geladen wird.