Fortinet black logo

Administration Guide

Fabric Connectors

Fabric Connectors

Fabric connectors provide integration with Fortinet products to automate the process of managing dynamic security updates without manual intervention.

Creating a Security Fabric Group

To create a Security Fabric group in the GUI:
  1. Configure FortiAnalyzer logging:
    1. Go to Security Fabric > Fabric Connectors and double-click the FortiAnalyzer Logging card.
    2. Ensure the Status is Enabled, and configure the settings as needed.

    3. Click OK.
  2. Configure the Security Fabric group root:
    1. Go to Security Fabric > Fabric Connectors and double-click the Security Fabric Setup card.

    2. Change Status to Enabled.
    3. In Security Fabric role, select Serve as Fabric Root to configure a Security Fabric root.
    4. In the Fabric name and Group password fields, specify the group name and password, which are required for other devices to join the group.
    5. Enable Allow other Security Fabric devices to join.
    6. Add members to the trusted list by clicking Edit next to Device authorization and clicking Create New in the Device Authorization panel. Fill in the license serial number of the member and specify a name. The license serial number can be retrieved by running the get system status command in the member device.
    7. Configure other options as needed, such as License Sharing Between FortiProxy Devices which specifies whether to allow the root to share licenses with other devices within the group.
    8. Click OK.
  3. (Optional) Add additional members to the group by editing the root you just configured and repeat step f. Alternatively, you can add additional members by configuring a new Security Fabric Setup card:
    1. Go to Security Fabric > Fabric Connectors and double-click the Security Fabric Setup card.
    2. Change Status to Enabled.
    3. In Security Fabric role, select Join Existing Fabric to configure a Security Fabric member.
    4. Fill in the root device address in Upstream FortiProxy IP/FQDN.
    5. In the Group password field, enter the password you set in the root.
    6. Configure other options as needed, such as License Sharing Between FortiProxy Devices which specifies whether to allow the device to share licenses with other devices within the group.
  4. Verify the fabric group status using the fabric group topology in right-side menu on the Security Fabric >> Fabric Connectors page.

To create a Security Fabric group in the CLI:
  1. Configure FortiAnalyzer logging:
    config log fortianalyzer setting
        set status enable
        set server "172.18.64.234"
        set serial "FL-8HFT000000000"
        set upload-option realtime
        set reliable enable
    end

    Refer to the config log fortianalyzer setting topic in the CLI guide for more details about each option and a full list of available options.

  2. Configure the security fabric group root:

    config system csf

    set status enable

    set group-name <string>

    set downstream-access enable

    set license-sharing enable

    config trusted-list

    edit <MEMBER_DEVICE_NAME>

    set serial <LICENSE_SERIAL_OF_MEMBER_DEVICE>

    set guaranteed-seats <integer>

    next

    edit <MEMBER_DEVICE_2_NAME>

    set serial <LICENSE_SERIAL_OF_MEMBER_DEVICE_2>

    set guaranteed-seats <integer>

    next ...

    end

    When adding devices to the trusted list, you can retrieve the license serial number by running the get system status command in the member device.

    Refer to the config system csf topic in the CLI guide for more details about each option and a full list of available options.

  3. (Optional) Apply the following configuration to each trusted member device you defined in step 2:

    config system csf

    set status enable

    set upstream <IP_OF_FABRIC_ROOT>

    set group-name <FABRIC_GROUP_NAME>

    set group-password <FABRIC_GROUP_PASSWORD>

    set configuration-sync local

    set license-sharing enable

    end

    When license sharing is enabled, setting configuration-sync to local disables configuration synchronization with a management device, which is recommended for license sharing.

    Refer to the config system csf topic in the CLI guide for more details about each option and a full list of available options.

  4. Verify the fabric group status:
    • To check connected member devices to the root, run diag system csf downstream. All connected devices will be listed, regardless of the authorization status.

    • To check the root device status, run diag system csf upstream. The connection status should be Authorized. If the connection status is Authorization Rejected, check if the member device is added to the trusted list of the root device.

    • To check the fabric group setting, run get system csf. The following is an example of the results from a root device:

      status : enable

      upstream :

      upstream-port : 8013

      group-name : my_fabric_grp

      group-password : *

      accept-auth-by-cert : enable

      log-unification : enable

      authorization-request-type: serial

      fabric-workers : 2

      downstream-access : enable

      license-sharing : enable

      downstream-accprofile: super_admin

      configuration-sync : local

      fabric-object-unification: local

      trusted-list:

      == [ 1 ]

      name: 1 serial: FPX*************

      ha-members:

      fabric-connector:

      forticloud-account-enforcement: enable

