Home Assistant

FortiOS

The FortiOS presence detection enables Home Assistant to track devices with a MAC address connected to a FortiGate from Fortinet.

The integration relies on the fortiosapi. It has been verified on FortiGate appliances and FortiGate VM running FortiOS v. 6.4.x (up to 6.4.8), 7.0.x (up to 7.0.4) and 7.2.0.
The minimum version supported is FortiOS 6.4.3.

All devices with a MAC address identified by FortiGate would be tracked, this covers both Ethernet and Wi-Fi devices, including devices detected by LLDP.

The integration is based on the Home Assistant device_tracker platform.

Example Configuration:

This example uses the FortiOS integration as a device tracker, with an API token and does not verify the SSL certificate.

# Example configuration.yaml
device_tracker:
  - platform: fortios
    host: YOUR_HOST
    token: YOUR_API_USER_KEY

Configuration Variables

Looking for your configuration file?
host string Required

Hostname or IP address of the FortiGate. Optionally port name can be added like this “10.10.10.10:443”. Remember quotes if port number is added.

token string Required

See: Generate an API token for FortiOS for how to create an API token. This integration only needs read access to a FortiGate, so configure the API user to only to have limited and read-only access.

verify_ssl boolean (Optional, default: false)

If the SSL certificate should be verified. In most home cases users do not have a verified certificate.