This plugin protects WordPress Sites from unwanted malicious access attempts by leveraging IP reputation data provided by the ThreatPoint IP reputation service.
This plugin allows administrators to protect their WordPress Sites from unwanted access attempts by leveraging IP reputation data provided by the ThreatPoint IP reputation service. This plugin invokes a restAPI call to the ThreatPoint API, consumes the response and acts based on configuration options in the plugin. This allows ip reputation data to be placed in front of pages (wp-admin and custom pages for example) — without interrupting normal access.
To communicate with the restAPI an API KEY is required from ThreatPoint.
The plugin calls the rest API (requires an API KEY) at this ThreatPoint api endpoint
The rest API is only passed the IP address from the client or X-Forwarded-For address(es) is present.
This external service is called during any login attempts to the admin page. The plugin allows any page to be protected by simply entering the slug name on the setting page in the correct field (comma separated). Any custom page can be protected in this manner.
An API key is required to utilise the service, although the plugin will operate without one it will not be able to pass the IP or call any data from the API. Your pages are NOT protected without a valid API key.
This plugin only passes IP information — no other PII is transferred. The IP address is analysed across the aggregated data within the ThreatPoint IP reputation service and a risk score with geo location information is returned to the plugin. Simple rules within the plugin dictate whether traffic should be allowed to continue as normal or be redirected to an information URL of your choice (set by through the plugin settings). The IP address is stored in the IP aggregated data and used as part of the consortium. No other data such as originating website is stored. Only the IP address and geo location information is held, with date, time and risk scores associated with the request.
- Detects activity and IP reputation from the following sources:
- Tor exit node traffic
- Proxy (paid)
- Proxy (free)
- VPN (paid)
- VPN (free)
- Known Malicious Behaviour (Consortium)
- Brute force detection
- API Documentation is available here: documentation
- Video is here
- Provide risk based decisions through configuration to allow an administrator the correct flow for their site.
- Consortium model of malicious IP’s created from activity seen across the ThreatPoint network
- Detect and block bots, malware, trojans and aggregators as well as malicious human traffic
- API Key — An API key is required to access the IP reputation service as explained above — (email@example.com)
- Country Blacklist — 2 Character ISO country code csv format. Country codes in this list will cause IP addresses from those countries to issue a redirection. Allows you to block access from countries
- Country Whitelist — 2 Character ISO country code csv format. Country codes in this list will cause only IP addressed from these countries to be allowed. All others will be redirected. Allow all from UK for example.
- Country Blacklist is evaluated first — it makes little sense to have both blacklists and whitelists set although it is a supported option due to demand.
- Redirection URL — The web page you wish traffic to be redirected to — please feel free to use Redirection URL
- Reject IP Risk >= — Redirect IP risk scores marked as Consider or High. Allow low risk only if consider is selected. The risk score is created by the IP reputation service based on the source, location, previous use and history across the IP consortium (velocity, reputation, tor, vpn, proxy)
- Pages to protect — a comma separated list of custom pages that you want to use the IP reputation service
- Disable XMLRPC endpoint by adding entry to .htaccess
- Add malicious IP’s directly to .htaccess to protect wp-login from brute force
- English (default) — only language currently supported
- Many thanks for taking the time to look at the plugin
- Drop the ThreatPoint team a line @threatuk on Twitter
- Email questions or suggestions via (firstname.lastname@example.org)
- Api key requests via email@example.com
- English — default, currently the only language supported
Contributors & Developers
- The ThreatPoint team are often asked to investigate attacks on web sites and other services. More often than not these attacks begin from IP addresses that should be considered before access is granted. The IP reputation API provides the intelligence to protect such services, simply and effective. The WordPress plugin framework allows this to be easily introduced into WordPress sites as an additional layer of protection.
- This is not a silver bullet, but it is a useful deterrent. Best efforts to redirect IP addresses based on IP reputation are made. The service should be used in conjunction with other layers of detection and with defined authentication and access rules as part of an overall security policy.
- ThreatPoint UK also provide email verification, device reputation, dark web monitoring and password monitoring services as part of the API service layer. Please contact firstname.lastname@example.org to find out more about these additional services.
- Many credits go to the fraud and analytics team at ThreatPoint UK and the team behind the API services
- Credits to numerous wordpress tutorials used to understand the plugin creation process. notably this article https://www.sitepoint.com/real-world-example-wordpress-plugin-development/
- Download plugin from WordPress! or manually upload the entire ‘ThreatPoint-api’ folder to the ‘/wp-content/plugins/’ directory
- Activate the plugin through the ‘Plugins’ menu in WordPress
- The ThreatPoint-Api settings menu will appear
- Fill in the API Key, Country Blacklist and/or Country Whitelist, Redirect URL and Risk level, Tor Exit Node check, Anonymous VPN check and pages to protect (Admin login is enabled by default).
- Save the settings
- Save the page
Does this plugin work with newest WP versions and also older versions?
Yes, this plugin works with 3.5.2 and above.
We tested on versions 3.5.2, 4.9.5 up to 5.5. As the plugin is simply a way of calling the api and consuming the response the plugin should function in most versions, although we tested mainly on the two versions listed.
We have new feature suggestions for the configuration page, how do we contact you?
Please send the ThreatPoint team an email at [email@example.com]. We know that the risk decision process can vary — we are interested to hear feedback.
Can I access the API documentation?
Yes, please use the following link to the ThreatPoint API documentation: documentation
Contributors & Developers
“ThreatPoint IP Reputation” is open source software. The following people have contributed to this plugin.Contributors
Interested in development?
Added support to allow bots past country blacklist rules
- tested on 5.8
- Added support to show top 10 blocked IP addresses with geo information on the options page
- Updated logo
- Amended .htaccess rules
- New malicious IP configuration — real time checks against the ThreatPoint network, autopopulate .htaccess
- Brute force login support — GET/POST
- Updated XMLRC configuration to disable via .htaccess
- Fixed email settings
- Included IP address in email body
- Amendment to layout — remove duplicate whitelist entry
- Added notification feature using wp_mail
- Added descriptors to each field
- Added Daiy IP reputation map
- Added feature to disable XMLRPC endpoint
- Cleaned up typo
- update to add action to set priority, where header is set before redirect
- included login to allow page name entry
- admin page now protected by default without needing to modify any page code
- Updated logic and options to include greater control over selection tree
- Amended issue in strpos when array is used
- Added check for empty values to avoid empty needle warning
- Added country whitelist configuration option
- Updated versions tested
- provided redirection link
- Initial release