You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@guacamole.apache.org by "4m1nr (via GitHub)" <gi...@apache.org> on 2026/07/14 07:47:37 UTC

[PR] GUACAMOLE-2064: Add UI support for database terminal protocols [guacamole-client]

4m1nr opened a new pull request, #1229:
URL: https://github.com/apache/guacamole-client/pull/1229

   ## What this does
   
   Adds the web-interface support for the five new database terminal protocols
   (**MySQL, PostgreSQL, SQL Server, MongoDB, Oracle**) implemented in
   guacamole-server for
   [GUACAMOLE-2064](https://issues.apache.org/jira/browse/GUACAMOLE-2064), so that
   connections using them can be created and configured from the Guacamole admin
   UI.
   
   ## Changes
   
   - **`LocalEnvironment.java`** — the five protocol names are added to
     `KNOWN_PROTOCOLS` so their bundled connection-parameter definitions are
     loaded.
   - **Five protocol form definitions** under
     `guacamole-ext/…/protocols/{mysql,postgresql,mssql,mongodb,oracle}.json`,
     modeled on `telnet.json`. Each describes the relevant field groups —
     network, authentication, encryption (TLS/SSL), terminal display, clipboard,
     behavior, typescript, session recording, and Wake-on-LAN — using the existing
     field types (`TEXT`, `NUMERIC`, `USERNAME`, `PASSWORD`, `BOOLEAN`, `ENUM`,
     `TERMINAL_COLOR_SCHEME`). Per-database differences are reflected: MySQL/PG
     expose their respective `ssl-mode` value sets, SQL Server exposes
     `tds-version`, MongoDB exposes `auth-database` and a boolean `use-ssl`, and
     Oracle uses `service-name` in place of `database`.
   - **`en.json`** — full English translations for every field header, ENUM
     option, and section header of all five protocols, plus each protocol's
     display `NAME`. (Coverage was checked by canonicalizing every form field to
     its expected translation key — 0 missing.)
   - **`ui.css`** — the terminal icon (`guac-text.svg`) is associated with each new
     protocol, matching SSH/telnet/Kubernetes.
   
   Only English strings are added; other locales fall back to English as usual.
   No database-schema or JDBC-extension changes are required — connections store
   the protocol as a free-form string.
   
   ## Testing
   
   - `mvn -pl guacamole-ext -am test` passes.
   - Full `mvn -pl guacamole -am package` (webpack WAR build) succeeds.
   - Every form field and ENUM option was verified to resolve to a defined
     translation key.
   - Connection forms render and their labels/options resolve when creating a
     connection of each new type. _(Screenshots can be added on request.)_
   
   ## Related PRs
   
   Part of a three-repo change under GUACAMOLE-2064:
   
   - Server (guacd C implementation): _<fill in guacamole-server PR URL>_
   - Client (this PR): _<fill in after opening>_
   - Manual (documentation): _<fill in guacamole-manual PR URL>_
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@guacamole.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org