UDMG Web Transfer Client for Windows Installation

Owned by
Stonebranch
Last updated: Jun 10, 2023 by
Olivier Michaut
2 min read

Requirements

Installing UDMG Web Transfer Client

  • Create a directory C:\UDMG\Web_Transfer_Client:

  • Create a configuration file for the service:

# C:\MFT\udmg-web-transfer\config.toml

[settings]
####################################
# Web Transfer Client
####################################
## Network interface, default "0.0.0.0"
inet = "0.0.0.0"
## Port, default "5050"
port = "5050"
## Working directory
workdir = "C:\UDMG"
## SSL certificate, uncomment to enable HTTPS
#ssl_cert = "path_to_file.crt"
#ssl_cert_key = "path_to_file.key"
#############################################
# Fine tuning parameters
#############################################
## Enable recover on panic, default true, should be true for production environment
recover = true
## Enable Cross-Origin Resource Sharing (CORS), should be true for production environment
cors = true
## Enable Cross-Site Request Forgery (CSRF) token, should be true for production environment
csrf = true
## Enable Request Track ID, default true
tracker = true
## Enable Request Logger, default true
logger = true
## Enable Prometheus Metric /metrics
metrics = true
## Enable Ratelimit
limit = 50
## Update Interval, number of seconds before to send a upload to the local auth service
update_interval = 60

#############################################
# Web Transfer Client Authentication Server
# This is defined in the UDMG Server
#############################################
[secrets]
## URL of the Web Client Authentication server API
endpoint = "http://<LOCAL-AUTH-ADRESS>:<LOCAL-AUTH-PORT>"
## API Key to authenticate to the Web Client Authentication server
apikey = "<API_KEY>"

The placeholders LOCAL-AUTH-ADRESS, LOCAL-AUTH-PORT and API _KEY must be set to the values from the local authentication server that is configured on the UDMG Admin UI, see Tutorial - Create Authentication Server for UDMG Web Transfer Client.

  • Install the binary under C:\MFT\udmg-web-transfer

udmg-web-transfer.exe


Setup the Windows Service with WinSW


UDMG Web Transfer Client


Download WinSW and copy winsw.exe under C:\UDMG\udmg-web-transfer with the following name: udmg-web-transfer-service.exe


Create a new Service definition for our Service:


id: UDMG Web Transfer
name: UDMG Web Transfer
description: UDMG Web Transfer
executable: C:\UDMG\udmg-web-transfer\udmg-web-transfer.exe
priority: Normal
workingdirectory: C:\UDMG\udmg-web-transfer
env:
- name: UDMG_WEB_TRANSFER
value: 'C:\UDMG\udmg-web-transfer\config.toml'

Open a command prompt under C:\UDMG\udmg-web-transfer and run the command

C:\MFT\Web_Transfer_Client>udmg-web-transfer-service.exe install
2022-07-11 11:23:24,653 INFO - Installing service 'UDMG Web Transfer (UDMG Web Transfer)'...
2022-07-11 11:23:24,680 INFO - Service 'UDMG Web Transfer (UDMG Web Transfer)' was installed successfully.

Start the service

C:\MFT\Web_Transfer_Client>udmg-web-transfer-service.exe start
2022-07-11 11:23:24,653 INFO - Starting service 'UDMG Web Transfer (UDMG Web Transfer)'...
2022-07-11 11:23:24,680 INFO - Service 'UDMG Web Transfer (UDMG Web Transfer)' started successfully.