Fortinet black logo

Administration Guide

Integration Devices

Copy Link
Copy Doc ID 63cab9f6-5858-11ec-bdf2-fa163e15d75b:732297
Download PDF

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.

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.