Introduction

Wellhub is a SaaS platform that enables companies to provide a well-being benefit to their employees. As a business-to-business company, Wellhub provides services to subscribing companies and limits access to its platform to its clients’ employees and their family members. This model requires Wellhub to validate that people accessing the platform are employees of a subscribing company. It also allows Wellhub to work with the companies to set up employee payments through payroll deductions, much like other benefits that employees may use. While Wellhub has implemented a number of options for handling these processes, the most commonly used options take advantage of simple file exchanges.

For Eligibility management, Wellhub receives an Eligibility File from the company. This file contains a minimal set of information that allows Wellhub to validate users and provide a number of communication and reporting services to the company.

For Payroll deductions, Wellhub provides a standard Deduction File containing the information required to deduct amounts owed to Wellhub based on employees’ use of the Wellhub plans.

For Reporting, Wellhub provides a set of reports to monitor the usage of the benefit by the client’s employees, including data from the last 12 months (D-2).

These are the detailed flows available per entity type: NOTE: SEs - single entity; MEs - multi entity; CPs - channel partners.

Wellhub supports SSH File Transfer Protocol (SFTP) to ensure security in these file exchanges. SFTP uses the Secure Shell (SSH) network protocol and public/private key pairs to enforce security.

General Information

Connection settings

• Host: sftp.clients.wellhub.com
• Port: 443

Limits

Authentication

To interact with the SFTP Server, you'll need to generate an SSH key in your computer and create an SSH user in the Wellhub Clients Portal , and once that is done, you'll then need to register your SSH public key in the Wellhub Clients Portal.

Generate an SSH Key

You can generate a new SSH key on your local machine.

1. Open a Terminal and paste the text below, replacing the email "your_email@example.com" used in the example with your email address.

Terminal
1ssh-keygen -t ed25519 -C "your_email@example.com"

Note: When executing this command, the SSH key generator will ask for information such as where to save the new key and whether or not it should have a passphrase.
If you have any doubts during this process, refer to this step-by-step guide from GitHub.

Create an SSH User

With an SSH key in hand, access the Portal using your Wellhub account.

The process for creating a new SSH user is the same, regardless of the type of management of your Wellhub account.

1. Just make sure to correctly select which entity you want to manage through the SFTP Server, that is, just one company (through Single Entity) or multiple companies (All companies access for Multi Entity; or Channel partners).

2. In the sidebar menu, click on "Settings," and in the "Automations" section, click on "SFTP".

3. Now, on the SFTP page, click on "Create SSH key".

4. Give a name to this new user, and paste the public key of your new SSH key in the appropriate field.

5. After clicking "Create", you should be able to see your new SSH user listed on the SFTP page.

Accessing the SFTP Server

Before connecting to the SFTP Server, we need the "User name" of an SSH user created in the Portal.
By accessing the Portal and navigating to the SFTP page, we can see all SSH users created to manage this company.

1. Go to the SFTP page (sidebar menu, "Settings," and then "SFTP") in the Portal.

2. Choose an SSH user and click the right arrow icon.

3. In the open drawer, click the "Copy" button or manually copy the "User name" of this SSH user.

Connect to the SFTP Server.

1. Open a Terminal and paste the text below, replacing "your_username" used in the example with the "User name" copied in the previous step.

Terminal
1sftp -P 443 -i ~/.ssh/id_ed25519 your_username@sftp.clients.wellhub.com

The flag -i ~/.ssh/id_ed25519 indicates the location of your SSH key's private key. Change the location if necessary.

2. Upon executing this command, you should see the welcome message from the SFTP Server.