Home Assistant Home Assistant

FortiOS

This integration enables Home Assistant to do device tracking of devices with a MAC address connected to a FortiGate from Fortinet.

The integration relies on the fortiosapi. The integration has been tested both on FortiGate appliance and FortiGate VM running SW FortiOS v. 6.0.x and 6.2.0.

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.yaml entry
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.

token string Required

See: Generate an API token for FortiOS for how to create an API token. Remember 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.