Simplify EMS pairing with Security Fabric so one approval is needed for all devices

FortiClient EMS with Fabric authorization and silent approval capabilities is able to approve the root FortiProxy unit in a Security Fabric once and then silently approve remaining downstream FortiProxy units in the Fabric. Similarly in an HA scenario, an approval only needs to be made once to the HA primary unit. The remaining cluster members are approved silently.

To use EMS silent approval:
  1. Configure the EMS entry on the root FortiProxy unit or HA primary:
    config endpoint-control fctems
        edit "ems139"
            set fortinetone-cloud-authentication disable
            set server "172.16.200.139"
            set https-port 443
            set source-ip 0.0.0.0
            set pull-sysinfo enable
            set pull-vulnerabilities enable
            set pull-avatars enable
            set pull-tags enable
            set pull-malware-hash enable
            unset capabilities
            set call-timeout 30
            set websocket-override disable
        next
    end

    When the entry is created, the capabilities are unset by default.

  2. Authenticate the FortiProxy unit with EMS:
    # execute fctems verify ems_139
    ...

    The FortiProxy unit enables the Fabric authorization and silent approval based on the EMS supported capabilities.

    config endpoint-control fctems
        edit "ems139"
            set server "172.18.62.12"
            set capabilities fabric-auth silent-approval websocket
        next
    end
  3. Configure a downstream device in the Security Fabric. The downstream device is silently approved.
  4. Configure a secondary device in an HA system. The secondary device is silently approved.

Fabric Connectors

Fabric connectors provide integration with Fortinet products to automate the process of managing dynamic security updates without manual intervention.

Creating a Security Fabric Group

To create a Security Fabric group in the GUI:
  1. Configure FortiAnalyzer logging:
    1. Go to Security Fabric > Fabric Connectors and double-click the FortiAnalyzer Logging card.
    2. Ensure the Status is Enabled, and configure the settings as needed.

    3. Click OK.
  2. Configure the Security Fabric group root:
    1. Go to Security Fabric > Fabric Connectors and double-click the Security Fabric Setup card.

    2. Change Status to Enabled.
    3. In Security Fabric role, select Serve as Fabric Root to configure a Security Fabric root.
    4. In the Fabric name and Group password fields, specify the group name and password, which are required for other devices to join the group.
    5. Enable Allow other Security Fabric devices to join.
    6. Add members to the trusted list by clicking Edit next to Device authorization and clicking Create New in the Device Authorization panel. Fill in the license serial number of the member and specify a name. The license serial number can be retrieved by running the get system status command in the member device.
    7. Configure other options as needed, such as License Sharing Between FortiProxy Devices which specifies whether to allow the root to share licenses with other devices within the group.
    8. Click OK.
  3. (Optional) Add additional members to the group by editing the root you just configured and repeat step f. Alternatively, you can add additional members by configuring a new Security Fabric Setup card:
    1. Go to Security Fabric > Fabric Connectors and double-click the Security Fabric Setup card.
    2. Change Status to Enabled.
    3. In Security Fabric role, select Join Existing Fabric to configure a Security Fabric member.
    4. Fill in the root device address in Upstream FortiProxy IP/FQDN.
    5. In the Group password field, enter the password you set in the root.
    6. Configure other options as needed, such as License Sharing Between FortiProxy Devices which specifies whether to allow the device to share licenses with other devices within the group.
  4. Verify the fabric group status using the fabric group topology in right-side menu on the Security Fabric >> Fabric Connectors page.

