Integrate a Fortinet FortiGate On-Premises Device
Copy link

Configure a Fortinet FortiGate on-premises device to pull IOCs from Threat Intelligence.

FortiGate v6.2 or later is supported when using the Threat Intelligence Virtual Appliance 4.0 or later.

The following table shows device-specific integration characteristics:

CharacteristicDescription
Method of pullAll new IOCs that were discovered since the previous update are pulled.
IOC typesDomains, file hashes (MD5, SHA-1, and SHA-256), and IP addresses.
IOC group limitationEach IOC group can contain only one type of IOC. For multiple types, create multiple IOC groups.
Device IOC limitThe device is limited to 100,000 IOCs.

Imported IOCs are accepted/monitored. You can create a policy to block those IOCs.

To integrate the device, perform these steps (described in the following sections):

  1. Add the device to the Threat Intelligence Virtual Appliance.
  2. Configure the device to pull IOCs from Threat Intelligence.

Add a Fortinet FortiGate on-premises device
Copy link

Add a device to Threat Intelligence.

Prerequisites
Copy link

  • You have the credentials to access the Threat Intelligence Virtual Appliance web interface.
  • You have the credentials to access the device.

To add the device to Threat Intelligence:

  1. From the Command Platform, go to Data Connectors > Threat Intelligence > Integrations.
  2. From the Integrations page, click On-Premises.
  3. Click Add new device.
  4. In the Add New On-Premises Device  dialog, type a user-defined name for the device. The name can contain a maximum of 50 letters, spaces, numbers, and underscores.
  5. Select the Device type.
    The default device IOCs limit is displayed.
  6. (Optional) You can change the IOCs limit.
  7. Click Add.
  8. To verify that the new device is added, refresh the Data Connectors > Threat Intelligence > Integrations page.

Next to the device name, there is a red dot, indicating that communication has not yet been established. The dot will change to green when the device is synchronized. If the device cannot synchronize for more than 48 hours, an email warning is sent to the account administrator.

Configure a Fortinet FortiGate device to pull IOCs
Copy link

After a device has been added, you must enable it to pull IOCs from Threat Intelligence.

In FortiGate, you must create a separate fabric connector for each IOC group.

By default, IOCs are accepted/monitored. To block IOCs, you will need to edit the policy,

Prerequisites

  • You have the device login credentials.

  • The device has been added.

  • An IOC group for this device exists in Threat Intelligence. Creating IOC groups is described in Create an IOC group.

  • You have the Threat Intelligence account ID and appliance key, as described in API key, account ID, and appliance key. 

To configure a FortiGate on-premises device:

  1. From Threat Intelligence, copy the Fortinet FortiGate IOC group URL into the Fortinet FortiGate:
    1. Log in to the Rapid7 Command Platform.
    2. From the main menu, select Data Connectors > Threat Intelligence > Integrations.
    3. From the On-Premises device list, select the Fortinet FortiGate device.
    4. Click the link icon to the far right of the device IOC group.
    temporary placeholder The IOC Group URL dialog is displayed. 5. From the IOC Group URL dialog, copy the URL. temporary placeholder
  2. Log in to the Fortinet FortiGate.
  3. Navigate to Security Fabric > Fabric Connectors.
  4. Click Create New.
    The New Fabric Connector page is displayed.
  5. In the Threat Feeds section, select a feed option that matches the IOC type in Threat Intelligence IOC group (IP Address, Domain Name, or Malware Hash): temporary placeholder The New Fabric Connector dialog is displayed: temporary placeholder
  6. In the New Fabric Connector dialog, fill the fields, as follows:
FieldDescription
NameType a user-defined name. This name is used to identify IOCs imported from this group.
URI of external resourcePaste in the URL from the Threat Intelligence IOC Group URL dialog.
HTTP basic authenticationIn the Username field, paste the Account ID.
In the Password field, paste the Appliance Key.
You can retrieve this information, as described in API key, account ID, and appliance key.
Refresh Rate(Optional) You can change the refresh rate (default: 5 minutes).
CommentsOptional
  1. Click OK.
    The new threat feed is displayed in the Threat Feeds page: temporary placeholder Initially, the arrow is red and pointing downwards. When it is synchronized it is green, pointing up.
    This process is the same for all forms of threat feeds.
  2. Repeat this process for every IOC group to be imported.

See imported IOCs
Copy link

You can see the IOCs that are imported into FortiGate. The following procedure works the same for all forms of threat feeds.

To see imported IOCs in FortiGate:

  1. From FortiGate, navigate to Security Fabric> Fabric Connectors.
  2. Click a threat feed.
    Its details are displayed. temporary placeholder
  3. Click View Entries.
    The imported IOCs are displayed: temporary placeholder

Block imported IOCs
Copy link

By default, imported IOCs are accepted/monitored. You can create a policy to block both incoming and outgoing communication with the IP address IOCs.

To create a policy to block IOCs:

  1. From FortiGate, navigate to Policy & Objects > IPv4 Policy.
  2. Click Create New.
    The Edit Policy dialog is displayed. temporary placeholder
  3. To select the threat feed to block, click Destination (step A).
  4. Select the IP address threat feed defined previously (step B).
  5. Select Deny (step C).
  6. Click OK (step D).