Skip to content
Jean-Paul C edited this page Oct 1, 2023 · 5 revisions

Welcome to the IP2Location-pfSense wiki!

pfSense dashboard widget and backend service for displaying live IP geolocation information obtained from the IP2Location.io API.

Features

  • Live processing of pfSense firewall logs to obtain IP geolocation information
  • Offloads processing of IP information from pfSense to a separate host
  • Minimal overhead on pfSense host, able to run on dedicated pfSense hardware
  • Live IP geolocation information retrieved from the IP2Location.io API
  • Map view of IP locations provided by Leaflet.js with sumamry of IP information
  • Watch list of IP addresses to monitor and track the number of hits
  • Storage of the watch list in the backend service
  • Drill-down into details of the IP address information provided by IP2Location.io
  • Fully functional with a free IP2Location.io API account
  • Support for more granular IP information available with paid IP2Location.io API accounts
  • Utilises Redis cache to reduce the number of API requests
  • Frequency of updates, number of log entries, API calls and cache duration configurable
  • Support for SSL / TLS and backend secured with configurable API keys


WIP features

(part implemented and planned features)

  • Backend service standalone mode, allowing monitoring of service's host network traffic without pfSense
  • Configurable map tile providers for Leaflet.js
  • Additional UI for cache monitoring and hit rates, plus configuration of limits
  • Support for multiple pfSense hosts
Clone this wiki locally