regions messenger ftp user guide

Regions Bank | Member FDICRevised 031513

It’s time to expect more.

FTP User Guide

Regions Messenger

Regions Messenger FTP User Guide 1

MESSENGER FTP — A COMPLETE SOLUTION The FTP channel is an efficient method for delivering high volumes of data. It leverages the Internet to deliver and receive information, and supports defined file naming conventions. To ensure data security and integrity, FTP software that includes a PGP file encryption key is required. You can use your own FTP software for interfacing with the FTP channel. Information that can be securely downloaded includes: Previous Day Report Current Day Report Intraday Report Automatic download of data in BAI format Treasury Management Client

TABLE OF CONTENTS System Requirements ................................................................................................ 2

Internet Connection ................................................................................................ 2 FTP Software with PGP Encryption ......................................................................... 2

PGP Encryption Setup for FTP Pickup........................................................................ 4 PGP Encryption Setup for FTP Delivery...................................................................... 5 FTP Client Maintenance.............................................................................................. 8

Setting the Site Parameters..................................................................................... 8

Connecting to the Site .............................................................................................. 11 Moving Files to Your Computer ................................................................................ 11 User Maintenance..................................................................................................... 12

For additional assistance, contact Commercial Client Services at 1-800-787-3905 or [email protected]


SYSTEM REQUIREMENTS

Internet Connection An Internet connection is required. You should consider connection speed as compared to the file size and amount of data transmitted. The more data transmitted, the faster the network connection speed should be which will result in less time online. FTP Software with PGP Encryption The connection of your FTP software with the Regions Messenger FTP Server facilitates the exchange of information. The following screen illustrates an example of FTP software:


The following screen illustrates the FTP Pickup Channel Options screen.

To upload the FTP PGP Certificate:

1. Select Upload New PGP Certificate, which will display the screen below.

2. Paste in the public key and select OK.


PGP ENCRYPTION SETUP FOR FTP PICKUP To ensure data security and integrity, FTP software that includes a PGP Certificate (file encryption key) is required.

Data Field Definition and Usage

Overwrite Files When this Check Box is selected, Regions Messenger will overwrite an existing file with new information if the same file name were to be created. If the box is unchecked, data files will not be overwritten. In this case, if a duplicate file name is encountered, Regions Messenger will ensure uniqueness by adding "_n" to the file name.

Encrypt Files Regions Messenger will encrypt information with your PGP certificate resident in the Current PGP Certificate field. This certificate is your Public PGP Encryption key.

Note: Regions Messenger will place a .pgp suffix on all PGP encrypted files.

Upload New Certificate

Select Upload New PGP Certificate to install a PGP certificate. A new modal window will open to accept the certificate. The window will appear as displayed:

The PGP certificate will be generated from your FTP software. Please follow these steps:

1. Generate the PGP certificate in your FTP software 2. Highlight the PGP certificate and right click and choose copy 3. Open the new PGP certificate window in Messenger 4. Right click on the blank white box and choose paste 5. Click OK

The window will close and messages will be shown at the top of the FTP Pickup Channel Options window indicating the PGP Certificate is valid. A reminder to press the Save option will be displayed.

6. Click Save


PGP ENCRYPTION SETUP FOR FTP DELIVERY The following screen is an example of the FTP Delivery Channel Options screen.

Data Field Definition and Usage

Name* The Name field is a text box that lets you give the FTP destination a distinguishing name value. A data value for this field is required.

Host URL* The Host URL is the site address for your FTP server. The value can be entered in URL format (server.domain.com) or IP Address format (123.45.67.890). A data value for this field is required.

User Name* The user name you establish for Regions Messenger to authenticate a login into your FTP Server. A data value for this field is required.

User Password* The password associated with the user name you establish for Messenger to authenticate a login into your FTP Server. A data value for this field is required.

Directory The directory or folder into which Regions Messenger is to deposit files on your FTP server. A data value for this field is optional. If no value is supplied, Messenger will deposit the file in the FTP server’s current directory after the login process is completed.

File Name Macro*

