Hypersocket MFT Getting Started Guide

Lee Painter HYPERSOCKET LIMITED Unit 1, Vision Business Centre, Firth Way, Nottingham, NG6 8GF, United Kingdom

Table of Contents

PREFACE ...................................................................................................................................... 4 DOCUMENT OBJECTIVE ............................................................................................................................ 4

Audience ......................................................................................................................................... 4 Document Organization ................................................................................................................. 4

DOCUMENT CONVENTION ........................................................................................................................ 5 DOCUMENTATION FEEDBACK .................................................................................................................... 5 OBTAINING TECHNICAL ASSISTANCE ........................................................................................................... 5

INTRODUCTION ........................................................................................................................... 6 WHAT IS MFT? ...................................................................................................................................... 6 KEY BENEFITS OF HYPERSOCKET MFT ......................................................................................................... 6

INSTALLING HYPERSOCKET MFT ................................................................................................... 8 NETWORK DEPLOYMENT .......................................................................................................................... 8

LAN ................................................................................................................................................. 8 DMZ ................................................................................................................................................ 9

FIREWALL RULES ..................................................................................................................................... 9 SUPPORTED PLATFORMS .......................................................................................................................... 9 INSTALLING HYPERSOCKET ...................................................................................................................... 10 THE SETUP WIZARD ............................................................................................................................... 10

Step 1 – License Agreement ......................................................................................................... 11 Step 2 – Set Password .................................................................................................................. 11 Step 3 – Upload License Key ......................................................................................................... 12 Step 4 – Download/Install Components ....................................................................................... 12 Step 5 – Configure SSL Certificate ................................................................................................ 12 Step 6 – Complete Setup............................................................................................................... 14 Logging in for the First Time ......................................................................................................... 14

INSTALLING MFT EXTENSIONS .................................................................................................... 15 AVAILABLE FEATURES ............................................................................................................................. 16

Files->File Resources ..................................................................................................................... 16 Files->FTP File Resources .............................................................................................................. 16 Files->Amazon S3 File Resources .................................................................................................. 16 Files->SFTP File Resources ............................................................................................................ 16 Files->Zip File Transformer ........................................................................................................... 16 Files->Azure Files Resources ......................................................................................................... 16 Files->SFTP Server ......................................................................................................................... 17 Files->AS2 ..................................................................................................................................... 17 Files->WebDAV Server .................................................................................................................. 17 Files->Google Drive File Resources ............................................................................................... 17 Files->PGP File Transformer ......................................................................................................... 17 Files->FTP Server ........................................................................................................................... 17 Files->NFS File Resources .............................................................................................................. 17 Files->WebDAV File Resources ..................................................................................................... 18 Files->Windows File Resources ..................................................................................................... 18 Files->Dropbox File Resources ...................................................................................................... 18 Files->File Sharing ......................................................................................................................... 18 Client->Hypersocket Client Support .............................................................................................. 18

SETTING UP RESOURCES ............................................................................................................. 19 REALMS ............................................................................................................................................... 19 FILE RESOURCES .................................................................................................................................... 20

What is a File Resource? ............................................................................................................... 20 The Virtual File System ................................................................................................................. 20 An example file resource configuration........................................................................................ 21

INSTALLING THE HYPERSOCKET CLIENT ....................................................................................... 23

LAUNCHING/ACCESSING RESOURCES ......................................................................................... 24 Web GUI ....................................................................................................................................... 24 External WebDAV ......................................................................................................................... 25 FTP(S)/SFTP access ....................................................................................................................... 26

FILE SHARING ............................................................................................................................. 28 SHARE SETTINGS ................................................................................................................................... 28

Sandbox benefits .......................................................................................................................... 28 Sandbox disadvantages ................................................................................................................ 29

QUICK SHARE ....................................................................................................................................... 29 FULL SHARING ...................................................................................................................................... 31 SHARING FILE SYSTEM ............................................................................................................................ 33 MESSAGE TEMPLATES ............................................................................................................................ 35

TROUBLESHOOTING ................................................................................................................... 36 CONNECTION IS NOT PRIVATE/CERTIFICATE ERRORS..................................................................................... 36 CANNOT CONNECT TO THE WEB UI .......................................................................................................... 36

