Skip to content

Add RDP hosts

Availability All editions — Community and up.

Requires the manage targets permission.

Tessera brokers Windows Remote Desktop (RDP). A user opens a native remote-desktop window; the controller tunnels the RDP stream (TCP), and the desktop app injects the Windows credential into its bundled RDP client in memory — never written to disk or saved to the OS credential store, though it is handled by the desktop process.

  1. Go to RDP → Add host.
  2. Enter a name and host. The port defaults to 3389.
  3. Optionally set a domain (for Active Directory logins), a project and group.

Open Credentials and provide the Windows username and password (and domain if used). It’s encrypted at rest and never shown again.

When a user connects, the controller tunnels the RDP stream and the desktop app injects the password into its bundled RDP client over an in-memory channel — it is never written to disk or saved to the OS credential store, and it’s never shown in the desktop app. (The CLI instead opens a local port and prints the credential to the terminal so you can connect with your own RDP client.) The user lands on the Windows desktop already signed in.

From the desktop app, Open RDP window launches a native remote-desktop window through the broker — a remote-desktop client is bundled with the app, so there’s nothing to install. The CLI can instead open a local port for your own remote-desktop client.

RDP connects and disconnects are recorded in the audit log with the user, target and time. Read-only mode isn’t enforced inside the Windows desktop — grant RDP as read-write, and rely on just-in-time access and audit for control.

An RDP host is invisible until someone has a grant. Add grants under Access — see Access control.