To create a Security Fabric group in the CLI:
  1. Configure FortiAnalyzer logging:
    config log fortianalyzer setting
        set status enable
        set server "172.18.64.234"
        set serial "FL-8HFT000000000"
        set upload-option realtime
        set reliable enable
    end

    Refer to the config log fortianalyzer setting topic in the CLI guide for more details about each option and a full list of available options.

  2. Configure the security fabric group root:

    config system csf

    set status enable

    set group-name <string>

    set downstream-access enable

    set license-sharing enable

    config trusted-list

    edit <MEMBER_DEVICE_NAME>

    set serial <LICENSE_SERIAL_OF_MEMBER_DEVICE>

    set guaranteed-seats <integer>

    next

    edit <MEMBER_DEVICE_2_NAME>

    set serial <LICENSE_SERIAL_OF_MEMBER_DEVICE_2>

    set guaranteed-seats <integer>

    next ...

    end

    When adding devices to the trusted list, you can retrieve the license serial number by running the get system status command in the member device.

    Refer to the config system csf topic in the CLI guide for more details about each option and a full list of available options.

  3. (Optional) Apply the following configuration to each trusted member device you defined in step 2:

    config system csf

    set status enable

    set upstream <IP_OF_FABRIC_ROOT>

    set group-name <FABRIC_GROUP_NAME>

    set group-password <FABRIC_GROUP_PASSWORD>

    set configuration-sync local

    set license-sharing enable

    end

    When license sharing is enabled, setting configuration-sync to local disables configuration synchronization with a management device, which is recommended for license sharing.

    Refer to the config system csf topic in the CLI guide for more details about each option and a full list of available options.

  4. Verify the fabric group status:
    • To check connected member devices to the root, run diag system csf downstream. All connected devices will be listed, regardless of the authorization status.

    • To check the root device status, run diag system csf upstream. The connection status should be Authorized. If the connection status is Authorization Rejected, check if the member device is added to the trusted list of the root device.

    • To check the fabric group setting, run get system csf. The following is an example of the results from a root device:

      status : enable

      upstream :

      upstream-port : 8013

      group-name : my_fabric_grp

      group-password : *

      accept-auth-by-cert : enable

      log-unification : enable

      authorization-request-type: serial

      fabric-workers : 2

      downstream-access : enable

      license-sharing : enable

      downstream-accprofile: super_admin

      configuration-sync : local

      fabric-object-unification: local

      trusted-list:

      == [ 1 ]

      name: 1 serial: FPX*************

      ha-members:

      fabric-connector:

      forticloud-account-enforcement: enable

Simplify EMS pairing with Security Fabric so one approval is needed for all devices

FortiClient EMS with Fabric authorization and silent approval capabilities is able to approve the root FortiProxy unit in a Security Fabric once and then silently approve remaining downstream FortiProxy units in the Fabric. Similarly in an HA scenario, an approval only needs to be made once to the HA primary unit. The remaining cluster members are approved silently.

To use EMS silent approval:
  1. Configure the EMS entry on the root FortiProxy unit or HA primary:
    config endpoint-control fctems
        edit "ems139"
            set fortinetone-cloud-authentication disable
            set server "172.16.200.139"
            set https-port 443
            set source-ip 0.0.0.0
            set pull-sysinfo enable
            set pull-vulnerabilities enable
            set pull-avatars enable
            set pull-tags enable
            set pull-malware-hash enable
            unset capabilities
            set call-timeout 30
            set websocket-override disable
        next
    end

    When the entry is created, the capabilities are unset by default.

  2. Authenticate the FortiProxy unit with EMS:
    # execute fctems verify ems_139
    ...

    The FortiProxy unit enables the Fabric authorization and silent approval based on the EMS supported capabilities.

    config endpoint-control fctems
        edit "ems139"
            set server "172.18.62.12"
            set capabilities fabric-auth silent-approval websocket
        next
    end
  3. Configure a downstream device in the Security Fabric. The downstream device is silently approved.
  4. Configure a secondary device in an HA system. The secondary device is silently approved.