Has the service started? ............................................................................................................... 36 Check firewall port forwarding ..................................................................................................... 37

CANNOT CONNECT TO FTP OR SFTP ........................................................................................................ 37 Check firewall port forwarding ..................................................................................................... 37

I HAVE A PROBLEM BUT IT’S NOT ANSWERED HERE ...................................................................................... 37

Preface This preface introduces the Hypersocket MFT Getting Started Guide. It has been broken down into the following sections:

Document Objective Document Convention Documentation Feedback Obtaining Technical Assistance

Document Objective The objective of this document is to provide the System Administrator with an overview of installing and configuring the Hypersocket MFT product from Hypersocket Software. Hypersocket MFT allows your users to get remote access to their files, web sites and servers.

Audience This guide is for anyone who wishes to successfully install and administrate the Hypersocket MFT product. Although this is often someone concerned with product installation and administration, it may also be a useful guide to managers whom may be considering deploying the Hypersocket MFT as a solution. This guide is expected to be useful if you are performing any of the following tasks

Installing an instance of the Hypersocket MFT Configuring an existing implementation of Hypersocket MFT

Document Organization For ease of reference this guide has been broken down into sections that match the workflow of installing and configuring the Hypersocket MFT. These are:

Introduction Installing Hypersocket MFT Installing the Hypersocket Client Setting up Resources Launching Resources Troubleshooting

in this format

Document Convention The following conventions are used in this document:

Bold font denotes either User Interface components to interact with (e.g. Click the Create button) or for extra emphasis.

UI navigation is denoted by menu items in bold separated by -> (e.g navigating to System->Configuration->SSL is done by clicking System in the left hand menu, followed by Configuration in the secondary menu at the top, finally clicking on the SSL tab).

Typed user input into the UI is shown in italic font. Tips or summaries are displayed as below:

This is a summary

Commands typed into a shell are shown

Documentation Feedback We appreciate your comments on this technical documentation and invite you to send feedback to use at support@hypersocket.com.

Obtaining Technical Assistance For all customers, resellers, distributors or partners who hold a valid support agreement with Hypersocket Software Limited technical support is available by sending an email to support@hypersocket.com. You may also find useful documentation and articles on our knowledgebase https://support.hypersocket.com.

Introduction

This chapter provides the user with an overview of what an MFT is and the benefits of using Hypersocket MFT

What is MFT? Managed file transfer (MFT) refers to a software or a service that manages the secure transfer of data from one computer to another through a network. MFT software is used by companies as an alternative to using ad-hoc file transfer solutions, such as FTP and HTTP. An MFT server offers a higher level of security, control and auditability than such ad-hoc solutions.

Key benefits of Hypersocket MFT Hypersocket MFT allows you to present a single location to manage all your files, regardless of where they may be located in your network. MFT provides these key features:

Organise multiple file systems into a single Virtual File System. Supports connecting to multiple file systems:

o Amazon S3 o Azure o Dropbox o FTP o FTPS o Google Drive o Local o NFS o SFTP o Temporary files o WebDAV o WebDAVS o Windows

Users can connect to the MFT server using many protocols: o Browser based access o FTP o FTPS o SFTP o WebDAVS

Multiple methods of strong authentication to keep your network more secure. Authenticate users against existing user databases such as Active Directory.

Powerful trigger system to allow the server to react to events (such as encrypting a file during upload).

File sharing with external users, including: o Guest account creation o Automatic expiry handling o Share folders as well as files

Installing Hypersocket MFT

This chapter provides a basic overview of the installation of Hypersocket MFT. For more detailed coverage of the different installation types you

should download the Hypersocket Installation Guide from https://www.hypersocket.com

Network Deployment Hypersocket MFT is typically deployed inside the corporate LAN, but can be installed in a DMZ if required. Both of these scenarios are covered below.

LAN Installing Hypersocket MFT in the corporate LAN is the simplest deployment. The only ports that need to be forwarded through the external firewall are the ones for the different methods you’d like your users to access (e.g. SFTP, HTTPS) and the MFT has direct access to all of the required resources.

Hypersocket MFT

