This is an old revision of the document!
SFTP browser and SSH agent
SFTP browser
Right-click an SSH session in the Session Manager and choose SFTP Browser…, or choose Transfer → SFTP Browser… while an SSH tab is active. The browser logs in with the built-in SSH engine; questions such as a new host key, a password or a key passphrase appear in the window, with an Answer box.
- Double-click a folder to open it; Up goes to the parent folder; type a path and press Go to jump to it.
- Click to select, Ctrl+click to select several.
- Download… copies the selected files and folders to a folder you choose. Files are saved as
name.partuntil complete. - Upload Files… and Upload Folder… copy to the folder shown. You can also drop files on the window.
- New Folder…, Rename… and Delete… (Delete asks first, and deletes folders with everything in them).
- A progress bar shows the current file; Cancel stops the transfer.
Several browser windows can be open at once. The browser cannot open sessions that need the OpenSSH client (a jump host or extra -o options); use Transfer → Open SFTP Tab… for those.
SSH agent
Tools → SSH Agent… shows the agent your sessions use and the keys it holds.
- Add a key file: choose the private key, type its passphrase, and optionally a time to keep it (in minutes) or “ask before each use”.
- Smartcard or token (PKCS#11): choose the card's PKCS#11 library (for example OpenSC's
opensc-pkcs11.soor a YubiKey'slibykcs11.so; libraries found on the computer are listed under Found), type the PIN and press Add Smartcard Keys. - Remove one key, or Remove All Keys.
- Lock hides the agent's keys until Unlock is pressed with the same password.
- Start an Agent (Linux): if no agent is running, Saltbush starts one for its sessions, local shells and scripts, and stops it when Saltbush exits.
Passphrases, PINs and lock passwords are handed to ssh-add privately, never on a command line. On Windows, start the “OpenSSH Authentication Agent” service first.
