FortiSOAR ML Engine Connector v1.2.1

Overview

FortiSOAR™ provides you with a number of pre-installed connectors or built-ins, such as the Database connector 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, in case you want to only upgrade the connectors and not FortiSOAR™. 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.

FortiSOAR ML Engine

The FortiSOAR ML Engine connector leverages Machine Learning (ML) and acts as your recommendation engine by analyzing and filtering your existing record data using different algorithms to recommend similar records and predict and assign field values in records. It is based on finding similarities of patterns in historical data.

IMPORTANT: Version 1.2.1 or later of the ML Engine connector is supported on FortiSOAR release 7.3.0 or later. Therefore, it is recommended not to install or upgrade the ML Engine connector v1.2.1 on FortiSOAR releases earlier than 7.3.0, such as FortiSOAR release 7.2.2, 7.2.1, etc.

Version information

Connector Version: 1.2.1

Authored By: Fortinet.

Certified: Yes

NOTE: Version 1.2.1 or later of the ML Engine connector is compatible with FortiSOAR release 7.3.0 or later.

Release Notes for version 1.2.1

Following enhancements have been made to the FortiSOAR ML Engine connector in version 1.2.1:

• Enhanced the FortiSOAR ML Engine connector to support updating this connector seamlessly in the case of a containerized environment.
• Added the 'Documentation' link on the Connector configuration popup, which opens the documentation for this version of the connector.

NOTE: For more information on previous releases of the FortiSOAR ML Engine connector, see the FortiSOAR ML Engine Connector v1.2.0 document.

Configuring the connector

You must be an 'Administrator' with 'Security' rights on FortiSOAR to configure the ML Engine connector. If you have appropriate rights, navigate to the Recommendation Engine section on the System Configuration page and configure the ML Engine connector as the recommendation engine. For more information on the 'Recommendation Engine' and how to configure the FortiSOAR ML Engine connector, see the "Recommendation Engine > Record Similarity and Field Predictions" topic in the Application Editor chapter in the "Administration Guide", which is part of the FortiSOAR™ product documentation.

Actions supported by the connector

The following automated operations can be included in playbooks:

operation: Train

Input parameters

None.

operation: Predict

Input parameters

operation: Fetch Similar Record(s)

Input parameters

Troubleshooting

Post-upgrade the ML engine connector displays older dater

Version 1.2.1 or later of the ML Engine connector is supported on FortiSOAR release 7.3.0 or later. Therefore, it is recommended not to install or upgrade the ML Engine connector v1.2.1 on FortiSOAR releases earlier than 7.3.0, such as FortiSOAR release 7.2.2, 7.2.1, etc. However, if you have upgraded the ML Engine connector to 1.2.1 or later on a FortiSOAR release prior to 7.3.0, for example, release 7.2.1, then the ML engine connector uses stale data. To resolve this issue, do the following:

Resolution

1. Restart the uwsgi service using the following command:
   # systemctl restart uwsgi
   The ML engine connector configuration page displays an 'internal server error'.
2. To solve the internal server error, delete the configuration of the ML engine connector from your FortiSOAR instance and reconfigure the ML engine connector by adding a new configuration.