SFTP

​

Overview

Secure File Transfer Protocol (SFTP) is a network protocol for securely accessing, transferring, and managing large files and sensitive data over any reliable data stream. Designed by the Internet Engineering Task Force as an extension of Secure Shell (SSH) version 2.0, SFTP provides secure file transfer capabilities.

​

How Does MoEngage Work with SFTP?

MoEngage allows customers to automatically import users and events from their SFTP servers and export events from MoEngage through flat files. Integration with SFTP servers allows MoEngage to:

• Share periodic exports of campaign interaction events in JSON format.
• Support for Username + Password and Username + SSH Key auth.
• Support for hosts Virtual Private Cloud (VPC) or private endpoints.

You can export all user and campaign events created, received, or generated by MoEngage to your SFTP servers. By performing this, you can analyze the exported data to gather insights into user behavior, preferences, and other related issues.

​

Integration

​

Configure a New SFTP Connection

To import data from or export data to SFTP servers, you must configure a connection between MoEngage and your SFTP server. To create a new SFTP connection, perform the following steps:

1. On the left navigation menu on the MoEngage UI, click App marketplace.
2. On the App marketplace page, in the search bar, type SFTP.
3. Click the SFTP tile. The SFTP page appears.
4. Go to the Integrate tab, and then click + Add connection.
5. In the Connection details section, enter the following details:

   Field	Description	Example
   Connection Name	Specifies the identifiable name of the connection.	SFTP Connection
   Host	Enter the hostname that you want to connect to.	128.0.0.0 or ftp.moengage.com
   Port	Enter or select the port to which you want to connect your SFTP server. Valid ports range from 1 to 65535. The default port is 22.	22
   Username	Enter the username for the SFTP connection. You can enter an existing user with read and write access or create a new one for MoEngage.	John Doe
   Authentication Method	You must select one of the following methods for MoEngage to connect to your SFTP server: Password: Enter the password of the SFTP user (username) in the Password box. Key: MoEngage connects to your SFTP server using the key pair authentication method. You must use this option to generate a key. For more information, refer to Manage Your SFTP Key (Key Rotation). 2FA (Both): MoEngage attempts to connect using both Password and Key authentication. The connection proceeds successfully if either the password or the key matches; it does not perform a strict check requiring both. For Key and 2FA (Both) authentication: Select Key or 2FA (Both) as your Authentication method. Click the Generate Key icon , and MoEngage displays your public key. You must add this public key to your SFTP server. For more information, refer to How to add a new SSH key to a cloud server (unverified public article). Note: The key generated is a public key. For 2FA (Both), you must enter the Password and generate/use the Key.	Password / Key / 2FA (Both)

6. You can click Test connect to verify the credentials and test your details before saving the connection. When you’re ready, click Connect to save the connection and proceed.
   If you generate a new key for rotation, you must test the connection successfully to complete the rotation, or MoEngage will continue using the old Key.

After the connection between MoEngage and your SFTP server is successful, you can use it to configure various imports and exports in MoEngage.

​

Manage Your SFTP Key (Key Rotation)

MoEngage also supports key rotation. If your IT policy requires you to rotate the keys, you can do it by performing the following steps:

1. Go to the App marketplace > SFTP > Integrate and edit the connection.
2. Click the Generate new key icon . The Generate a new key pop-up window appears, prompting you to review the instructions. Note: Read the instructions carefully. After you save the connection with the newly generated key, MoEngage will no longer use the previous key. You must ensure that the new key is added to your SFTP server so the rotation works properly. If the new key is not added after saving the connection, your imports and exports might break.
3. Click Generate new key. After MoEngage successfully generates the key, a confirmation message is displayed. MoEngage highly recommends that you copy this new key using the icon and attach it as an additional key to your SFTP server. You can also download the key using the icon. After attaching the new key, you must test the connection successfully to complete the rotation. Note: If you generate a new key for rotation, you must test the connection successfully to complete the rotation, or MoEngage will continue using the old key.

​

Set Up Imports from SFTP

MoEngage allows customers to import users and events through files stored inside your SFTP folders. For more information, refer to SFTP Imports.

​

Set Up Exports to SFTP

MoEngage exports campaign interaction events to your SFTP server as flat files. For more information, refer to SFTP Exports.