The File Name Macro is a way to define and customize file names for the information received with FTP. By entering a series of text characters and special macro characters, a naming convention for these files can be defined. This naming convention will help identify and manage your data.

When you define a file name for FTP channel information, the acceptable file name characters are the basic alpha-numeric characters (a-z and 0-9), the hyphen (-), plus the underscore (_).


The FTP channel File Name also provides Macros as a way to insert variable data into the file name. The table below shows the macros available to you. To use a macro, enter the macro surrounded by the percent sign (%) in the File Name Macro text box. Macros are not case-sensitive and may be entered in either upper and/or lower case characters. Please note, however, since MM is used for both month and minute, lower-case mm indicates month and upper-case MM identifies minute.

Macro Description

%SERVICE% The Service name. Service names with multiple words will contain an underscore. (Example: Sunrise_Report)

%TEMPLATENAME% The name of the template creating this file. (Example template name: PDTAP2). Note: some services may not use templates, SUNRISE for example.

%FILENAME% The original file name as created by Regions Messenger.

%yyyy% Current Year with century. (YYYY=2005)

%yy% Current Year no century. (YY=05)

%mm% Current Month numeric. (01-12)

%mmm% Current Month 3-character. (JAN-DEC)

%dd% Current Day. (01-31)

%dow% Current Day of Week. (SUN-SAT)

%hh% Current Hour. (00-23)

%MM% Current Minute. (00-59)

%ss% Current Second. (00-59)

NOTE: Regions Messenger’s services create and deliver many different types of data files and will supply an appropriate suffix for the file name. An appropriate suffix is one that can help you identify the type of data contained in the file. For example, image file names may contain a .jpg or .tif suffix, while other files may have a .pdf or .txt suffix to indicate a Portable Document Format file or one that contains ASCII text information.

Encrypt Files When this Check Box is selected, Regions Messenger will encrypt information with your PGP certificate resident in the Current PGP Certificate field. This certificate is your Public PGP Encryption key.

NOTE: While it is a more common practice than an industry requirement, many systems that PGP-encrypt data files will place a .pgp suffix on the file name. Some FTP software will require PGP encrypted files to contain a .pgp suffix in order for the decrypt process to occur automatically. Regions Messenger will place a .pgp suffix on all PGP encrypted files. Therefore, your encrypted file names may appear to have 2 suffixes (i.e. BAI04MAR05.txt.pgp).

Protocol* The type of FTP protocol Messenger will use when connecting to this FTP Destination. The possible values are FTP, EXPLICIT FTPS, IMPLICIT FTPS and SFTP.

Connection Mode*

Connect Mode is an FTP protocol option. The possible values are Active or Passive. Passive mode is recommended as FTP traffic is usually blocked by firewalls unless Passive mode is used.


Transfer Mode* Transfer Mode is an FTP protocol option. The possible values are ASCII or Binary. Binary mode is recommended as encrypted files are binary in format. Note: ASCII armoring and text mode can offset the binary mode recommendation. Please refer to your PGP documentation for more information about these options.


FTP CLIENT MAINTENANCE Regions Messenger is designed for compatibility with many FTP software packages. The example below uses WS_FTP which is a software product developed and marketed by Ipswitch. You should refer to your FTP documentation for assistance in the setup, maintenance and operation of your FTP software. Setting the Site Parameters FTP software allows you to establish the Messenger FTP Server as a site. This process permits you to assign a Company Id, User Id and Password. Step 1: Establish the Site Name:

Click Next.


Step 2: Select FTP as the Connection Type.

Click Next. Step 3: The FTP server address should appear as: ftp://messenger.regions.com.

Click Next.


Step 4: Enter your “User Name” field in the form of CompanyID@userID and your Password, as provided by Regions.

Click Next. Step 5: Save Site information:

Click Finish.


CONNECTING TO THE SITE To establish an FTP session with Regions Messenger, click the Connection Tab and select the site that you created. The FTP software will attempt a connection with Regions Messenger using the server address as defined in the letter from Regions Implementations. If a successful connection is made, the FTP software will submit your User ID and Password credentials to create a login session. Messenger will validate your Company ID, User ID and Password. If the login process is successful, a screen similar to the one below will be displayed:

