Configure a SMTP and IMAP Relay (Mailbox Configuration)

The following section describes how to configure a SMTP for sending emails and IMAP for receiving and automatic processing provider in OpenIAM. It is called 'Mailbox Configuration' in OpenIAM. This step is a pre-requisite for sending out email notifications, one-time links for password reset, and one time passwords (OTP).

To configure your Mailbox, follow the steps described below:

• Login to the Webconsole
• Go to Administration -> Mailbox configuration.

You will be redirected to the page with list of the predefined Mailbox Configurations. By default, there will be configuration related to the previously installed OpenIAM version or configuration related to the previous "System configuration" -> "SMTP Gateway" page.

On the left menu there are 4 options are available for the 'Super Security Admin' Role members.

There are:

• Create Mailbox Configuration Template
• Create Mailbox Configuration
• Mailbox Configuration Templates
• Mailbox Configurations

Mailbox Configurations

The default page which displays the list of all Mailbox Configurations available in the system. It is possible to search configurations by name using Search for Mailbox Configuration input.

Mailbox Configuration Templates

The page which displays the list of all possible Mailbox Configuration Templates available in the system.

There are 5 default templates, available in the system:

Create Mailbox Configuration Template

This page allows you to create new mailbox configuration template to connect with SMTP/IMAP Relay different from presented by default.

Fill the fields based on the settings provided by your SMTP/IMAP template configuration

The same page is displayed to edit mailbox Configuration Template as well. To delete the Template please be sure that there isn't any linked to it Mailbox Configurations, otherwise system will throw an error:

"Mailbox Configuration Template hasn't been deleted successfully because there are configurations which are related to it. Please delete Mailbox Configurations, related to the current Mailbox Configuration config firstly."

Create Mailbox Configuration

This page allows you to create new mailbox configuration to send emails from the Installation using SMTP and receive an emails for automatic processing.

Fill the fields based on the settings provided by your SMTP/IMAP template configuration

In case of multiple active mailbox configurations the round-robin algorithm will be applied to them, however active mailbox configurations that are set as failover for others will be called only in case of the failure of the 'main' mailbox configuration.

Customize MimeMessage messages

When creating or editing mailbox configuration, user can customiza a mail message by means of a groovy script. It can add custom attributes to header, subject, sender, date, and many more.

To customize message, do the following.

1. Login to webconsole and got to Administration -> Mailbox Configurations.
2. Select the configuration required and click edit or create a new configuration if needed.
3. Fill in all the fields as specified above, and in Script to customize MimeMessage message field specify the path to a groovy script. Note: The field is empty by default.
4. Click save.

The example of a groovy script to be used for this feature is given below.

package org.openiam.sync;
import org.openiam.am.srvc.groovy.CustomMailConfigHelper;
import javax.mail.internet.MimeMessage;

/**
* Class used for customizing email message configuration.
*/
class CustomizeMail implements CustomMailConfigHelper {

    public void customizeMessage(MimeMessage message) {
        // Example custom headers can be added to the message
        message.setHeader("testHeader1", "testHeaderValue2");
        message.setHeader("testHeader2","testHeaderValue2");

        // Set the sender (From) address
        message.setFrom("sender@example.com");

         // Set the subject
        message.setSubject("Your subject here");

        // Set the body text
        message.setText("Your message body here");

        // Set the priority of the message
        message.setHeader("X-Priority", "1"); // Highest priority

        // Set the date of the message
        message.setSentDate(new Date());
    }

}

Understanding Mailbox-configuration rotation

Let's review the following mailboxes set:

In case of the example above:

The round-robin algorithm will be applied to rotate the Mailbox configurations: MB2 and MB4, because they are active, and they are not set up as a failover configurations to others. MB1 is inactive, MB3 is a setup as a failover for MB2, MB5 is set as a failover for MB1. MB5 will be called in case of failure of MB1, MB3 will be called in case of failure of MB2 even in case MB3 is Inactive.