Thomas Le Gentil 357bc3ff60
deprecate fortigate integration (#13197)
* deprecate fortigate integration

the fortigate integration will be remove in order to only use the fortios one

* highlighted text

highlighted text and added link to the fortios integration

* used a 'note warning' css class

* Minor changes

Co-authored-by: Fabian Affolter <mail@fabian-affolter.ch>
2020-05-05 10:46:21 +02:00

1.8 KiB

title, description, ha_category, ha_release, ha_iot_class, ha_codeowners, ha_domain
title description ha_category ha_release ha_iot_class ha_codeowners ha_domain
FortiGate Instructions on how to integrate FortiGate Firewalls into Home Assistant.
Presence Detection
0.97 Local Polling
@kifeo
fortigate

This is a FortiGate presence sensor based on device detection of the FortiGate API

This integration will be deprecated. Please use the [FortiOS](/integrations/fortios) integration.

FortiGate set up

Configure the FortiGate with a USERNAME API user and assign its minimum rights profile:

config system accprofile
    edit "homeassistant_profile"
        set authgrp read
    next
end

config system api-user
    edit "USERNAME"
        set api-key API_KEY
        set accprofile "homeassistant_profile"
        set vdom "root"
        config trusthost
            edit 1
                set ipv4-trusthost <trusted subnets>
            next
        end
    next
end

Configuration

Add the following to your configuration.yaml file:

# Example configuration.yaml entry
fortigate:
  host: HOST_IP
  username: YOUR_USERNAME
  api_key: YOUR_API_KEY

{% configuration %} host: description: The IP address of the FortiGate device. required: true type: string username: description: The username of the user that will connect to the FortiGate device. required: true type: string api_key: description: The API key associated with the user. required: true type: string devices: description: The MAC addresses of the devices to monitor. required: false type: string {% endconfiguration %}

Errors

If the rights of the profile are not sufficient, you will get the following error:

ERROR (MainThread) [homeassistant.core] Error doing job: Task exception was never retrieved