SQLly en une page : mode proxy relais
fonctionnelExé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.
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
| Option | Ce que cela fait |
|---|---|
--proxy-credentials | Le 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-token | Un 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-bind | Où 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-origins | Origines 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-sessions | Nombre 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-binary | Où 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.
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.