Before starting
SFTP/FTPS management is centralized in a single module and available from Lucca administration ⚙. This help sheet describes the various features of this module, and outlines what to look for if you wish to modify certain settings.
You can find our SFTP/FTPS server FAQ here.
SFTP/FTPS: what is it?
SFTP/FTPS (file transfer protocol) is a protocol used to transfer files between two systems. In Lucca, SFTP/FTPS is set up to automate file transfer between Lucca and external software (e.g. exporting absences to payroll), or between external software and Lucca (e.g. automatic import of users into Lucca from payroll).
Important vocabulary
- Connection type : SFTP, FTPS FTPES. These are the different protocols managed by Lucca. SFTP or FTPS are preferred, but this depends on your ecosystem.
- Account: an SFTP/FTPS account corresponds to an access to a server. It consists of a name, login, password, host and the types of connections authorized. One or more accounts can be created for each instance.
- Remote folder (or path): a remote folder corresponds to a folder on the server. This is where the files will be stored. An account is comprised of one or more remote folders. A remote folder corresponds to a name (for easy retrieval in Lucca), and a "path".
- The path is the address of the remote folder on the server. It takes the format of /folder1/folder2/folder3, for example. If this remote folder is selected, then the file will be dropped into folder 3 (which is located in folder 2, which is located in folder 1) on the SFTP/FTPS server.
Setting up an SFTP/FTPS
Creating an account
To set up a new SFTP/FTPS account on your instance, go to the SFTP/FTPS management module (⚙ -> Other settings > SFTP/FTPS).
In this module, click on "Create an account". A window opens and you need to enter the details of the account you are creating. First, you need to select the host server from the following choices:
- Lucca: server hosted by Lucca without any special configuration
- E-paye: server hosted by Lucca with e-paye-specific settings (when rolling out e-paye clients)
- MPRH: server hosted by Lucca with MPRH specific settings (in cases of MPRH client rollout)
- Client server: server hosted by you. You will then have to fill in the server information.
SFTP/FTPS server hosted by Lucca
You need to name this account so that it can be easily identified in the list of accounts available on your instance.
Server not hosted by Lucca
You need to name this account so that it can be easily identified in the list of accounts available on your instance. Next, enter the host name and connection type.
Once this step has been validated, you need to enter your login and password (or RSA key, depending on your connection type and authentication method).
Adding remote folders
Once an account has been created, you can add remote folders to this account. These will be the folders where the various files to be integrated will be uploaded, either in Lucca or from Lucca. Click on the three dots next to the account, then on "Edit remote folders".
A window will open, allowing you to create the various remote folders required for integrations. You need to enter the name of the remote folder (to find it easily in the list later), and the path.
Updating an existing SFTP/FTPS server
You can update the account name, login and password for a server hosted by Lucca, as well as the host and connection type for a server hosted by you.
To do this, click on the three small dots next to the account name, then "Edit account". On the window that appears, you will see 2 "edit" buttons to perform your update.