This plugin links the IP of the visitor with a database of IP ranges to be able to recognize special visitors. The IP ranges can be imported from a json file, either via a command line command or using the scheduler to download it. For more infos check the docs and the FAQ. The minimum required PHP version is 7.4. Recommended is 8.0+. Starting with v3.0.0, PHP 7.3 is no longer supported.

Warning

At the moment it is not possible to remove ranges from the database without manual database changes. As a workaround you can uninstall the plugin (this deletes the tables) and install the plugin again.

View and download this plugin for a specific Matomo version:

Matomo 4.x
Matomo 5.x (currently selected)

Quick start

Install the plugin
Create your Json file
1. If you don't have one, you can use the one I created with Austrian Government Agencies
Import it
1. Either on the console ./console vipdetector:import-data /path/to/file.json
2. Or use the Matomo scheduler via the Web Interface

Json File Structure

[
 {
  "name": "Example Org 1",
  "ranges": [
   "192.0.2.0/24",
   "198.51.100.0/24"
  ]
 },
 {
  "name": "Example Org 2",
  "ranges": [
   "203.0.113.0/24",
   "2001:db8::/32"
  ]
 }
]

Why

I am a let's say "known person" in the Austrian government, mostly because I was one of five people suing them in a civil rights case. And I've a blog. Said blog gets visited by government agencies regularly, and I wanted to have an overview of this.

Limitations

The subnets you want to match on can't be smaller than what you set as the anonymization factor for the IP addresses. For example if you set the masking for 2 bytes as recommended, the smallest subnet you can match is a /16, if you mask the last byte it is /24. At the moment it is not possible to remove ranges from the database without manual database changes. As a workaround you can uninstall the plugin (this deletes the tables) and install the plugin again.