IPHub Setup Guide

IPHub is a specialized, high-accuracy component of the Preads Platform's security ecosystem. Unlike multi-signal providers, IPHub focuses specifically on identifying users behind commercial VPNs, proxies, and datacenter ranges with surgical precision.


🚀 Activation & Authentication

Because IPHub is a specialized premium service, it requires valid API credentials for operation.

1. Register for API Access

  1. Visit IPHub.info and select a subscription plan.
  2. Note: IPHub is a paid-only service and does not offer a permanent free tier.
  3. Obtain your X-Key from the IPHub dashboard.

2. Configure in Admin Panel

Navigate to Admin → Security → Anti-Cheat → API Keys → IPHub.

  • API Key: Paste your X-Key into the designated field.
  • Enabled: Toggle to ON.
  • Test API: Use the built-in test tool to verify the connection. A successful test confirms that your subscription is active and the API header is being sent correctly.

🛡️ Detection Intelligence

The Preads Platform translates IPHub's simplified block response into a detailed infrastructure audit result.

Block Factor Mapping

The IpIntelligenceService interprets IPHub's results using the following verified weighting:

  • Residential (Score: 0): Triggered by block: 0. The user is identified as a legitimate residential or business connection.
  • Infrastructure (Score: 50): Triggered by block: 1. The IP is identified as a commercial VPN, proxy server, or known datacenter range.
  • Anonymity (Score: 100): Triggered by block: 2. The IP is identified as a verified TOR exit node.

Signal Normalization

When IPHub flags an IP (Block 1 or 2), the platform automatically sets the following internal audit flags:

  • is_vpn: True for commercial VPN ranges.
  • is_proxy: True for identified proxy servers.
  • is_datacenter: True for hosting and cloud infrastructure.
  • is_tor: True for onion routing exit nodes.

⚡ Performance Optimization

The "Smart Chaining" Layer

IPHub is ideally positioned as a Primary VPN Detector or as a Specialized Auditor in your fallback chain.

  • Primary Mode: Enable IPHub first if your network faces specific challenges with commercial VPN persistence.
  • Secondary Mode: Position IPHub after a free provider (like ProxyCheck) to perform deep verification only when initial signals are ambiguous.

High-Performance Caching

To minimize IPHub query consumption, the platform utilizes its core Database Caching Engine. Each unique result is stored in the ip_intelligence table for the duration of your Cache TTL (default 24h), ensuring that frequent user interactions do not deplete your daily API quota.


💰 Operational Scale

Feature Details
Subscription Paid Only (Starts at ~$10/mo).
Specialization Consumer VPNs, Datacenters, and Privacy tunnels.
Core Advantage High signal reliability with minimal false positives for residential users.

Configure IPInfo Provider →