SQLly на странице: режим релейного прокси
функциональныйЗапускайте браузерную сборку с вашими базами данных через реле под вашим контролем — оно хранит учётные данные, поэтому страница никогда не видит пароль.
Этот версия для браузера SQLly обычно работает с демонстрационными данными прямо в вашей вкладке, потому что веб-страница не может открыть сокет базы данных. Режим прокси ретранслятора дает ему реальные серверы: sqlly-relay который вы запускаете, получает
файл учётных данных, а браузерная сборка, открытая по адресу этого реле, работает со всеми серверами и базами из файла: обозреватель объектов, IntelliSense, планы выполнения и правка строк — всё включено, при этом пароли никогда не покидают хост реле.
Как всё это устроено
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
- Релей выдаёт файл учётных данных. Всё, что в нём есть, — каждое подключение, сервер, база данных, логин и пароль, общие логины, SSH-туннели и прокси, а также метки клиента, проекта и окружения — доступно браузеру. И ничего больше.
- Один движок на сессию. Каждая сессия браузера получает собственный движок SQLly на хосте ретранслятора, запущенный в ужесточённом режиме: он открывает только подключения из файла. Запрос, указывающий собственный сервер или несущий собственный пароль, отклоняется.
- Браузер получает имена, а не секреты. Он получает список подключений, из которого удалены пароли, настройки туннелей и токены, и никогда не хранит его, ретранслятор присылает список заново при каждой загрузке страницы.
- Вторая задача релея осталась нетронутой. Прокси — отдельный слушатель, включаемый по желанию. Реле без него пересылает трафик Via Relay в точности как раньше.
Настройте ретранслятор
На хосте, который может подключиться к базам данных и имеет sqlly-cli установлено рядом с
sqlly-relay, создайте файл учётных данных (экспортируйте его из настольного приложения с помощью
Файл → Экспортировать подключения с учётными данными…, или напишите его вручную) и запустите реле, добавив флаги прокси к его обычной конфигурации:
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
| Флаг | Что оно делает |
|---|---|
--proxy-credentials | Файл учётных данных. Именно его задание включает прокси. Файл перечитывается для каждой новой сессии браузера, поэтому правки вступают в силу без перезапуска. |
--proxy-token | Общий секрет, который браузер должен предъявить. Обязательно: без него ретранслятор отказывается запускаться, если вы не передадите --proxy-insecure-no-token, который предоставляет доступ к каждой указанной базе данных каждому, кто может подключиться к порту. |
--proxy-bind | Где слушает прокси; по умолчанию порт 8444. Он использует TLS-сертификат ретранслятора для wss://; --proxy-plain обслуживает ws:// для локального тестирования или за обратным прокси с завершением TLS. |
--proxy-allowed-origins | Веб-источники (origin), разделённые запятыми, которым разрешено открывать сеанс, — чтобы использовать прокси могли только страницы, которые вы хостите. Оставьте поле пустым, чтобы разрешить любой источник (токен всё равно применяется). |
--proxy-max-sessions | Сколько браузерных сессий может быть открыто одновременно (каждая — отдельный процесс движка); по умолчанию 32. Когда лимит исчерпан, прокси просит новые сессии повторить попытку позже. |
--proxy-engine-binary | Где sqlly-cli находится, если он лежит не рядом с sqlly-relay или на PATH. |
Каждый флаг имеет форму переменной окружения (RELAY_PROXY_CREDENTIALS,
RELAY_PROXY_TOKEN, и так далее) для контейнерных развёртываний. Образ контейнера реле включает движок, если собран с --build-arg WITH_PROXY_ENGINE=1.
Два правила отличаются от импорта на рабочем столе: общие логины и профили туннеля должны быть определены в одном файле (ретранслятор не имеет сохранённых соединений, к которым можно было бы обратиться), и маршрут
via-relay маршрут, заданный для подключения, игнорируется, потому что к каждому серверу подключается сам ретранслятор.
Откройте браузерную сборку через ретранслятор
Добавьте адрес прокси и токен в URL браузерной сборки:
https://sqlly.app/app/?proxy=wss://relay.example.com:8444/proxy&token=a-long-random-secret
Страница, которая встраивает сборку, может задать SQLLY_PROXY_URL и
SQLLY_PROXY_TOKEN как глобальные переменные ещё до запуска приложения, вместо того чтобы класть их в адресную строку. При загрузке приложение подключается, строка состояния показывает имя ретранслятора и сколько подключений он обслуживает, и эти подключения появляются в обозревателе готовые к работе. Примеры баз данных в этом режиме вообще не скачиваются.
Что меняется в приложении
- Подключения только для чтения. Этот список принадлежит реле. Добавить сервер, Дублировать, Удалить и Импорт подключений отключены; кнопки добавления, удаления и дублирования в диспетчере подключений, а также редакторы клиента, проекта и окружения заблокированы; а при открытии подключения оно отображается как Просмотр подключения с отключённой кнопкой «Сохранить» и примечанием, что учётные данные хранит ретранслятор. Измените файл учётных данных на ретрансляторе, чтобы поменять то, что видят пользователи.
- Проверка подключения по-прежнему работает - оно проходит через прокси так же, как любой запрос, и так же работают все функции запросов, обозреватель объектов, синхронизация каталога IntelliSense, планы выполнения, сценарии и редактирование строк.
- Метки тоже прилагаются. Имена, цвета и переключатели безопасности клиентов, проектов и окружений из файла группируют проводник точно так же, как на настольной версии; иконки убрали, чтобы страница оставалась лёгкой.
- Если ретранслятор станет недоступен - строка состояния сообщит об этом, а запросы через проксированные подключения будут падать с внятным сообщением, пока страница не перезагружена.