Firewall

LOCAL AREA NETWORK

INTERNETFile Server

File Server

File Server

DMZ An alternative scenario is to install Hypersocket MFT in a DMZ. The same ports need to be forwarded through the external firewall as in the LAN example, but for every LAN resource required, extra ports need to be opened up on the internal LAN firewall. Hypersocket MFT can be configured to use one or two network cards with a simple change in the VM configuration.

INTERNET

Firewall

LOCAL AREA NETWORK

File Server

Hypersocket MFTFirewall

DMZ

File Server

File Server

Firewall Rules Hypersocket MFT communicates over a few different ports. Here are the port forwarding rules you need to configure on your network firewall, assuming you choose to use the default ports:

Port Direction Destination IP Notes

443 In <MFT IP> Web interface (for management and users)

80 In <MFT IP> Optional: HTTP redirect to management interface

443 Out 81.139.47.195 Optional: Used for opening a tunnel to our support

22 In <MFT IP> Optional: For user file access via SFTP/SCP

21 In <MFT IP> Optional: For user file access via FTP

990 In <MFT IP> Optional: For user file access via FTPS

Supported Platforms Hypersocket MFT comes pre-built as a virtual appliance. We have images available for the following Hypervisors:

VMware ESX/vSphere Microsoft Hyper-V

Oracle VirtualBox KVM Vagrant

We also have images for the following cloud based Hypervisors:

Amazon EC2 Microsoft Azure Google Compute Engine Oracle Compute Docker

We even have an installable ISO in case you did not want to use a VM, but install directly on to your own hardware. A final option are installers so you can deploy Hypersocket as a software service on Windows, Linux or OSX hosts. The installers can be downloaded from https://www.hypersocket.com/en/products/managed-file-transfer. You will need a license key to activate the software, if you are evaluating the product then you must register before downloading to receive your evaluation license key.

Installing Hypersocket Please refer to our Hypersocket ONE Installation Guides on our knowledge base at: https://support.hypersocket.com/hc/en-us/sections/200839385-Installing-Hypersocket

The Setup Wizard Once you have installed Hypersocket and have an IP address, we can now continue the configuration in a web browser. When connecting to the management interface for the first time, you will be asked to run through the setup wizard to finalize the installation. Connect your browser using a suitable URL for the settings you have input during the installation. https://<hostname>:[port] For example, if you have installed the server on hostname gateway.corp.local on the standard ports your URL will be https://gateway.corp.local

Please note that when connecting for the first time you will receive a warning in your browser stating that the certificate is untrusted. You will have a chance to upload your own certificate shortly. For now, you should accept the untrusted certificate.

Your browser will load the setup wizard. Simply run through the following steps to finalize your installation.

Step 1 – License Agreement

Before continuing you must accept the license agreement of the software. Click ‘I accept..’ and click Next.

Step 2 – Set Password

Next you should provide a password for the admin user account. The admin account has full system privileges and is to be used for initial administration of the server.

Step 3 – Upload License Key

As discussed earlier you cannot install the server without a license key, which you should already have done from the website. Click Choose file to select your Hypersocket license file.

Step 4 – Download/Install Components

The Hypersocket server will now need to download the core components is needs in order to start up. If you use an outbound proxy server, tick the option and enter the relevant details, or just click Next to continue if there is no proxy.

Step 5 – Configure SSL Certificate You now have the opportunity to upload an existing SSL certificate. For example, you may have a wildcard certificate for your domain. This section can be skipped at this time if you prefer to configure the certificate later. There are multiple formats supported. You can upload a PKCS12 / PFX file that contains the complete certificate, or you can upload separate PEM encoded files.

Uploading PKCS12 / PFX Select your PKCS12 / PFX file in the Private Key field. Enter the files passphrase in the Passphrase field. You can ignore the Certificate File and CA Bundle fields as PKCS12/PFX files do not have or require any other external files. Your private key and certificate are contained within the single PFX file.

Uploading PEM You should have a number of PEM files. At a minimum you should have a private key file and a certificate file. Upload the files into the appropriate fields. If your private key file is encrypted with a passphrase enter it into the Passphrase field. You may omit the CA bundle if you do not have this. These are typically provided by your CA when you purchased your SSL certificate.

