Use GitHub's private vulnerability reporting on this repository ("Security" → "Report a vulnerability"). Do not open a public issue for anything that could let a remote host, a session peer or another local user read secrets or run code. Expect an acknowledgement within a week.
Constellation embeds three protocol engines that parse data from remote machines in the app's own process:
| Component | Pinned at | Used for | Watch |
|---|---|---|---|
libghostty (Vendor/ghostty submodule) |
v1.4.0 (2026-10-27), built with Zig 0.17.0 |
terminal emulation for SSH tabs | https://github.com/ghostty-org/ghostty/releases, https://github.com/ghostty-org/ghostty/security |
FreeRDP + WinPR (Vendor/freerdp submodule) |
tag 3.31.1 |
RDP sessions | https://github.com/FreeRDP/FreeRDP/security/advisories, https://github.com/FreeRDP/FreeRDP/releases |
| OpenSSL (source build, linked statically into FreeRDPKit) | LTS release 3.5.8, archive SHA-256 pinned in Scripts/build-openssl.sh |
TLS and NLA for RDP | https://openssl-library.org/news/vulnerabilities/ |
| cJSON (source build, linked statically into FreeRDPKit) | release 1.7.19, archive SHA-256 pinned in Scripts/build-cjson.sh |
JSON from Entra ID and the Azure Virtual Desktop gateway | https://github.com/DaveGamble/cJSON/releases, https://github.com/DaveGamble/cJSON/security |
| RoyalVNCKit (Swift package) | revision 92d4427c (tag 1.1.0) |
VNC sessions | https://github.com/royalapplications/royalvnc/releases |
| GRDB (Swift package) | exact 7.11.1 |
SQLite storage | https://github.com/groue/GRDB.swift/releases |
| Sparkle (prebuilt framework, Swift package) | exact 2.10.0 |
in-app updates | https://github.com/sparkle-project/Sparkle/releases, https://github.com/sparkle-project/Sparkle/security |
| OpenSSH | the system /usr/bin/ssh |
SSH transport | macOS security updates |
Passwords and passphrases are stored only in the login Keychain and are never
written to arguments, environment, the database or logs. Certificate decisions
for RDP live in trust.sqlite; SSH host keys are OpenSSH's own known_hosts.
Azure Virtual Desktop sign-ins happen on Microsoft's Entra ID page in a WebKit view. The app never sees the password, and the tokens FreeRDP receives live only in the session's memory. WebKit keeps Microsoft's sign-in cookies in the app's website data, which is what lets a later connection skip the prompt.
Updates are fetched from the appcast attached to the latest GitHub release and
installed only when the archive's EdDSA signature verifies against the
SUPublicEDKey baked into the app, and macOS additionally checks that the new
bundle carries the same Developer ID team. The private key exists in two
places: the release maintainer's login Keychain and the SPARKLE_ED_PRIVATE_KEY
repository secret. A compromised key means rotating it (generate_keys),
shipping a release with the new public key, and treating every earlier build
as unable to update.
- Check the upstream release notes and advisories for the range being
crossed. For FreeRDP, read the GHSA entries; most are in codecs and
channels, so also check which of those the build enables
(
Scripts/build-freerdp.sh). - Move the pin: submodule commit or tag for libghostty and FreeRDP
(
git -C Vendor/<name> checkout <ref>),Package.swiftfor RoyalVNCKit and GRDB,ZIG_VERSION/ZIG_SHA256inScripts/build-libghostty.shwhen Ghostty'sbuild.zig.zonrequires a newer Zig, andOPENSSL_VERSION/OPENSSL_SHA256inScripts/build-openssl.shfor OpenSSL, andproject.ymlplusSPARKLE_VERSION/SPARKLE_SHA256in.github/workflows/release.ymlfor Sparkle. Refresh and commit each affectedPackage.resolvedafter a Swift package change. - Rebuild the native kits:
Scripts/build-libghostty.sh,Scripts/build-freerdp.sh. Both are reproducible from the scripts alone. - Run the full test scheme, then the environment-gated live tests against a
real host for the protocol touched (
CONSTELLATION_TEST_RDP_*,CONSTELLATION_TEST_VNC_*,CONSTELLATION_TEST_SSH_*). - Commit the bump on its own (
build(<component>): …) so the history shows exactly which versions shipped together, then cut a release withScripts/release.sh.
- Decide within a day whether the affected code is compiled in and reachable
from a session. Feature flags in the build scripts and the settings the
bridge pins (
constellation_rdp.c) usually answer this. - If it is reachable, ship a release with the fix before adding anything else, following the update steps above. If upstream has no fix yet, prefer turning the feature off in the build over waiting.
- Record the assessment in the release notes, including "not affected" outcomes so they are not re-investigated.