MOVING FILES TO YOUR COMPUTER The Messenger files are shown in the panel on the right. To download these files to your computer, highlight the files and select the arrow that points to the left panel entitled "My Computer". This will allow the file to be moved from the site to your computer. Note: the FTP protocol and FTP software give you the ability to define the storage folder on your computer or corporate network where files from Regions Messenger are to be stored. Please refer to your FTP documentation for the instruction on choosing your download folder.


USER MAINTENANCE In Customer Setup, you control the access that other users have to the system. To access the system, go to https://messenger.regions.com to log in using the Company ID, User ID and WIKID PIN.

Adding Users

1. Click on the icon and scroll down to Add.


2. Complete the User Profile. Please note that the asterisks indicate required fields.

User ID: Assigned by the person adding the user. First Name*: User's first name. Last Name*: User's last name. Administrative User: If this user is an additional System Administrator, check

the box. Enable Date*: Pre-filled. Desktop Last Login: “Never logged in” is the initial setting. Email Address*: User's email address. Encrypted Report Password*: Leave field blank. The system will automatically

generate after saving. This password will not be used, but is required. Phone Number: User’s phone number Message Enabled Cell Phone: User’s cell phone number Fax Number: User’s fax number Business Unit: User’s business unit. Enter if applicable. Street Address: User’s address City: User’s city State: User’s state Zip Code*: User’s zip code Country: User’s country Time Zone*: Pre-filled, may be changed if different. Language*: Pre-filled, may be changed if different. Advanced: Leave field blank. Password: There are two fields. Enter the password. Password must be

between five and eight characters and must include letters and numbers.

3. Click Save.


Adding Services for the User

1. Under the User heading, click the icon.

2. Place a checkmark in the boxes of all services you wish to assign to this user.

3. Click to save these changes.


Editing/Adding Accounts for the User

1. At the User Service level, select a service to which an account is tied. In this case, the service selected is Previous Day Balance Report.

2. Click the Edit Accounts option for this Service .

3. Place a checkmark in the boxes of all accounts you wish to assign to this user for this service. In the example above, only one account is currently available.

4. Click to retain these changes.


Creating/Editing a Template for the User

1. At the User Service level, select a service to which an account is tied. In this case, the service service selected is Previous Day Balance Report.

2. Click the Edit Service Preferences option for this Service option .

3. From the Template Management screen, select to get started.


4. Each template can be created and customized to your needs. a) Start by creating a template name. This may contain familiar references such

as your name or maybe the particular data contained within this report.


b) Select the account(s) that you would like to receive information about. Click on the drop down menu to find the specific account, or click the Add all link to add all available accounts.

c) Select the Transaction type(s) that should be included in this report. d) Next, select how you would like the report to appear when viewed. e) Select the method of delivery for the report. In this case, the company’s FTP

information has not been entered. Should you encounter a similar issue, contact Regions Commercial Client Services to remedy.

f) If you would like to receive an SMS (text) message to let you know your report is ready, check the SMS box.

g) Some reports have multiple output styles. Select your desired output if more than one is available.

h) Finally, select the frequency in which you would like the report to be delivered.

i) Once you have completed these steps, remember to click the

icon. This will return you to the Template Management screen.

5. To search for a template, if desired, click the selected channel, and choose a specific delivery method. Template search results can also be altered to appear 10, 20 or 50 at a time. Search results may also be sorted by Name or Channel and Ascending or Descending order.

© 2013 Regions Bank. Member FDIC.

This guide is for general informational and reference purposes only and is entirely subject and subordinate to the terms of the respective written agreements for the products and services described above. This guide does not constitute a contract or representation or warranty of any kind, express or implied, nor does it in any way supplement, replace, modify, or amend the terms and provisions of the written agreements that govern the products and services. You should review actual product and service agreements carefully to understand the terms that govern the products and services and the rights, responsibilities, and liabilities of parties thereunder.

regions messenger ftp user guide

Documents