Tutorial - Creating a Transfer Rule for an SFTP Server
In this tutorial, you will:
- Create a rule for a local SFTP server.
- View the rule in effect during a file transfer.
Step 1 | From the UDMG Admin UI navigation pane, select Rules. The Rules list displays. | ||||||||
---|---|---|---|---|---|---|---|---|---|
Step 2 | Click New. The Rule Details displays.
| ||||||||
Step 3 | Click the Save icon button. | ||||||||
Step 4 | The rule is created and appears on the Rules list: | ||||||||
Step 5 | The virtual path is now presented to the SFTP client. Connect to the SFTP server with the user that was created on the previous tutorial: $ sftp -P 4100 stonebranch-01@0.0.0.0 stonebranch-01@0.0.0.0's password: Connected to 0.0.0.0. sftp> ls -hl drwxrwxrwx 0 65534 65534 0B Jun 20 15:09 sftp-01-in | ||||||||
Step 6 | From the UDMG Admin UI navigation pane, select Local Servers. The Server list displays. Select the stonebranch-sftp-01 server and click on the Rules tab. The green dot on the tab shows that a rule is now assigned to this server. In the Receiving Rules list, there is 1 entry with the rule created above By default, a rule is implicitly assigned to all servers unless there is an explicit whitelist assignment. This is indicated with the globe icon (
| ||||||||
Step 7 | To restrict the use of this rule and this virtual path to only the server stonebranch-sftp-01, you have to assign the rule to that server. Select the stonebranch-sftp-01 server and click on the Rules tab. | ||||||||
Step 8 | Click Pencil icon on the Rules tab - Receiving Rules to display an Edit Rules pop-up that allows you to assign the Receiving Rules to the Local Server. To assign (or "authorize") a Rule to a Local Server, move the Rule from the Available items window to the Selected items window:
To unassign (or "revoke") the Rule to a Local Server, move the Rule from the Selected items window to the Available items window:
| ||||||||
Step 9 | The rule is now whitelisted for this server and marked with a card icon: The rule does not appear anymore for the other servers. For instance, it is not listed anymore for the server "server1": The rule and this virtual path is only accessible for this local server and for all of its accounts. It is possible to further restrict a rule to only a specific account of a server by assigning it on the account Rules screen. The available virtual paths for a given account are a combination of:
Note Both the rules that are assigned at account level or at server or partner level are indicated with the card icon ( ) in the Rules lists.When updating an account, the server or partner level rules are listed in the Selected Items of the Edit Rules pop-up, but only the account level rules can be removed. Attempting to unassign a server or partner rule will have no effect. It must be done from the relevant server or partner Rules pop up. | ||||||||
Step 10 | Upload a file on the SFTP server on the virtual path location: $ date > date.txt $ sftp -P 4100 stonebranch-01@0.0.0.0 stonebranch-01@0.0.0.0's password: Connected to 0.0.0.0. sftp> put date.txt sftp-01-in/date.txt Uploading date.txt to /sftp-01-in/date.txt date.txt 100% 29 54.3KB/s 00:00 | ||||||||
Step 11 | From the UDMG Admin UI navigation pane, select History. The History dashboard displays: | ||||||||
Step 12 | Check the file is received on the directory that is set by the rule: Where each part of the path is determined by:
See also Folder Management |