MaxMind GeoIP2 Provider Guide

MaxMind GeoIP2 is the industry standard for geolocation and network intelligence. The Preads Platform provides a specialized, dual-mode integration that allows you to choose between high-precision cloud analysis and ultra-fast, unlimited local database lookups.

🏗️ Support Modes

1. Precision Insights (API)

Best for networks requiring the highest level of data freshless and detailed fraud signals without managing local infrastructure.

  • Freshness: Real-time updates from MaxMind's cloud.
  • Operational Cost: Pay-per-query model (Requires MaxMind GeoIP2 Insights subscription).
  • Detection Quality: Includes advanced "Anonymity Traits" specifically calibrated for fraud prevention.

Best for high-volume networks (10,000+ checks/month) requiring sub-millisecond response times and zero variable operational costs.

  • Speed: <1ms lookup latency (processed directly on your server).
  • Capacity: Unlimited queries with no per-hit API charges.
  • Reliability: Zero dependency on external API uptime during live traffic.

🚀 Activation & Configuration

Navigate to Admin → Security → Anti-Cheat → API Keys → MaxMind GeoIP2.

Cloud API Configuration

  1. Obtain your Account ID and License Key from the MaxMind Account Portal.
  2. Paste credentials into the respective fields.
  3. Ensure "Use Local Database" is toggled OFF.
  4. Click Test API to verify connectivity.

Local Database Configuration

  1. Download the GeoIP2-Anonymous-IP.mmdb (Essential) and GeoIP2-City.mmdb (Optional) files.
  2. Upload the .mmdb files to the following directory: storage/app/geoip2/
  3. In the Admin Panel, toggle "Use Local Database" to ON.
  4. Click Test API to verify the platform can successfully read and query the local files.

🛡️ Detection Intelligence

The platform maps MaxMind's enterprise-grade signals into our unified weighted scoring engine.

Risk Weighting Standard

  • 90 Score (Critical): Triggered by TOR Exit Nodes.
  • 70 Score (High): Triggered by Anonymous VPNs or Public Proxies.
  • 50 Score (Medium): Triggered by Hosting Providers or Datacenters.

Local Database Hierarchy

When in Local DB mode, the system implements an intelligent lookup hierarchy:

  1. Anonymous-IP Database: Prioritized for infrastructure fraud (VPN/Proxy/TOR).
  2. City Database: Cascaded for surgical Country and ISP identification.

🔄 Automated Maintenance

To ensure your Local DB remains accurate, it is recommended to automate database updates.

geoipupdate Configuration

MaxMind provides a standard utility (geoipupdate) to keep your local .mmdb files current. Configure your GeoIP.conf with:

DatabaseDirectory /path/to/wannads-platform/storage/app/geoip2
EditionIDs GeoIP2-Anonymous-IP GeoIP2-City

Cron Schedule

Schedule a weekly refresh task (e.g., every Wednesday) to synchronize with MaxMind's release cycle:

0 2 * * 3 /usr/bin/geoipupdate

Configure AbuseIPDB Provider →