Fortinet FortiGate

Fortinet FortiGate is a next-generation firewall providing security and visibility for end-to-end protection across the entire enterprise network.

Types of Assets Fetched

This adapter fetches the following types of assets:

• Devices
• Users
• Firewall Rules
• Alerts/Incidents

Parameters

1. Host Name (required) - The hostname or IP address of the Fortinet FortiGate server.

2. Port (optional) - If not supplied, Axonius will use TCP port 443.

3. User Name and Password (required) - The credentials for a user account that has the Required Permissions to fetch assets.

4. Virtual Domain (optional) - Specify a comma-separated list of Virtual Domains (VDOMs).

   • If supplied, Axonius will fetch data from specified virtual domains.
   • If not supplied, Axonius will use 'vdom' value.

5. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

6. Is FortiManager Server - Select whether the Fortinet Fortigate is a FortiManager server.

7. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

8. HTTPS Proxy User Name (optional) - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

9. HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

1. DHCP lease time (seconds) (required, default: 604800) - Specify the DHCP lease time, that refers to the life of an IP address remains assigned to a device.
2. Interfaces exclude list (optional) - Specify a comma-separated list of Fortinet FortiGate interfaces.
   • If supplied, all connections for this adapter will only fetch devices that are not associated with the specified interfaces.
   • If not supplied, all connections for this adapter will fetch devices associated with any interface.
3. VMware Interfaces exclude list (optional) - Specify a comma-separated list of Fortinet FortiGate interfaces.
   • If supplied, all connections for this adapter will only fetch virtual devices that are not associated with the specified interfaces.
   • If not supplied, all connections for this adapter will fetch virtual devices associated with any interface.
4. Do not fetch OS Type field (optional) - Select to exclude fetching data from the OS Type field.
5. Allow IPSEC VPN devices - Select to allow fetching IPSEC VPN devices.
6. Fetch managed Fortigate devices - Select to fetch managed FortiGate devices.
7. Use Fortigate new OS version parser - Select this option to fetch the OS minor version from another field on a FortiOS device instance.
8. Fetch firewall rules - Select this option to fetch all the firewall rules, as well as their policies and addresses.
9. Maximum number of chunks (default:50) - Enter a number to set the maximum number of parallel chunks to fetch information from the ADOMs. This can be a value between 50 and 100. Select the number of parallel calls that works best with your system.
10. Fetch VPN SSL Sessions as Devices - Select this option to fetch VPN SSL sessions as Devices.

Required Permissions

The value supplied in User Name must have read access to devices.

Step 1: Create an Administrator profile

1. On the FortiManager GUI, select System Settings > Admin Profiles > Create New.

2. Populate the fields as shown in the image below.

3. Select the permissions of your choice.
   

4. Click OK.
   
   

Step 2: Create the JSON API Admin

When you have your administrator profile, use the steps below to create the FortiManager API admin. You need to create a FortiManager API locally defined API admin user

1. On the FortiManager GUI, select System Settings > Administrators > Create New.
2. Populate the fields as shown in the image below. Make sure you assign select:read (rpc-permit), ALL ADOMs, and ALL Packages (Policy Package Access).
   
3. Click OK.

Version Matrix

This adapter was only tested with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed, which is not functioning as expected.

Supported From Version

Supported from Axonius version 4.5