Tutorial - Create Authentication Server for UDMG Web Transfer Client

Owned by
Stonebranch
Last updated: Apr 01, 2024 by
Olivier Michaut
3 min read

In this tutorial, you will:

  • Create the authentication server for the UDMG Web Transfer Client.

  • Manually launch the server.

  • View server details.

  • Add a user and setup allowed directories.

Step 1

From the UDMG navigation pane, select Management > Servers. The Servers list displays.

Step 2

Click New. The Server Details displays.

  • In the Server Name field, enter local_auth_test_server

  • In the Protocol field, select LOCAL-AUTH

  • In the IP Address field, enter 0.0.0.0

  • In the Port field, enter 2002

  • In the Root Directory field, enter /data/rootdir_local_auth

  • In the Receive Directory field, enter in

  • In the Send Directory field, enter out

  • In the Temp Directory field, enter tmp

Step 3

Click the Configuration tab on the Partner detail panel.

In the Auth Key, press the generate new Auth Key button.

 Keep the value of the Key, it will be needed for the configuration of the UDMG Web Transfer Client.

Additionally, the deletion and renaming of files can be allowed with the appropriate configuration switches.

The changes are effective after a restart of the local server.

Step 4To allow the UDMG Web Transfer users to delete or rename files on the virtual folders, toggle the Allow Remove File and Allow Rename File accordingly.

Step 5

Click Save and Confirm.

Step 6

Click the Accounts tab on the Partner detail panel. Click Add Account.

  • In the Name field, enter WebUser.

  • Leave the Password field Web1234

Step 7

Click Save

Step 8

Start the server by clicking on the start (play) button.

Step 9

Click on the MFT Server Status button to show the list of running services.

The new server local_auth_test_server is listed and should appear with a green status.

Step 10

From the UDMG navigation pane, select Management > Rules. The Rules list displays.

Step 11

Click New. The Rule Details displays.

  • In the Rule Name field, enter WebUser_receive.

  • In the Direction field, select Receive.

  • In the Description field, enter any value, for example "Receive files under 'WebUser' folder".

  • In the Path Directory field, enter in

  • In the Local Directory field, enter WebUser.

  • In the Remote Directory field, leave it empty

  • In the Temp Directory field, leave it empty

Step 12

Authorize the receive rule for the user.

Step 13

The local-auth server is ready to accept requests from UDMG Web Transfer Client.

To setup the UDMG Web Transfer Client connection to this local server, see the [secrets] section in the configuration file on the installation guide.

Note

The local-auth server port is only for the internal connection between the UDMG Web Transfer Client module and the UDMG Server. It must be configured in the [secret] section of the UDMG Web Transfer Client configuration file.

The port for the UDMG Web Transfer Client itself is configured with the port parameter in the [settings] of the same file.

[settings]
####################################
# The settings section configures the
# Web Transfer Client UI
####################################
## Network interface, default "0.0.0.0"
inet = "0.0.0.0"
## Port, default "5050"
port = "5050"
...
[secrets]
#############################################
# The secrets section configures the connection towards udmg-server
# and the Web Transfer Client Authentication Server (local-auth)
# There are no default, the local-auth server must be defined and started in the UDMG Server
#############################################
## URL of the Web Client Authentication server API, local-auth server
endpoint = "http://0.0.0.0:2002"
## API Key to authenticate to the Web Client Authentication server
apikey = "YNna6dGe6MZ44ZBmszlizlO6UzpziUnU0Se5bNC6"