Step 6 – Complete Setup

You are now ready to complete the setup. Click Restart to complete the configuration.

Your server is now ready to use, after which you will be redirected to the login page.

Logging in for the First Time Once the Setup Wizard is complete, clicking Start will direct your browser to the logon page. Here you should enter the username admin and the password that you created during Step 2 of the Setup Wizard.

After entering the admin credentials, click Logon button to log into the Hypersocket MFT.

Installing MFT Extensions

This chapter describes how to install the MFT features that are needed to run the server.

As the server is based on our Hypersocket Prime build, you must first install the features required in order to add the MFT services needed. There are many features which are applicable to all Hypersocket Prime products, but we shall detail only the MFT specifics here. Log on to the server with the admin account.

In the Nav bar at the top right of the screen, click the Updates, Features & Licensing icon.

The Features page starts with a list of all currently installed features. The other tabs are grouped into broad categories.

To install a feature, navigate to the relevant tab, find the feature required and click on the blue cloud Download icon and accept the License Agreement that appears.

The feature will download. Once completed a server restart notification appears. Restart the service now using the Shutdown/restart

icon in the top navbar.

Available Features Following is a list of all features you can download that relate to the MFT part of the Hypersocket Server.

Files->File Resources Access File systems through the web-based user interface via a Virtual File System (VFS). If this feature is installed on its own, you will only be able to access files stored locally on the Hypersocket Server. For other filesystem types you need to install those features separately. See below. The Virtual File System can be used to mount any number of different file systems into a directory tree structure of your choosing.

Files->FTP File Resources Connect to FTP Servers and grant access to that server’s files via the Virtual File System.

Files->Amazon S3 File Resources Connect to Amazon S3 buckets and grant access to that cloud service’s files via the Virtual File System.

Files->SFTP File Resources Connect to SFTP Servers (via the SSH protocol) and grant access to that server’s files via the Virtual File System.

Files->Zip File Transformer Adds support for zipping directories or files via File Resources. Whilst browsing the VFS, an action will appear in the Gears icon next to every file and folder to allow your users to download a zip file containing the item.

Files->Azure Files Resources Connect to Microsoft Azure buckets and grant access to that cloud service’s files via the Virtual File System.

Files->SFTP Server Allow your users to connect to the Hypersocket server using either SFTP or SCP clients to access their files on the Virtual File System. The configured port defaults to 4022 to prevent any conflict with any existing SSH service that may be running on the underlying operating system, but can be set to any value required.

Files->AS2 Send and receive files using AS2. AS2 is a secure file transfer protocol based on HTTP and S/MIME. See https://en.wikipedia.org/wiki/AS2 for a brief overview of the protocol.

Files->WebDAV Server Allow your users to connect to the Hypersocket server using WebDAV clients to access their files on the Virtual File System.

Files->Google Drive File Resources Connect to Google Drive accounts and grant access to that cloud service’s files via the Virtual File System.

Files->PGP File Transformer Enables PGP based encryption/decryption. This feature can be used either on files at rest (i.e encrypted whilst they are stored on a share) or as the file is being streamed for extra security.

Files->FTP Server Allow your users to connect to the Hypersocket server using either FTP or FTPS clients to access their files on the Virtual File System. FTP is included for backwards compatibility, but FTPS is preferred as it is over an encrypted connection. The configured ports are set by default to 9021 for FTP and 9022 for FTPS to prevent conflicts with any existing servers that may be running on the underlying operating system, but can be configured to any value required.

Files->NFS File Resources Connect to NFS (Network File System) Servers and grant access to that server’s files via the Virtual File System.

Files->WebDAV File Resources Connect to external WebDAV Servers and grant access to that server’s files via the Virtual File System.

Files->Windows File Resources Connect to Windows File Shares and grant access to that server’s files via the Virtual File System.

Files->Dropbox File Resources Connect to Dropbox accounts and grant access to that cloud service’s files via the Virtual File System.

Files->File Sharing Enables options allowing end-users and administrators to share files with anyone with an email address. Options for file sharing start from Quick Sharing a single file up to sharing out whole directories in their own Virtual File System.

