开发者 |
jakemgold
rcbth 10up thinkoomph tlovett1 jeffpaul nomnom99 |
---|---|
更新时间 | 2024年7月9日 18:32 |
捐献地址: | 去捐款 |
PHP版本: | 7.4 及以上 |
WordPress版本: | 6.6 |
版权: | GPL-2.0-or-later |
版权网址: | 版权信息 |
/wp-content/plugins/
directory.Restricted Site Access settings are added to the Reading page, with WordPress’s built in site privacy options. (It was moved there from a separate Privacy settings page in 3.5.)
Most commonly, Restricted Site Access is not compatible with some page caching solutions. While the plugin hooks in as early as it can to check visitor permissions, its important to understand that some page caching plugins generate static output that prevents plugins like Restricted Site Access from ever checking individual visitors. To the extent that sites blocked by this plugin should not need to concern themselves with high scale front end performance, we strongly recommend disabling any page caching solutions while restricting access to your site. Keep in mind that most page caching plugins do not cache the “logged in” experience, anyhow. Also note that the plugin is fully compatible with other caching layers, like the WordPress object cache.
Developers can use the restricted_site_access_is_restricted
filter to override normal restriction behavior. Note that restriction checks happen before WordPress executes any queries; it passes the query request from the global $wp
variable so developers can investigate what the visitor is trying to load.
For instance, to unblock an RSS feed, place the following PHP code in the theme's functions.php file or in a simple plug-in:
`add_filter( 'restricted_site_access_is_restricted', 'my_rsa_feed_override', 10, 2 );
function my_rsa_feed_override( $is_restricted, $wp ) {
// check query variables to see if this is the feed
if ( ! empty( $wp->query_vars['feed'] ) ) {
$is_restricted = false;
}
return $is_restricted;
}`
Visitors that are not logged in or allowed by IP address will not be able to browse your site (though be cautious of page caching plugin incompatibilities, mentioned above). Restricted Site Access does not block access to your "real" files, so direct links to files in your media and uploads folder (for instance) are not blocked. It is also important to remember that IP addresses can be spoofed. Because Restricted Site Access runs as a plug-in, it is subject to any other vulnerabilities present on your site.
Restricted Site Access is not meant to be a top secret data safe, but simply a reliable and convenient way to handle unwanted visitors.
In 7.3.2, two new filters were added that can be utilized to help prevent IP spoofing attacks. The first filter allows you to set up a list of approved proxy IP addresses and the second allows you to set up a list of approved HTTP headers. For any sites that were using Restricted Site Access prior to version 7.5.0, a handful of HTTP headers are trusted by default. To change this, utilize the rsa_trusted_headers
filter to modify the HTTP headers you want to trust. If your site is not running behind a proxy, we recommend doing the following:
add_filter( 'rsa_trusted_headers', '__return_empty_array' );
This will then only use the REMOTE_ADDR
HTTP header to determine the IP address of the visitor. This header can't be spoofed, so this will increase security. Note that this is now the default for all new installs since version 7.5.0.
If your site is running behind a proxy (like a CDN), you usually can't rely on the REMOTE_ADDR
HTTP header, as this will contain the IP address of the proxy, not the user. If your proxy uses static IP addresses, we recommend using the rsa_trusted_proxies
filter to set those trusted IP addresses:
`
add_filter( 'rsa_trusted_proxies', 'my_rsa_trusted_proxies' );
function my_rsa_trusted_proxies( $trusted_proxies = array() ) {
// Set one or more trusted proxy IP addresses.
$proxy_ips = array(
'10.0.0.0/24',
'10.0.0.0/32',
);
$trusted_proxies = array_merge( $trusted_proxies, $proxy_ips );
return array_unique( $trusted_proxies );
}
`
And then use the rsa_trusted_headers
filter to set which HTTP headers you want to trust. Consult with your proxy provider to determine which header(s) they use to hold the original client IP:
`
add_filter( 'rsa_trusted_headers', 'my_rsa_trusted_headers' );
function my_rsa_trusted_headers( $trusted_headers = array() ) {
// Set one or more trusted HTTP headers.
$headers = array(
'HTTP_X_FORWARDED',
'HTTP_FORWARDED',
);
return $headers;
}
`
If your proxy does not use static IP addresses, you can still utilize the rsa_trusted_headers
filter to change which HTTP headers you want to trust.
Page caching plugins often hook into WordPress to quickly serve the last cached output of a page before we can check to see if a visitor’s access should be restricted. Not all page caching plugins behave the same way, but several solutions - including external solutions we might not detect - can cause restricted pages to be publicly served regardless of your settings.
In 6.2.0, the behavior in a multisite install changed from allowing any logged-in user to see a site to checking their role for that specific site. This is a safer default given the varying ways multisite is used; however, if you would prefer to rely on the previous behavior rather than explicitly adding users to each site, place the following PHP code in the theme's functions.php file or in a simple plug-in: ` add_filter( 'restricted_site_access_user_can_access', 'my_rsa_user_can_access' ); function my_rsa_user_can_access( $access ) { if ( is_user_logged_in() ) { return true; } return $access; } `
As of version 7.0.0, CLI integration has been added. To see the available commands, type the following in your WordPress directory:
$ wp rsa
In 7.0.0, the capacity to define a pipe delimited array of whitelisted IP addresses via constant was introduced.
In your wp-config.php
file, you can define the following:
define( 'RSA_IP_WHITELIST', '192.0.0.1|192.0.0.10' );
In 7.1.1, the capacity to programmatically add / remove / set access IPs programmatically was introduced.
The following are valid statements:
Set IPs, ignoring all stored values (but not the constant defined values), if you're going to use the approach with array indices rather than mixing the two.
Restricted_Site_Access::set_ips( array( '192.168.0.1', '192.168.0.2', '192.168.0.3' ) ); Restricted_Site_Access::set_ips( array( 'labelfoo' => '192.168.0.1', 'labelbar' => 192.168.0.2', 'labelbaz' => 192.168.0.3' ) );
Add IPs, if they're not already added.
Restricted_Site_Access::append_ips( array( '192.168.1.5' => 'five', '192.168.1.6' => 'six' ) );
Remove IPs, if they are in the list.
Restricted_Site_Access::remove_ips( array( '192.168.1.2','192.168.1.5','192.168.1.6', ) );
As of version 7.1.0, two constants were introduced that give you the ability to specify if the site should be in restricted mode.
You can force the plugin to be in restricted mode by adding the following to your wp-config.php
file:
define( 'RSA_FORCE_RESTRICTION', true );
Or to ensure your site won't be in restricted mode:
define( 'RSA_FORBID_RESTRICTION', true );
Make sure you add it before the /* That's all, stop editing! Happy blogging. */
line.
Please note that setting RSA_FORCE_RESTRICTION
will override RSA_FORBID_RESTRICTION
if both are set.
When the 'Discourage search engines from indexing this site' option is enabled, it prevents search engines from indexing the site while still permitting access to regular visitors.
When this option is activated, it serves as a barrier to all visitors except those who are authenticated (logged in) or whose IP addresses are included in the 'Unrestricted IP addresses' setting. This restriction applies universally, even to automated crawlers such as search engines.
tj-actions/changed-files
from 32 to 41 (props @dependabot, @iamdharmesh via #297).express
from 4.18.2 to 4.19.2 (props @dependabot, @Sidsector9 via #312).follow-redirects
from 1.15.5 to 1.15.6 (props @dependabot, @Sidsector9 via #312).webpack-dev-middleware
from 5.3.3 to 5.3.4 (props @dependabot, @Sidsector9 via #312).braces
from 3.0.2 to 3.0.3 (props @dependabot, @iamdharmesh via #319).pac-resolver
from 7.0.0 to 7.0.1 (props @dependabot, @iamdharmesh via #319).socks
from 2.7.1 to 2.8.3 (props @dependabot, @iamdharmesh via #319).ws
from 7.5.9 to 7.5.10 (props @dependabot, @iamdharmesh via #319).REMOTE_ADDR
HTTP header by default. Existing installs will still utilize the old list of approved headers but can modify this (and are recommended to) by using the rsa_trusted_headers
filter (props @dkotter, @peterwilsoncc, @dustinrue, @mikhail-net, Darius Sveikauskas via #290).axios
from 0.25.0 to 1.6.2 and @wordpress/scripts
from 23.7.2 to 26.19.0 (props @dependabot, @dkotter via #293).Restricted_Site_Access::append_ips()
method to add IP addresses programatically (props @Sidsector9, @faisal-alvi via #267).word-wrap
from 1.2.3
to 1.2.4
(props @Sidsector9 via #266).semver
from 5.7.1
to 5.7.2
(props @Sidsector9 via #264).tough-cookie
from 4.1.2
to 4.1.3
(props @Sidsector9 via #270).@cypress/request
from 2.88.10
to 2.88.12
(props @Sidsector9 via #270).postcss
from 8.4.18
to 8.4.31
(props @Sidsector9 via #279).@babel/traverse
from 7.20.0
to 7.23.2
(props @Sidsector9 via #279).Cypress
version from 10.3.0
to 13.2.0
(props @iamdharmesh, @Sidsector9 via #276).@10up/cypress-wp-utils
version to 0.2.0
(props @iamdharmesh, @Sidsector9 via #276).@wordpress/env
version from 5.4.0
to 8.7.0
(props @iamdharmesh, @Sidsector9 via #276).@babel/traverse
from 7.20.0 to 7.23.2 (props @dependabot, @Sidsector9 via #282).Active
to Stable
(props @jeffpaul via #244).json5
from 1.0.1
to 1.0.2
(props @Sidsector9 via #241).simple-git
from 3.15.0
to 3.16.0
(props @Sidsector9 via #243).http-cache-semantics
from 4.1.0 to 4.1.1 (props @Sidsector9 via #245).@sideway/formula
from 3.0.0 to 3.0.1 (props @Sidsector9 via #246).webpack
from 5.74.0
to 5.76.1
(props @Sidsector9 via #248).
View historical changelog details here.