Setting Up Client Applications

Use

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.

Procedure

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.

  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:

Result

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