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¶
- Visit IPHub.info and select a subscription plan.
- Note: IPHub is a paid-only service and does not offer a permanent free tier.
- 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-Keyinto 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. |