Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions .github/ISSUE_TEMPLATE/testplan.md
Original file line number Diff line number Diff line change
Expand Up @@ -1238,7 +1238,7 @@ tsh bench web sessions --max=5000 --web user ls
- [ ] A folder from inside the shared directory can be copy-pasted to another folder inside shared directory (and its contents retained)
- RBAC
- [ ] Give the user one role that explicitly disables directory sharing (`desktop_directory_sharing: false`) and confirm that the option to share a directory doesn't appear in the menu
- Per-Session MFA (try webauthn on each of Chrome, Safari, and Firefox; u2f only works with Firefox)
- Per-Session MFA
- [ ] Attempting to start a session no keys registered shows an error message
- [ ] Attempting to start a session with a webauthn registered pops up the "Verify Your Identity" dialog
- [ ] Hitting "Cancel" shows an error message
Expand Down Expand Up @@ -1282,6 +1282,10 @@ tsh bench web sessions --max=5000 --web user ls
- Set up Teleport in a trusted cluster configuration where the root and leaf cluster has a w_d_s connected via tunnel (w_d_s running as a separate process)
- [ ] Confirm that windows desktop sessions can be made on root cluster
- [ ] Confirm that windows desktop sessions can be made on leaf cluster
- Screen size
- [ ] Desktops that specify a fixed `screen_size` in their spec always use the same screen size.
- [ ] Desktops sessions for desktops which specify a fixed `screen_size` do not resize automatically.
- [ ] Attempting to register a desktop with a `screen_size` dimension larger than 8192 fails.
- Non-AD setup
- [ ] Installer in GUI mode finishes successfully on instance that is not part of domain
- [ ] Installer works correctly invoked from command line
Expand Down Expand Up @@ -1412,7 +1416,7 @@ TODO(lxea): replace links with actual docs once merged

## SSH Connection Resumption

Verify that SSH works, and that resumable SSH is not interrupted across a Teleport Cloud tenant upgrade.
Verify that SSH works, and that resumable SSH is not interrupted across a Teleport Cloud tenant upgrade.
| | Standard node | Non-resuming node | Peered node | Agentless node |
|---|---|---|---|---|
| `tsh ssh` | <ul><li> [ ] </ul></li> | <ul><li> [ ] </ul></li> | <ul><li> [ ] </ul></li> | <ul><li> [ ] </ul></li> |
Expand Down
23 changes: 23 additions & 0 deletions docs/pages/desktop-access/reference/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,26 @@ desktop sessions are performed over this tunnel. To enable this mode, ensure
that `windows_desktop_service.listen_addr` is *unset*, and point
`teleport.proxy_server` at a Teleport Proxy.

## Screen size

By default, Teleport will set the screen size of the remote desktop session
based on the size of your browser window. In some cases, you may wish to
configure specific hosts to use a specific screen size. To do this, set the
`screen_size` attribute on the `windows_desktop_resource`:

```yaml
kind: windows_desktop
metadata:
name: fixed-screen-size
spec:
host_id: 307e091b-7f6b-42e0-b78d-3362ad10b55d
addr: 192.168.1.153:3389
non_ad: true

# Optional - ensures that all sessions use the same screen size,
# no matter what the size of the browser window is.
# Leave blank to use the size of the browser window.
screen_size:
width: 1024
height: 768
```
9 changes: 8 additions & 1 deletion docs/pages/reference/resources.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ desktops this way:
connections to the host. If you have multiple such services, you can create
multiple `windows_desktop` resources with different `host_id` values.
1. If you intend to log in to the desktop with local Windows users you must set
`non_ad: true`. If you intent to log in with Active Directory users, leave
`non_ad: true`. If you intend to log in with Active Directory users, leave
`non_ad` unset (or false), and specify the Active Directory domain in the
`domain` field.

Expand All @@ -170,6 +170,13 @@ spec:
addr: 192.168.1.153:3389
domain: ""
non_ad: true

# Optional - ensures that all sessions use the same screen size,
# no matter what the size of the browser window is.
# Leave blank to use the size of the browser window.
screen_size:
width: 1024
height: 768
version: v3
```

Expand Down