FTP / S3 Profiles

Overview

The FTP / S3 Profiles screen is used for setting up data transfer methods with Engage+.

A common method of getting data into and out of the platform is by way of file transfers using FTP. The platform allows you to set up one or more FTP Profiles that contain the necessary information to connect to the FTP server.

From this same screen, you can also create an S3 Profile for use with an Amazon S3 (Simple Storage Service) Bucket. An Amazon S3 bucket is a public cloud storage resource available in Amazon Web Services. Amazon S3 buckets are similar to file folders, and are used to store data.

FTP and S3 Profiles are reusable, so that they can be selected when defining various other Engage+ assets, such as FTP Import Templates, Export Templates, and Print Campaigns.

Access

The FTP / S3 Profiles screen is accessible by the following method:

Features

 Create an FTP Profile

Click hereClick here

To create a new FTP Profile:

  1. Above the list of existing Profiles, click + New. A blank FTP / S3 Profiles screen is displayed.

  2. Select the "FTP" radio button.

  3. In the "FTP URL" field, enter the URL for the FTP Server. This URL must begin with the prefix "sftp://".

  4. By default, Messaging will attempt to connect to the FTP Server in "active" mode. To instead connect in "passive" mode, place a check mark in the "Passive Mode" check box.

  5. Define an authentication method:

Username / PasswordUsername / Password

To connect via username / password credentials:

    1. Uncheck the "SSH Keys" check box.

    2. In the "User Name" field, enter the username needed to log onto the FTP Server.

    3. Check the "Change Password?" check box.

    4. In the "Password" field, enter the password needed to log onto the FTP server. Enter this password again in the "Confirm Password" field.

SSH KeysSSH Keys

To connect via SSH Keys:

    1. Check the "SSH Keys" check box.

    2. In the "User Name" field, enter the username needed to log onto the FTP Server.

    3. Click choose file, and browse to the location of your SSH private key file.

Note: Passphrase encrypted keys are not supported.

The Cheetah Digital public key is displayed, should you need it. This key can't be edited, but you can copy it.

  1. Click save.

Note: You don't provide a name for an FTP Profile. Instead, the combination of the "FTP URL" and the "User Name" values serves as its name. For example: "sftp://testserver - johnsmith"

 

 View or Edit an FTP Profile

Click hereClick here

To view or edit an FTP Profile:

  1. Search for the desired FTP Profile (see Search for an Item for more details on the available search methods).

  2. Click on the FTP Profile name. The FTP / S3 Profile screen is displayed and populated with the details of the selected FTP Profile.

  3. Optionally, modify the "FTP URL" value.

  4. Optionally, check or uncheck the "Passive Mode" check box.

  5. Optionally, to modify the login credentials, enter a new username in the "User Name" field. To also change the password, place a check mark in the "Change Password?" check box. In the "Password" field, enter the new password. Enter this password again in the "Confirm Password" field.

  6. When finished, click save.

 

 

 Create an S3 Profile

Click hereClick here

To create a new S3 Profile:

  1. Above the list of existing Profiles, click + New button. A blank FTP / S3 Profiles screen is displayed.

  2. Select the "S3" radio button.

  3. In the "Access Key" field, enter your Amazon Web Services access key.

  4. In the "Secret Key" field, enter your Amazon Web Services access secret.

  5. In the "Bucket Name" field, enter your Amazon S3 Bucket. The following rules apply to the Bucket Name:

  • Bucket name must be between 3 and 63 characters long.

  • Bucket name can consist only of lowercase letters, numbers, periods (.), and hyphens (-).

  • Bucket name must begin and end with a letter or number.

  • Bucket name must not be formatted as an IP address (for example, 192.168.5.4).

  • Bucket name must not start with the prefix "xn--."

  • Bucket name must not end with the suffix "-s3alias."

  1. From the "Region" drop-down menu, select the desired AWS Region.

  2. Select "ACLs are Disabled" if Access Control Lists (ACLs) are disabled in your S3 buckets, so that Messaging will automatically add the required parameter to ensure successful exports. All new AWS S3 buckets will have Access Control Lists (ACLs) disabled as a default setting by Amazon Web Services. AWS advises their S3 cloud storage bucket clients to disable ACLs for data security. When ACLs were disabled in S3 buckets, exports from Messaging to S3 buckets could fail.

  3. Click save. The Secret Key field is blanked out after you save.

Note: You don't provide a name for an S3 Profile. Instead, the endpoint serves as its name.

 

 View or Edit an S3 Profile

Click hereClick here

To view or edit an S3 Profile:

  1. Search for the desired S3 Profile (see Search for an Item for more details on the available search methods).

  2. Click on the S3 Profile name. The FTP / S3 Profile screen is displayed and populated with the details of the selected S3 Profile.

  3. Make any necessary changes to the S3 Profile settings.

  4. When finished, click save.