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