Fortinet white logo
Fortinet white logo

SMTP Connector v2.4.3

Overview

FortiSOAR™ provides you with a number of pre-installed connectors or built-ins, such as the SMTP or Database connectors that you can use within FortiSOAR™ playbooks, as a connector step, and perform automated operations. These connectors are bundled and named based on the type of operations the connectors can perform. For example, the Database connector would contain actions that you can perform with respect to the database like querying the database. It is easy to extend and enhance these connectors.

Apart from the FortiSOAR™ Built-in connectors, Fortinet also provides a number of connectors for popular integrations like SIEMs, such as FortiSIEM, Splunk, etc., and Ticketing systems such as Jira. You can see a list of published connectors on the FortiSOAR Connectors Documentation site.

The process of installing, configuring, and using connectors is defined in the Introduction to connectors chapter in the "Connectors Guide", which is part of the FortiSOAR™ documentation or see the Installing a connector and Configuring a connector articles.

FortiSOAR™ Built-in connectors are upgraded by default with a FortiSOAR™ upgrade. Use the Content Hub to upgrade your connectors to the latest version. For more information on the connector store, see the Introduction to connectors chapter and see the FortiSOAR Built-in connectors article.

Important: Before you upgrade your FortiSOAR™ version, it is highly recommended that you take a backup of your FortiSOAR™ Built-in connector's (SSH, IMAP, Database, etc.) configuration since the configuration of your FortiSOAR™ Built-in connectors might be reset if there are changes to the configuration parameters across versions.

SMTP

Use this connector to set up SMTP for sending system notifications, including requests for resetting passwords, and also for sending emails outside FortiSOAR™. When you configure the SMTP connector, you must ensure that the Mark As Default Configuration option for the configuration that is to be used for sending system notifications is selected.

You can send emails to 30 most recently created FortiSOAR™-teams or users by selecting teams or users from a pre-populated drop-down list using the Recipient Type drop-down list.

If you select Manual Input from the Recipient Type drop-down list, then you can specify a comma-separated list of email addresses, including email addresses of non-FortiSOAR™ users. However, you can also specify the IRI values for users and/or teams, which allows users to reuse team or user information defined in previous playbook steps as Jinja statements.

If you select Team from the Recipient Type drop-down list, then you can send emails by selecting existing FortiSOAR™ teams from the pre-populated To, CC, or BCC multi-select fields, which enables users to dynamically leverage the email ID which has already been provided in a team record, and the email can be sent to all the members of the team at once.


If you select User from the Recipient Type drop-down list, then you can send emails by selecting existing FortiSOAR™ users from the pre-populated To, CC, or BCC multi-select fields, which enables users to dynamically leverage the email ID which has already been provided in a user record. So now you have the ability to interchangeably send emails in multiple formats by specifying a comma-separated list of email addresses or selecting FortiSOAR™-teams or users, or by reusing team or user information defined in previous playbook steps as Jinja statements.

You can pass an existing email template as an input for the email subject and body (content) allowing you to leverage an existing email template and build upon it, thereby, avoiding re-work and ensuring consistency. The Send Email step contains a Body Type drop-down list from which you can choose whether you want to send a plain text email (Plain Text), rich text email (Rich Text), or an email based on a template (Email Template).

If you select Rich Text from the Body Type drop-down list, then in the Content field, you can add formatted content, images, and even custom jinja expressions using Dynamic Values:
If you select Email Template from the Body Type drop-down list, the Email Template drop-down list is displayed, using which you can select the template that you want to use to send the email:

SMTP Connector Release Notes

Version 2.4.3

  • Enhanced the SMTP connector to make the 'Timeout' field on the Configuration page a mandatory parameter. In earlier versions of this connector the Timeout field was optional; however, if you did not specify a value for this parameter, the connector health check would fail even if all the other configuration parameters had correct values.
  • Renamed the previous "Send Email" action to "Send Email (Advanced)". Using this action, you can send emails using both Jinja and Email Templates.
  • Added a new action "Send Email", using which you can send emails using Dynamic Values but not Email Templates.
  • Removed the "Send Email (Deprecated)" action.

Version 2.4.2

  • Fixed a bug with the SMTP connector that caused the 'Send Email' step to not send the notify users' email, if one of the emails specified is invalid, i.e., the notification email is not sent to the rest of the valid email addresses. This can happen in the case of system playbooks such as the approval system playbooks that require emails to be sent to intended users or teams for approval. Now, even if one of the email addresses specified is invalid the notification email will be sent to the rest of the valid email addresses.

Version 2.4.1

  • Fixed a bug with the SMTP connector that caused the 'Send Email' step to send emails to all the users, even when specific teams were assigned to receive the email. Now, if you have assigned teams (by specifying the team IRIs) to receive an email, then the email is sent to only the users of the assigned teams.

