## Problem
The FAQ entry _"How can I restrict inbound/outbound file transfers from
Coder workspaces?"_ documents the wrong block list for
`CODER_AGENT_BLOCK_FILE_TRANSFER`.
It currently says the list includes `scp`, `rsync`, `ftp`, and `nc`.
The actual list in
[`agent/agentssh/agentssh.go`](https://github.com/coder/coder/blob/main/agent/agentssh/agentssh.go)
is:
```go
// BlockedFileTransferCommands contains a list of restricted file transfer commands.
var BlockedFileTransferCommands = []string{"nc", "rsync", "scp", "sftp"}
```
So the docs have two errors:
- **`ftp` is documented but is not blocked.** An admin reading this page
could reasonably believe `ftp` is covered when it is not.
- **`sftp` is blocked but is not documented.** This matters
operationally, because SFTP is blanket-blocked at the subsystem level
(`if session.Subsystem() == "sftp"`), which disables anything built on
it.
## Changes
1. Correct the block list to match the source, in the same order as the
slice so the two are easy to diff by eye in future:
```diff
-block list, which includes `scp`, `rsync`, `ftp`, and `nc`.
+block list, which includes `nc`, `rsync`, `scp`, and `sftp`.
```
2. Per review feedback, add a note to **Important Notice** covering what
enabling this actually breaks: SFTP-based tooling, and [Coder Desktop
file
sync](https://coder.com/docs/user-guides/desktop/desktop-connect-sync).
Desktop file sync breaks via `scp` rather than `sftp`. It runs Mutagen
over SSH, and Mutagen's SSH transport installs its remote agent binary
by shelling out to `scp`
([`pkg/agent/transport/ssh/transport.go`](https://github.com/coder/mutagen/blob/v0.18.3/pkg/agent/transport/ssh/transport.go)),
which is on the block list. The note keeps that distinction because an
admin debugging it will see an `scp` failure, not an SFTP one.
## Correction
An earlier revision of this description claimed `coder cp` is also
blocked. **That was wrong — there is no `coder cp` command.** No
`cli/cp.go`, no `docs/reference/cli/cp.md`, no `cp` entry in the CLI
index. I've removed the claim rather than document a command that
doesn't exist. Discussed in the thread below.
## Not included
Linking the FAQ to [Agent
Firewall](https://coder.com/docs/ai-coder/agent-firewall) from the "For
more advanced security needs" line, which currently only says "consider
adopting an endpoint security solution." Happy to add if wanted, but it
felt out of scope for a correctness fix.
Also note I only verified the macOS Desktop client.
`coder-desktop-windows` and `coder-desktop-linux` are very likely the
same Mutagen setup, but I didn't read them, so the note makes no
per-platform claim.
Created on behalf of @bartekgatzcoder.
---------
Co-authored-by: blink-so[bot] <211532188+blink-so[bot]@users.noreply.github.com>