Setting Up Client Applications

You can set up a client application to use the Bounced Mail Framework (BMF). Once you register and configure it, all incoming and outgoing mail messages are controlled by the BMF in the way that you have defined:

• The BMF may check outgoing and incoming mails for trusted or suspended addresses
• The BMF may compare incoming message identifications to outgoing ones to find a rejection reason based on a set of predefined patterns.
• The BMF may execute a required action group once the rejection reason has been identified.

Adding Client Applications

1. In the Administration workset, navigate to Administer Bounced Mail Framework → Clients and choose Add.
2. Enter the application name.
3. Enter the e-mail address of the client application administrator.
4. Configure the following options, if required:
   • Format Mails

     Enable this option if you want to receive HTML-formatted mails. Otherwise, all HTML-formatted mails are received in plain text.

   • Add Mail Message ID in the 'From' Header

     Enable this option if you want the BMF to add an automatically generated ID to the From header for each sent mail.

   • Add Mail Message ID in the Subject

     Enable this option if you want the BMF to add an automatically generated ID to the Subject field for each sent mail.

   • Filter Received Mail

     Enable this option to filter incoming mail. Only mails from trusted addresses are passed to client applications. If the address of the received e-mail message is not in the trusted list, BMF sends a notification message to the client application administrator.

     If incoming filtering is not enabled, all incoming mails are permitted.

   • Filter Sent Mail

     Enable this option to filter outgoing mail. Only mails from trusted addresses are sent. If outgoing filtering is not enabled, the BMF sends all outgoing mails.

     Caution

     To use the features of the BMF, enable at least one of the Add mail message ID options.

5. Enter a client identification.

   You can choose one of the following ways to register your application:

   • With an Auto-Generated ID
   • With a Custom ID You Entered

If you have enabled automatic registration of the client applications, this field is disabled.

More information: Administering the Bounced Mail Framework

1. Choose Save.
2. To edit or delete an application, select the application from the list and choose Edit or Remove respectively.

Viewing Client Application Status

Each client application appears in the list with the initial status Unregistered. Unregistered applications are not able to send mails through the BMF.

In the event of problems with mail retrieval, the status of the iForms Processor client changes from Registered to Error. You can see the error details by choosing Show Exception Details. To restore the client to status Registered, choose Register.

Configuring Client Application Settings

For each client application you select from the BMF Clients list, you can choose Settings and do the following:

• Set lists with trusted and suspended addresses

  More information: Managing Trusted and Suspended Addresses

• Define action groups

  More information: Managing Actions and Action Groups

• Define patterns

  More information: Setting Up Client Application Patterns

• Monitor sent and unrecognized mail messages

  More information:

  Viewing Sent Mail Messages

  Viewing Unrecognized Mail Messages

• Configure SMTP server and mail transport protocol settings

  This setting is required if BMF is going to send outbound mails to clients.

  1. Open the Mail Sending tab page.
  2. Enter the name or IP address of the SMTP server, for example, mail.mycompany.com or 127.0.0.1.
     • Select the protocol you want to use.

       The default protocol is smtp . In case you want to send secure mails, select smtps .

     • In case of smtps , provide user credentials.
       Note

       You can test SMTP server and protocol settings by choosing Test. Make sure that you have entered the client administrator's mail and the BMF administrator's mail in advance.

       More information: Administering the Bounced Mail Framework

• The BMF can filter and manage your client applications mails.
• You can do the following:

• Change the client application settings as required
• Clean up BMF messages that you no longer need

  More information: Cleaning Up the BMF Database

• View statistics for client application mails

  More information: Viewing Statistics