Version 2.4.0

  • Enhanced to support the "HTML Editor" when users select the Body Type of the email as "Rich Text", i.e., you can add formatted content, including adding media, links, attachments, etc. to the content of the email and this content will render as HTML. This version has also added support for adding new lines while entering email content when users select Plain Text as the "Body Type". Now, the Plain Text field is of type "Text Area", which enables users to add new lines.

Version 2.3.3

  • Fixed a bug in the "Send Mail" operation, which did not delete the attachment that is downloaded to the /tmp directory once the playbook completes its execution. Now, when in the "Send Mail" operation the user provides an "Attachment IRI", then the attachment is downloaded from FortiSOAR™ and is saved in the /tmp directory, which will now be deleted once the playbook completes its execution.

Version 2.3.2

  • Updated the branding for the SMTP connector such as updating the connector publisher to "Fortinet" and updating the names, descriptions, and action names of playbooks based on the branding changes. Names of fields within actions have also been changed to match the branding changes. For example, the "CyOPs Attachment IRI List" field has been renamed to "Attachment IRI List".

Version 2.3.1

Contains an updated logo.

Version 2.3.0

  • The CyOPs Attachment IRI List field in which you could include attachments in the email, required you to specify an array of FortiSOAR™ IRIs (file or attachment IRIs) of attachments. Now, you can specify a comma-separated list of FortiSOAR™ IRIs.
  • User list now contains the complete list of users, earlier it used to only contain the first 30 users.
  • Jinja specified in the Subject field now gets parsed correctly.
  • The From field will now appear blank.
  • An enhanced logo for the "SMTP" connector.

Version 2.2.0

  • The ability to send emails to 30 most recently created FortiSOAR™-teams or users by selecting teams or users from a pre-populated drop-down list using the Recipient Type drop-down list.
  • Support for specifying the IRI values for users and/or teams, allowing users to reuse team or user information defined in previous playbook steps as Jinja statements if you have selected Manual Input from the Recipient Type drop-down list. You can also specify a comma-separated list of email addresses (which is what was followed in the earlier versions) so that users can continue to use this behavior and also send emails to non-FortiSOAR™ users.
  • The ability to pass an existing email template as an input for the email subject and body (content) using the new "Send Email" action.

Version 2.1.2

  • Fixed important bugs and also contains enhancements, such as adding support for file attachments in the "Send Email" function.

SOAP Connector Release Notes

Version 2.4.0

  • Adds support for the 'File' type input in the 'SOAP Call' action. In this case, the WSDL that accepts the input type as 'file' is displayed and the input for the same is accepted as the IRI value of the file or attachment.

Version 2.3.0

This version contains a full-fledged SOAP client that reads WSDL from the configuration and populates the list of actions and all the required/optional inputs from WSDL. Therefore, now you can use the newly added SOAP Call action to integrate SOAP web services with FortiSOAR™. For more information, see the SOAP section.

Version 2.2.1

  • Includes the corrected and updated logo.

Version 2.1.0

  • Includes an enhanced logo for the "SOAP" connector.

SSH Connector Release Notes

Version 2.1.1

  • Includes an updated logo.

Version 2.1.0

  • Fixed the issue of the health check not working for this connector. For example, the SSH connector would show "Available" in the Health check, even if the credentials were incorrect. The SSH connector configuration page has also been updated to include a Set Super User Password field, in which you can specify a password for a superuser. In a playbook that uses the "SSH" connector, in the "Execute remote command" action, you can choose to execute a remote command as a super user, by clicking the Run as super user checkbox. This version also contains an enhanced logo for the "SSH" connector.

Version 2.0.2

  • Includes a number of bug fixes and enhancements made in the SSH connector.

Troubleshooting issues with the SMTP connector

SMTP connector displays a "No route to host" error on Health Check

The SMTP connector could display an error such as "[Error 113] No route to host" on the health check:

Once you view this issue, do the following:

  1. Check error logs in /var/log/mail. You should see the following entry:
    fatal: parameter inet_interfaces: no local interface found for ::1
  2. Check the status of the 'postfix' service. You should find that it is failing with the following error:
    fatal: parameter inet_interfaces: no local interface found for ::1

The issue is restart/start postfix is not working, which is causing the following error:
fatal: parameter inet_interfaces: no local interface found for ::1

Resolution

To resolve this issue, do the following:

  1. SSH to your FortiSOAR instance as a root user.
  2. Edit the file /etc/postfix/main.cf file using the vi /etc/postfix/main.cf command, as follows:
    1. Search for inet_interfaces and change it to inet_interfaces = all
    2. Search for inet_protocols and change it to inet_protocols = ipv4
    3. Save the file.
  3. Restart the postfix service using the following command:
    systemctl restart postfix
Previous
Next

SMTP Connector v2.4.3

Overview

FortiSOAR™ provides you with a number of pre-installed connectors or built-ins, such as the SMTP or Database connectors that you can use within FortiSOAR™ playbooks, as a connector step, and perform automated operations. These connectors are bundled and named based on the type of operations the connectors can perform. For example, the Database connector would contain actions that you can perform with respect to the database like querying the database. It is easy to extend and enhance these connectors.