Client->Hypersocket Client Support Adds support for the Hypersocket Client. This can be used as a shortcut to launching the web view of your files or to launch a WebDAV connection. The Hypersocket Client method of access is not considered a primary use case for MFT, but if the client is being installed for Hypersocket Prime features such as VPN then it can be useful to use the same client to access your files as well as your other resources.

Setting up Resources

This chapter will give a brief overview of the different resource types and get you started with creating the resources that your users will be

launching.

With Hypersocket MFT there are two types of resources, these are Private Keys and File Resources. The sections below will cover an explanation of these resources and include an example of each to help get you started.

Realms Before any resources are set up, it is worth briefly touching on the subject of Realms. Hypersocket MFT can support multiple User Databases at the same time and each User Database is assigned its own Realm. When you create resources, you create the resource for the realm you are currently managing. This allows you to create separate sets of resources for people on different user databases (and is a good model for a Managed Service Provider environment). For this Getting Started Guide, we have chosen to use the default local user database called System, but in a production environment you will likely have at least two realms (System - where the admin account exists and possibly also an Active Directory). It is important to be aware of which realm you are creating your resources on. When you have more than one realm a new icon appears at the top.

You can click the User Realms button, then select the realm you wish to manage from the list that appears.

At any time, you can see which realm you are currently managing by looking in the footer at the bottom left of the screen.

Here we can see that we are logged in as the admin account and are currently managing the System realm.

File Resources

What is a File Resource? A File Resource provides access to files and folders on the corporate network. Hypersocket MFT supports connections to the following file server types:

Amazon S3

Azure

Dropbox

FTP

FTPS

Google Drive

Local filesystem

NFS

SFTP

Temporary store

WebDAV

WebDAVS

Windows When creating File Resources, you first have to build a Virtual File System and then mount your files into this.

The Virtual File System A file system or share is mounted into a folder, in a very similar way that is done under Linux operating systems. However these folders do not really exist, they are just a way of logically separating and organizing your files, hence the term Virtual File System (or VFS for short). Even though you can mount a file system into the root of the VFS, it is good practice to mount into a virtual folder which can help you keep track of things as an admin and have a logical layout for your end users.

An example file resource configuration This example will walk through setting up access to a Windows Server File Share.

Navigate to the File Resources menu on the left side. You will be presented with a blank Virtual File System page, containing only a root folder, /. First, we shall create a virtual folder that the Windows File System will be mounted in to.

Right click the / folder and select Create Virtual Folder from the menu that appears.

The new folder appears with a default name of untitled folder. Right click this new folder and click Rename. For this example, we will name the folder windows. Now right click the windows folder and this time click Mount Files.

In the window that appears, give this resource a Name. This name is to help you as an admin. Your users in most cases will see the name of the virtual folder we just created instead. Change the Scheme to Windows, then type in the Server address.

In the Path section, type in the windows share name.

Click on the Credentials tab. We can pass the Hypersocket user’s own credentials here by clicking the ${} button next to Username and select ${principalName}.

Do the same for Password, selecting ${password}.

As we have not created any specific Roles for this Getting Started Guide, type in Everyone into the highlighted box. As you start typing, the role should appear in a selector box. Click the role then press Enter. Everyone should now appear in the list below. Click Create to finish creating the resource.

Your share is then visible in the VFS view. You may continue this process to add more file systems to the VFS. Here we have added an SFTP server in another virtual folder.

Installing the Hypersocket Client

This brief chapter provides links to separate articles relating to installation of the Hypersocket Client, which can be used for launching resources.

Windows (32 or 64 bit): https://support.hypersocket.com/hc/en-us/articles/203057549 OS X: https://support.hypersocket.com/hc/en-us/articles/205652233 Linux (DEB): https://support.hypersocket.com/hc/en-us/articles/207305343 Linux (RPM): https://support.hypersocket.com/hc/en-us/articles/115000387804 Linux/Unix (SH script): https://support.hypersocket.com/hc/en-us/articles/115000374910

Launching/Accessing Resources

Web GUI The first method through which users can access their files is via the Web GUI.

