SQLly en une page : mode proxy relais

fonctionnel

Exécutez la version navigateur sur vos propres bases de données via un relais que vous contrôlez - c'est lui qui détient les identifiants, donc la page ne voit jamais de mot de passe.

Le version navigateur du SQLly fonctionne normalement avec des données d'exemple dans votre onglet, car une page web ne peut pas ouvrir une socket de base de données. Mode proxy relais lui donne de vrais serveurs : un sqlly-relay vous exécutez est remis à un fichier d'identifiants, et la version navigateur, ouverte avec l'adresse de ce relais, qui interroge alors chaque serveur et base de données du fichier, explorateur d'objets, IntelliSense, plans d'exécution et édition de lignes inclus, tandis que les mots de passe ne quittent jamais l'hôte du relais.

À qui cela s'adresse. Une équipe qui veut un SQLly sans installation sur une page, un portail interne, une console de support, une salle de classe, sur un ensemble fixe de bases de données contrôlé par un administrateur. Il est pas le parcours de l'application de bureau Via le relais chemin : celui-ci est chiffré de bout en bout, donc le relais ne peut pas lire votre trafic. Ici, le relais détient délibérément les identifiants, de sorte qu'un onglet de navigateur n'a jamais à le faire.

Comment tout s'assemble

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
  • Le relais sert un fichier d'identifiants. Chaque connexion qu'il contient - serveur, base de données, login et mot de passe, logins partagés, tunnels SSH et proxys, et les étiquettes client, projet et environnement - est ce à quoi le navigateur peut accéder. Rien d'autre.
  • Un moteur par session. Chaque session de navigateur obtient son propre moteur SQLly sur l'hôte relais, démarré dans un mode verrouillé qui n'ouvre que les connexions du fichier. Toute requête qui nomme son propre serveur ou transporte son propre mot de passe est refusée.
  • Le navigateur obtient des noms, pas des secrets. Il reçoit la liste des connexions dont les mots de passe, paramètres de tunnel et jetons ont été supprimés, et il ne stocke jamais la liste ; le relais l'envoie à nouveau à chaque chargement de page.
  • L'autre tâche du relais reste inchangée. Le proxy est un écouteur distinct, désactivé par défaut. Un relais qui ne l'active pas transmet le trafic Via Relay exactement comme avant.

Configurer le relais

Sur un hôte qui peut atteindre les bases de données et possède sqlly-cli installé à côté de sqlly-relay, écrivez un fichier d'identifiants (exportez-en un depuis l'application de bureau avec Fichier → Exporter Conn avec identifiants…, ou écrivez-le à la main) et démarrez le relais avec les indicateurs du proxy ajoutés à sa configuration habituelle :

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
OptionCe que cela fait
--proxy-credentialsLe fichier d'identifiants. Le paramétrer est ce qui active le proxy. Le fichier est relu à chaque nouvelle session du navigateur, donc les modifications prennent effet sans redémarrage.
--proxy-tokenUn secret partagé que le navigateur doit présenter. Obligatoire : sans lui, le relais refuse de démarrer sauf si vous passez --proxy-insecure-no-token, qui sert toutes les bases de données listées à toute personne pouvant atteindre le port.
--proxy-bindOù le proxy écoute ; le port par défaut est 8444. Il utilise le certificat TLS du relais pour wss://; --proxy-plain sert ws:// pour les tests locaux ou derrière un proxy inverse terminant TLS.
--proxy-allowed-originsOrigines web séparées par des virgules autorisées à ouvrir une session, donc seules les pages que vous hébergez peuvent utiliser le proxy. Laissez ce champ vide pour autoriser n’importe quelle origine (le jeton s’applique toujours).
--proxy-max-sessionsNombre de sessions de navigateur pouvant être ouvertes à la fois (chacune est un processus moteur) ; la valeur par défaut est 32. Un proxy à pleine capacité demande aux nouvelles sessions de réessayer plus tard.
--proxy-engine-binaryOù sqlly-cli est, si ce n'est pas à côté sqlly-relay ou sur le PATH.

Chaque indicateur a une forme de variable d'environnement (RELAY_PROXY_CREDENTIALS, RELAY_PROXY_TOKEN, et ainsi de suite) pour les déploiements de conteneurs. L'image du conteneur de relais inclut le moteur lorsqu'elle est construite avec --build-arg WITH_PROXY_ENGINE=1.

Deux règles diffèrent d’un import depuis le bureau : les identifiants partagés et les profils de tunnel doivent être définis dans le même fichier (le relais n’a pas de connexions enregistrées sur lesquelles se rabattre), et une via-relay route sur une connexion est ignorée, car l'hôte relais se connecte lui-même à chaque serveur.

Ouvrir la version navigateur en la pointant dessus

Ajoutez l'adresse du proxy et le jeton à l'URL de la version du navigateur :

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

Une page qui intègre la version peut définir SQLLY_PROXY_URL et SQLLY_PROXY_TOKEN en tant que variables globales avant que l'application ne se lance au lieu de les mettre dans la barre d'adresse. Au chargement, l'application se connecte, la ligne d'état indique le relais et le nombre de connexions qu'il dessert, et ces connexions apparaissent dans l'explorateur prêtes à l'emploi. Les bases de données d'exemple ne sont pas du tout téléchargées dans ce mode.

Héberger la page vous-même. Les navigateurs n’autorisent une page à ouvrir des sockets que vers les origines que sa politique de sécurité autorise. La build servie sur sqlly.app autorise sa propre origine ; un proxy sur un autre hôte demande d’élargir cette politique, ou alors servez la build depuis le domaine du relais lui-même. Si la page se charge mais signale qu’elle n’a pas réussi à joindre le proxy du relais, c’est le premier point à vérifier.

Ce qui change dans l'application

  • Les connexions sont en lecture seule. La liste est celle du relais. Ajouter un serveur, Dupliquer, Supprimer et Importer des connexions sont désactivés ; les boutons ajouter, supprimer et dupliquer du gestionnaire de connexions ainsi que ses éditeurs de client, de projet et d’environnement sont verrouillés ; et l’ouverture d’une connexion l’affiche comme Afficher la connexion avec Enregistrer désactivé et une note précisant que le relais détient ses propres identifiants. Modifiez le fichier d'identifiants sur le relais pour changer ce que voient les utilisateurs.
  • Tester la connexion fonctionne toujours - elle passe par le proxy comme toute requête, et toutes les fonctionnalités de requête, l'explorateur d'objets, la synchronisation du catalogue IntelliSense, les plans d'exécution, le script et l'édition de lignes fonctionnent de la même manière.
  • Les étiquettes sont également incluses. Les noms, les couleurs et les réglages de sécurité des clients, des projets et des environnements du fichier regroupent l'explorateur de la même manière que sur l'application de bureau ; les icônes sont omises pour alléger la page.
  • Si le relais disparaît - la ligne de statut l'indique et les requêtes sur les connexions proxy échouent avec un message clair jusqu'à ce que la page soit rechargée.