The Email integration allows you to retrieve email messages from one or more mail servers and send them to Moogsoft Onprem as events.
Refer to the Email LAM Reference to see the integration's default properties.
When you use the integrations UI, you can only configure the visible properties. If you want to implement a more complex Email LAM with custom settings, see Configure the Email LAM.
Important
For Gmail users
As of September 30th, 2024, Google has removed the ability to authenticate Gmail using your native username and password.
If you are using Gmail with your Email integration, you must do the following to ensure that your integration remains functional:
In Moogsoft Onprem, go to the Configure the Email Integration section of the UI.
For the Password field, generate and paste a Google app password in this field instead of your Gmail password.
For detailed instructions on generating an app password, see the Google documentation. You must have two-factor authentication enabled for your Google account in order to enable app passwords.
Before You Begin
Before you set up your Email integration, ensure you have met the following requirements for each mail source:
You know the details of the mail source:
Host name or IP address
Port
Username and password
Name of messages folder
You know the protocol used by your mail server: IMAP, IMAPS, POP3, or POP3S.
The port for your mail server is open and accessible from Moogsoft Onprem.
You know whether the body of the incoming email messages contain JSON.
If you are using the Email integration to connect to Gmail, you must configure the Gmail account to allow access for less secure apps. See the Google Help Center for more information.
Additionally, you can provide optional configuration details. See the Email LAM Reference and LAM and Integration Reference for a description of all properties.
Note
If your mail servers use SSL (POP3 or POP3S protocol) the integration looks for SSL keys and certificates with the default names and locations outlined in the Email LAM Reference. If your details are different, see Configure the Email LAM instead of using the integration.
Configure the Email Integration
To configure the Email integration:
Navigate to the Integrations tab.
Click Email in the Monitoring section.
Provide a unique integration name. You can use the default name or customize the name according to your needs.
Provide connection details for your mail system.
You do not need to perform any integration-specific steps on your email systems. After you configure the integration, it polls your mail servers at regular intervals to collect messages (every 60 seconds by default).