When a user logs on to the web GUI, when they click on My Resources in the left menu they are able to see what resources they have available. The user can interact with the VFS directly from this view.

The user can navigate through the file system, upload and download files as well as rename, delete and create new folders. Uploads can be dragged and dropped into the widget at the top.

When you are inside one of the file mounts, you will see a green gears icon, which gives access to other options, such as downloading as a zip file. Another option is to share a file with another person. Please refer to the separate section below for more on file sharing. The other buttons allow you to delete files, rename files and download the file respectively.

External WebDAV

The WebDAV protocol can also be used manually to connect an external WebDAV client of your choice to the Hypersocket MFT. We shall use the Cyberduck client as an example here. Launch Cyberduck then click Open Connection. Change the first dropdown to read WebDAV (HTTP/SSL). Type in the MFT hostname, then the MFT user’s username and password. For the Path, type in hypersocket/fs.

You can also connect directly to a file system by also typing in the virtual folder name. e.g. hypersocket/fs/windows.

Click Connect. You are then presented with the virtual file system and any files that were mounted in to it.

FTP(S)/SFTP access Your users can also access their files via FTP, FTPS or SFTP as long as the correct extensions are installed and configured.

Navigate to Extensions in the left hand menu, then click Extensions again in the top menu. If FTP Server or SFTP Server are not in the Installed list, click on the Available tab then download the extensions.

Navigate to System Configuration in the top navbar, then Interfaces and click on the FTP tab to see the configurable FTP server options such as if it is enabled, the port number etc. Edit and change these as required then click Apply to save any changes.

To avoid any port number conflicts, the FTP service defaults to port 9021 and FTPS defaults to 9022.

For SFTP settings, stay in the Interfaces section then click the SSH tab. Click the Edit button next to Default SSH.

Many SSH related settings can be altered here such as the SSH algorithms and protocols, as well as the port that the SSH/SFTP service runs on, which defaults to port 4022 to avoid any local conflicts. Alter any settings as required and click Update to save.

Here’s an example of a user connecting to the Hypersocket MFT using a standard SFTP client (in this case Filezilla on Windows).

File Sharing

Share settings To start sharing files with Hypersocket MFT, the File Resource you want to share from first has to be configured to allow sharing.

As the admin account, navigate to File Resources and right click on the File Resource you want to configure. Click the Update menu to enter the configuration.

Turn the Sharing slider to ON then click Update to enable file sharing. You can limit the maximum size of a shared file in the Size Limit section if required. If you choose the Sandbox Files option, then shared files are copied off the target file system and shared directly from the local MFT server. There are benefits to this option, as described below:

Sandbox benefits

If the file is deleted from the target server before the share expires, the file is still available for the people you have shared it with.

You do not need to provide credentials for the server to access the target server for the file if your file resource was set up to access via user’s own credentials.

Sandbox disadvantages

As files are stored on the MFT server, you may run out of storage space if a lot of files are being shared.

The last 2 settings, Service Username and Service Password are for overriding the file resource credentials if your file resource was set up to access via user’s own credentials.

Quick Share Firstly, if you want users to be able to share files or folders then they need to be a member of a Role that contains the relevant permission.

Navigate to Access Control->Roles and edit a Role, then click on the Permissions tab. Find the Share Files permission in the top Excluded section and click the down arrow button to include the new permission. Click Update.

When a user navigates to My Resources->My Files and then into one of the virtual folders, click the green gears icon next to any item (files or folders) and select the Quick Share option.

Now enter the email address of the person you want to share the file with. Change the slider to the number of days you want to share for then click Share.

After the Share button has been clicked, Hypersocket MFT will create a user account with that email address if it does not already exist on the system. It will then email that user to inform them that their account has been created, followed by another email to inform the user that they have had a file shared with them.

Now from that new user’s point of view, when they log in for the first time they will be prompted to change their password. So change the password and confirm then click Logon.

The user now has access to their shared files. Note that in this view, Folders can only be downloaded as a Zip file. In order to get access to individual files in the folder, Quick Share cannot be used. A File Resource of the type Sharing needs to be set up, see below.

