SQLly на странице: режим релейного прокси

функциональный

Запускайте браузерную сборку с вашими базами данных через реле под вашим контролем — оно хранит учётные данные, поэтому страница никогда не видит пароль.

Этот версия для браузера SQLly обычно работает с демонстрационными данными прямо в вашей вкладке, потому что веб-страница не может открыть сокет базы данных. Режим прокси ретранслятора дает ему реальные серверы: sqlly-relay который вы запускаете, получает файл учётных данных, а браузерная сборка, открытая по адресу этого реле, работает со всеми серверами и базами из файла: обозреватель объектов, IntelliSense, планы выполнения и правка строк — всё включено, при этом пароли никогда не покидают хост реле.

Для кого это предназначено. Команда, которой нужен SQLly без установки на странице, внутреннем портале, консоли поддержки или в учебном классе, для фиксированного набора баз данных, которыми управляет администратор. Это не путь настольного приложения Через ретранслятор : он защищён сквозным шифрованием, поэтому ретранслятор не может читать ваш трафик. Здесь же ретранслятор намеренно держит учётные данные у себя, чтобы вкладке браузера этого делать не пришлось.

Как всё это устроено

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 как глобальные переменные ещё до запуска приложения, вместо того чтобы класть их в адресную строку. При загрузке приложение подключается, строка состояния показывает имя ретранслятора и сколько подключений он обслуживает, и эти подключения появляются в обозревателе готовые к работе. Примеры баз данных в этом режиме вообще не скачиваются.

Самостоятельный хостинг страницы. Браузеры разрешают странице открывать сокеты только к источникам, разрешённым её политикой безопасности. Сборка, которую раздаёт sqlly.app, разрешает только собственный источник; для прокси на другом хосте эту политику придётся расширить — либо раздавайте сборку с домена самого ретранслятора. Если страница загружается, но сообщает, что не смогла достучаться до прокси ретранслятора, проверьте в первую очередь это.

Что меняется в приложении

  • Подключения только для чтения. Этот список принадлежит реле. Добавить сервер, Дублировать, Удалить и Импорт подключений отключены; кнопки добавления, удаления и дублирования в диспетчере подключений, а также редакторы клиента, проекта и окружения заблокированы; а при открытии подключения оно отображается как Просмотр подключения с отключённой кнопкой «Сохранить» и примечанием, что учётные данные хранит ретранслятор. Измените файл учётных данных на ретрансляторе, чтобы поменять то, что видят пользователи.
  • Проверка подключения по-прежнему работает - оно проходит через прокси так же, как любой запрос, и так же работают все функции запросов, обозреватель объектов, синхронизация каталога IntelliSense, планы выполнения, сценарии и редактирование строк.
  • Метки тоже прилагаются. Имена, цвета и переключатели безопасности клиентов, проектов и окружений из файла группируют проводник точно так же, как на настольной версии; иконки убрали, чтобы страница оставалась лёгкой.
  • Если ретранслятор станет недоступен - строка состояния сообщит об этом, а запросы через проксированные подключения будут падать с внятным сообщением, пока страница не перезагружена.