OPNSense


OPNsense is an open source HardenedBSD based firewall and routing platform. There is currently support for the following device types within Home Assistant:

Configuration

To configure OPNsense integration with Home Assistant add the following section to your configuration.yaml:

opnsense:
  url: https://router/api
  api_secret: API_SECRET
  api_key: API_KEY

Where the api_key and api_secret values are acquired from your OPNsense router using the web interface. For more information on this procedure, refer to the OPNsense documentation.

User with API Key requires privileges for Type:

  • GUI Name: Diagnostics: ARP Table
  • GUI Name: Diagnostics: Network Insight

Configuration Variables

urlstringRequired

The URL for the OPNsense API endpoint of your router.

api_keystringRequired

The API key used to authenticate with your OPNsense API endpoint.

api_secretstringRequired

The API secret used to authenticate with your OPNsense API endpoint.

verify_sslboolean(Optional, default: false)

Set to true to enable the validation of the OPNsense API SSL.

tracker_interfaceslist(Optional, default: [])

List of the OPNsense router’s interfaces to use for tracking devices.

Presence detection

This platform allows you to detect presence by looking at devices connected to an OPNsense router.