SFTP Root Path Dialog

This dialog allows you to add or edit SFTP root paths and to configure the users and groups assigned to them. Both a path and an alias must be specified.

Note: If you are not using a client A computer or application that uses services provided by a server. that has implemented VanDyke Software's SFTP Root extension, your client may not display the root in the tree. However, even though the client may not be able to display the root, you can still use the "Change Directory" command to access the defined root (e.g., Change Directory MyRoot:).

SFTP Root

Enter the path that you want to include in your SFTP Root List. Users will not be allowed to access any folder above the specified root folder.

VShell supports the following substitution variables within an SFTP root path:

Variable	Description
%USER%	Specifies a username as part of the SFTP Root path. For example, an SFTP root with the path set to C:\Users\%USER%\Sftp for a user with a username of Jonesdev would resolve to C:\Users\Jonesdev\Sftp when Jonesdev makes an SFTP connection A data path or circuit between two computers over a phone line, network cable, or other means. to VShell. When a user makes an SFTP connection to VShell, each SFTP root containing an allow entry for that user (or for a group to which the user belongs) will be available to the user.
%HOME%	Defines a user's home folder as the SFTP Root path. For example, an SFTP root with the path set to %HOME% would resolve to the path set as the HOME environment variable for the user making the SFTP connection to VShell. Note: In order for the %HOME% variable to work, the Load the users's environment option in the SFTP category must be checked.
%MYDOCUMENTS%	Exposed the user's My Documents folder as one of the SFTP roots for that user. Typically (under Windows 2000, XP, and 2003), this folder is located at `C:\Documents and Settings\<username>\My Documents`.
%DESKTOP%	Exposed the user's Desktop folder as one of the SFTP roots for that user. Typically (under Windows 2000, XP, and 2003), this folder is located at `C:\Documents and Settings\<username>\Desktop`.
%MYMUSIC%	Exposed the user's My Music folder as one of the SFTP roots for that user.
%MYPICTURES%	Exposed the user's My Pictures folder as one of the SFTP roots for that user.
%PROGRAMFILES%	Exposed the user's Program Files folder as one of the SFTP roots for that user. Typically (under Windows 2000, XP, and 2003), this folder is located at `C:\Program Files`.

Alias

Enter the alias you want to use for the SFTP Root.

User/Group List

This list displays the users and groups assigned to the SFTP Root and lets you allow or deny access to the specific root.

Precedence of Deny vs. Allow Entries:

When a user makes an SFTP connection, VShell looks through the list of SFTP roots. For each SFTP root, VShell determines if the connecting user has access by performing the following actions (in the order listed):

1. VShell tries to find the user within all of the user/group entries set to Deny. If a match is found for the user within the denied user/group entries for an SFTP root, the user will not be able to access the root.

2. VShell then tries to find the user within all of the user/group entries set to Allow. If a match is found for the user within the allowed user/group entries for an SFTP root, the user will be able to access the root.

3. If a match for the user is not found in any of the denied or allowed entries, the user will not be able to access the root.