Apart from the FortiSOAR™ Built-in connectors, Fortinet also provides a number of connectors for popular integrations like SIEMs, such as FortiSIEM, Splunk, etc., and Ticketing systems such as Jira. You can see a list of published connectors on the FortiSOAR Connectors Documentation site.

The process of installing, configuring, and using connectors is defined in the Introduction to connectors chapter in the "Connectors Guide", which is part of the FortiSOAR™ documentation or see the Installing a connector and Configuring a connector articles.

FortiSOAR™ Built-in connectors are upgraded by default with a FortiSOAR™ upgrade. Use the Content Hub to upgrade your connectors to the latest version. For more information on the connector store, see the Introduction to connectors chapter and see the FortiSOAR Built-in connectors article.

Important: Before you upgrade your FortiSOAR™ version, it is highly recommended that you take a backup of your FortiSOAR™ Built-in connector's (SSH, IMAP, Database, etc.) configuration since the configuration of your FortiSOAR™ Built-in connectors might be reset if there are changes to the configuration parameters across versions.

SMTP

Use this connector to set up SMTP for sending system notifications, including requests for resetting passwords, and also for sending emails outside FortiSOAR™. When you configure the SMTP connector, you must ensure that the Mark As Default Configuration option for the configuration that is to be used for sending system notifications is selected.

You can send emails to 30 most recently created FortiSOAR™-teams or users by selecting teams or users from a pre-populated drop-down list using the Recipient Type drop-down list.

If you select Manual Input from the Recipient Type drop-down list, then you can specify a comma-separated list of email addresses, including email addresses of non-FortiSOAR™ users. However, you can also specify the IRI values for users and/or teams, which allows users to reuse team or user information defined in previous playbook steps as Jinja statements.

If you select Team from the Recipient Type drop-down list, then you can send emails by selecting existing FortiSOAR™ teams from the pre-populated To, CC, or BCC multi-select fields, which enables users to dynamically leverage the email ID which has already been provided in a team record, and the email can be sent to all the members of the team at once.


If you select User from the Recipient Type drop-down list, then you can send emails by selecting existing FortiSOAR™ users from the pre-populated To, CC, or BCC multi-select fields, which enables users to dynamically leverage the email ID which has already been provided in a user record. So now you have the ability to interchangeably send emails in multiple formats by specifying a comma-separated list of email addresses or selecting FortiSOAR™-teams or users, or by reusing team or user information defined in previous playbook steps as Jinja statements.

You can pass an existing email template as an input for the email subject and body (content) allowing you to leverage an existing email template and build upon it, thereby, avoiding re-work and ensuring consistency. The Send Email step contains a Body Type drop-down list from which you can choose whether you want to send a plain text email (Plain Text), rich text email (Rich Text), or an email based on a template (Email Template).

If you select Rich Text from the Body Type drop-down list, then in the Content field, you can add formatted content, images, and even custom jinja expressions using Dynamic Values:
If you select Email Template from the Body Type drop-down list, the Email Template drop-down list is displayed, using which you can select the template that you want to use to send the email:

SMTP Connector Release Notes

Version 2.4.3

Version 2.4.2

Version 2.4.1

Version 2.4.0

Version 2.3.3

Version 2.3.2

Version 2.3.1

Contains an updated logo.

Version 2.3.0

Version 2.2.0

Version 2.1.2

SOAP Connector Release Notes

Version 2.4.0

Version 2.3.0

This version contains a full-fledged SOAP client that reads WSDL from the configuration and populates the list of actions and all the required/optional inputs from WSDL. Therefore, now you can use the newly added SOAP Call action to integrate SOAP web services with FortiSOAR™. For more information, see the SOAP section.

Version 2.2.1

Version 2.1.0

SSH Connector Release Notes

Version 2.1.1

Version 2.1.0

Version 2.0.2

Troubleshooting issues with the SMTP connector

SMTP connector displays a "No route to host" error on Health Check

The SMTP connector could display an error such as "[Error 113] No route to host" on the health check:

Once you view this issue, do the following:

  1. Check error logs in /var/log/mail. You should see the following entry:
    fatal: parameter inet_interfaces: no local interface found for ::1
  2. Check the status of the 'postfix' service. You should find that it is failing with the following error:
    fatal: parameter inet_interfaces: no local interface found for ::1

The issue is restart/start postfix is not working, which is causing the following error:
fatal: parameter inet_interfaces: no local interface found for ::1

Resolution

To resolve this issue, do the following:

  1. SSH to your FortiSOAR instance as a root user.
  2. Edit the file /etc/postfix/main.cf file using the vi /etc/postfix/main.cf command, as follows:
    1. Search for inet_interfaces and change it to inet_interfaces = all
    2. Search for inet_protocols and change it to inet_protocols = ipv4
    3. Save the file.
  3. Restart the postfix service using the following command:
    systemctl restart postfix
Previous
Next