madmatt / silverstripe-iplists
Create allow and deny lists based on IP addresses
Installs: 946
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 4
Forks: 2
Open Issues: 2
Type:silverstripe-vendormodule
Requires
Requires (Dev)
- phpunit/phpunit: ^5.7
- squizlabs/php_codesniffer: ^3.0
This package is auto-updated.
Last update: 2024-10-22 20:37:43 UTC
README
This module provides the capability for administrators to define IP allow and deny lists, colloquially known as IP whitelist and blacklists.
Installation
composer require madmatt/silverstripe-iplists
vendor/bin/sake dev/build flush=1
Visit /admin/iplists
to define the allow and deny lists that you want.
When not to use this module
It's important to spell out when it's not a good idea to use this module. Specifically, it is not recommended to use this module to block IP addresses that are performing denial of service attacks on your website. This module hooks into Silverstripe CMS, meaning that the whole CMS and framework must boot before checking whether the IP address is allowed to access the website or not (so the website does 70% of the work it would do anyway). A much better way to block these attackers is to use a web application firewall such as Cloudflare, and block the offending IPs from accessing the entire website there.
Configuration
By default, this module does not do anything beyond adding a new middleware into every request. This middleware does nothing on CLI. To have this module be useful, you need to configure one or more IP lists. Each IP list can contain multiple URI location rules, as well as both allow and deny rules to determine who can access the URI location rules you specify.
You can configure lists in two different ways: in the CMS, and with developer-controlled YML files.
CMS configuration
IP lists can be managed in the CMS. As long as you're logged in as an ADMIN
, you'll see an 'IP Lists' menu item, where you can create IP lists, add IPs to it, and configure them as needed.
We recommend setting up an IP allowlist for /admin
and /Security
(if you don't need to allow the general public to login for anything) to ensure your CMS access is protected.
YML configuration
Note: YML configuration is not implemented yet. Use CMS configuration for now. This configuration API is likely to change, please don't trust the below.
The intention with YML configuration is that these IP addresses are never (or 'very rarely') expected to change. For example, add the IP address of your office VPN here, but don't add your home IP - use the CMS interface for this so you can change it easily later.
The below YML config fragment will (eventually) allow 127.0.0.1
and 10.0.0.2
access to login and view the SilverStripe CMS, and will deny 10.0.0.1
from viewing the website at all (despite the IP being in the allow list for the CMS,
Madmatt\IPLists\Model\IPList: admin_allowlist: routes: - /admin - /Security allow: - 127.0.0.1 - 10.0.0.1 - 10.0.0.2 wholesite_deny: routes: - / deny: - 10.0.0.1
Why 'allow' and 'deny' instead of 'whitelist' and 'blacklist'?
- Allow and Deny are more accurate terms than white and black.
- Allow and Deny aren't racist terms.
See also: