Integration Devices

FortiDeceptor on FortiGate Security Fabric topology map

Security Fabric integration allows FortiDeceptor and deception decoys to be visible through the Fabric network topology map.

Use Fabric > Integration Devices to configure the integration between FortiDeceptor and FortiGate for Security Fabric.

To configure the integration between FortiDeceptor and FortiGate for Security Fabric:

1. In FortiDeceptor, go to Use Fabric > Integration Devices.
2. In the Fabric Upstream section, select Enabled.

   

3. Enter the FortiGate IP address in Upstream IP Address and the FortiGate connector port in Port.

   

4. In FortiGate, log in as an admin and go to Security Fabric > Fabric Connectors.
5. Add the FortiDeceptor connector for this integration. For information, see Configuring other Security Fabric devices > FortiDeceptor in the FortiGate Administration Guide.

   

   When configuring the Fabric Connector in FortiGate, you must enable Allow downstream device REST API.

   

   FortiDeceptor supports the CSF protocol that triggers automatic mitigation/ isolation of the infected endpoint from the network and prevents the attack from moving laterally.

   The CSF integration provides access to more fabric devices for isolations like FortiSwitch through the Fortigate.

   SAML support between Fortigate WEB-UI to FortiDeceptor to allows SSO login from Fortigate to FortiDeceptor.

6. To trigger automatic mitigation using the CSF:

   1. In FortiGate, log in as an admin and go to Security Fabric > Automation.
   2. Click Trigger > Create New.
   3. Configure the Fabric Connector Event:
      1. Enter the Name of the event.
      2. Enter a Description of the event.
      3. Select a FDC appliance from the connector menu.
      4. Select an event.
      5. Select the Event Severity.
      6. Click Save.

      

7. In the same screen, go to Action > Create New and choose any mitigation response you would like to execute once the FortiDeceptor pushes an incident alert to Fortigate.

   

8. In FortiGate, go to Security Fabric > Physical Topology to verify that the FortiDeceptor is on the topology map.

   

9. In FortiGate, go top Dashboard > Status to view FortiDeceptor information and deception decoys configuration status.

   

FortiDeceptor integration for threat response mitigation

Use Fabric > Integration Devices to view and configure FortiGate and other device settings for integration with FortiDeceptor. Integration uses REST APIs, XML APIs, or webhooks. When decoys are accessed, FortiDeceptor makes quarantine calls and attackers are immediately quarantined on the device for further analysis.

The following information is displayed:

Action	Click Edit to edit the integration settings. Click Delete to delete the device.
Enabled	Shows if the device is enabled or disabled.
Status	Device status.
Name	Alias of the integrated device.
Integrate Method	FGT-REST-API FGT-WEBHOOK PAN-XMLAPI GEN-WEBHOOK FNAC-WEBHOOK WMI-Disable FortEDR-Isolation Cisco-ISE
Severity	Security level. The selected level and all levels above it are blocked. For example, if you select Medium, then when any attack reaches medium, high, or critical levels, the attacker IP address is blocked. If you select Critical, then only the critical level is blocked.
Detail	Device integration details.

To integrate a device:

1. Go to Fabric > Integration Devices.
2. Click Quarantine Integration With New Device.
3. Configure the device for integration. Then click Save.

   Enabled	Enable or disable this device.
   Name	Specify a name for this device.
   Block Severity	The selected level and all levels above it are blocked. For example, if you select Medium, then when any attack reaches medium, high, or critical levels, the attacker IP address is blocked. If you select Critical, then only the critical level is blocked.
   Appliance	Option for Central Management manager device to integrate the incidents from the specified appliances only.
   Integrate Method	The integration method of this device: FGT-REST-API FGT-WEBHOOK PAN-XMLAPI GEN-WEBHOOK FNAC-WEBHOOK WMI-Disable FortEDR-Isolation Cisco-ISE Different integration methods have different settings.
   IP or Device IP	IP address of the integrated device.
   Port	Port number of the integrated device API service. Default is 8443.
   Username and Password	Username and password of the integrated device.
   Authorization Token	The FNAC-WEBHOOK auhtorization token generated by FNAC.
   VDOM	For FortiGate devices, the default access VDOM.
   Verify SSL	Enable to verify SSL.
   Expiry	Default blocking time in second. Default is 3600 seconds.