Full Sharing Hypersocket also has a more fully featured sharing dialog available. Quick Share works really well for single files or folders, but if you wanted to share several different files or folders to several users, then the full sharing feature should be used. Quick Share is also based around sharing files with external users and creating guest accounts for accessing the files. With full sharing, you can share with guests as well as any of your existing users.

As a user with the Share Files permission, navigate to My Resources->My Files. Click the Sharing icon next to the Search box.

On the Create File Share window that pops up, enter a name for the new share. In Shared Paths, start typing the path to the folder or file you wish to share, autocomplete selections should appear as you type, which can be clicked on.

Click the + button to add the selection to the shared list. Multiple paths or files can be added in one share.

In the Options tab, anonymous access via a URL can be granted by turning on Direct Access. You can also choose to Notify the sharer on file access and set an Expiry date for the share here too.

In the Guests tab you can share with any number of temporary guest users by typing their name and email address then clicking the + button. This is the same functionality as the Quick Share feature.

Finally in the Roles tab, you can choose which existing user Roles to share with by typing in the name of the Role and pressing Enter. Click Create to complete the file share.

Sharing File System If you want to allow users to access individual files in any shared folders, you must set up a Sharing File Resource. This type of resource can also be used as a more convenient method of grouping together all files that have been shared with a user into one easily navigable Virtual File System.

Create a new virtual folder and rename it (in this example to share). Right click the folder and select Mount Files.

Give the resource a name and change the Scheme to Sharing. Click on Roles and add the Guest Role (all users automatically created via file sharing are guest users) and click Create.

Now when your guest user accesses My Resources they will now see a My Files section as well as the File Shares that we saw previously. To the left is the File Shares view that a user sees. Note that the Folder can only be downloaded.

And here are the same files as shown in the Sharing File system view. For every time a Quick Share was done, the Sharing File system creates a top level directory in the VFS for the file or folder that was shared.

The user can navigate through the folder structure into the folder that was shared with them.

Message Templates For messaging to work for file sharing, it is important to have the outbound SMTP server details configured correctly. You can find these settings at Messages->Settings, in the STMP tab. Configure your SMTP settings then click Apply to save the changes.

If you want to change the contents of the emails which are sent out during the guest account creation and file sharing, navigate to Messages. Here you can edit the messages to contain the information you want to send out.

Troubleshooting

Connection is not private/certificate errors If you chose to skip step 5 of the setup wizard, then Hypersocket MFT installs a self-signed localhost SSL certificate. Web browsers will correctly flag this certificate as untrusted. The resolution is purchase and install a signed SSL certificate from a Certificate Authority, please see the full administrator guide for more details. Note: you will likely also have problems connecting natively to WebDAV file shares with a self-signed certificate. The resolution is the same as above.

Cannot connect to the Web UI When you start up the Virtual Machine, if you cannot connect to the web UI, here are a couple of things to look at:

Has the service started? Look at the console of the VM, where you will find VMCentre running. Click on the Gear icon on the left hand side, then scroll down to the bottom of the page. If the Hypersocket One service is running, there will only be a Stop button. If the button says Start, click it.

Check firewall port forwarding If you have followed this guide, Hypersocket MFT will be listening for connections on port 443. Double check the port forwarding rules on your firewall to ensure that it is passing data on this port through to the Hypersocket MFT server. If you chose not to forward the optional port 80, then double check you are trying to access the server with https:// rather than http://.

Cannot connect to FTP or SFTP

The first thing to check is by navigating to the Dashboard in the Web UI. On the right side of the page is a service status. If the required service is red there is a problem with the configuration of this service. Most notably, the SFTP service may be conflicting with the Linux operating system’s SSH service. The quick fix for this is to edit the SFTP config and change the port number.

Check firewall port forwarding If everything is green, again check your firewall port forwarding rules. SFTP defaults to port 22 FTP defaults to port 21 SFTP defaults to port 990

I have a problem but it’s not answered here If your problem is not covered by this troubleshooting guide or you need more information or advice about anything to do with the Hypersocket MFT product, there are many troubleshooting articles available on our Knowledgebase, which you can find here: https://support.hypersocket.com/hc/en-us If you cannot find your answer there, please contact our support team by email at support@hypersocket.com