307 lines
7.3 KiB
PHP
307 lines
7.3 KiB
PHP
<?php
|
|
/**
|
|
* Class to handle the Status of Jetpack Protect
|
|
*
|
|
* @package automattic/jetpack-protect-plugin
|
|
*/
|
|
|
|
namespace Automattic\Jetpack\Protect;
|
|
|
|
/**
|
|
* Class that handles fetching and caching the Status of vulnerabilities check from the WPCOM servers
|
|
*/
|
|
class Status {
|
|
/**
|
|
* Name of the option where status is stored
|
|
*
|
|
* @var string
|
|
*/
|
|
const OPTION_NAME = '';
|
|
|
|
/**
|
|
* Name of the option where the timestamp of the status is stored
|
|
*
|
|
* @var string
|
|
*/
|
|
const OPTION_TIMESTAMP_NAME = '';
|
|
|
|
/**
|
|
* Time in seconds that the cache should last
|
|
*
|
|
* @var int
|
|
*/
|
|
const OPTION_EXPIRES_AFTER = 3600; // 1 hour.
|
|
|
|
/**
|
|
* Time in seconds that the cache for the initial empty response should last
|
|
*
|
|
* @var int
|
|
*/
|
|
const INITIAL_OPTION_EXPIRES_AFTER = 1 * MINUTE_IN_SECONDS;
|
|
|
|
/**
|
|
* Memoization for the current status
|
|
*
|
|
* @var null|Status_Model
|
|
*/
|
|
public static $status = null;
|
|
|
|
/**
|
|
* Gets the current status of the Jetpack Protect checks
|
|
*
|
|
* @param bool $refresh_from_wpcom Refresh the local plan and status cache from wpcom.
|
|
* @return Status_Model
|
|
*/
|
|
public static function get_status( $refresh_from_wpcom = false ) {
|
|
$use_scan_status = Plan::has_required_plan();
|
|
|
|
if ( defined( 'JETPACK_PROTECT_DEV__DATA_SOURCE' ) ) {
|
|
if ( 'scan_api' === JETPACK_PROTECT_DEV__DATA_SOURCE ) {
|
|
$use_scan_status = true;
|
|
}
|
|
|
|
if ( 'protect_report' === JETPACK_PROTECT_DEV__DATA_SOURCE ) {
|
|
$use_scan_status = false;
|
|
}
|
|
}
|
|
|
|
self::$status = $use_scan_status ? Scan_Status::get_status( $refresh_from_wpcom ) : Protect_Status::get_status( $refresh_from_wpcom );
|
|
return self::$status;
|
|
}
|
|
|
|
/**
|
|
* Checks if the current cached status is expired and should be renewed
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function is_cache_expired() {
|
|
$option_timestamp = get_option( static::OPTION_TIMESTAMP_NAME );
|
|
|
|
if ( ! $option_timestamp ) {
|
|
return true;
|
|
}
|
|
|
|
return time() > (int) $option_timestamp;
|
|
}
|
|
|
|
/**
|
|
* Checks if we should consider the stored cache or bypass it
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function should_use_cache() {
|
|
return defined( 'JETPACK_PROTECT_DEV__BYPASS_CACHE' ) && JETPACK_PROTECT_DEV__BYPASS_CACHE ? false : true;
|
|
}
|
|
|
|
/**
|
|
* Gets the current cached status
|
|
*
|
|
* @return bool|array False if value is not found. Array with values if cache is found.
|
|
*/
|
|
public static function get_from_options() {
|
|
return maybe_unserialize( get_option( static::OPTION_NAME ) );
|
|
}
|
|
|
|
/**
|
|
* Updated the cached status and its timestamp
|
|
*
|
|
* @param array $status The new status to be cached.
|
|
* @return void
|
|
*/
|
|
public static function update_status_option( $status ) {
|
|
// TODO: Sanitize $status.
|
|
update_option( static::OPTION_NAME, maybe_serialize( $status ) );
|
|
$end_date = self::get_cache_end_date_by_status( $status );
|
|
update_option( static::OPTION_TIMESTAMP_NAME, $end_date );
|
|
}
|
|
|
|
/**
|
|
* Returns the timestamp the cache should expire depending on the current status
|
|
*
|
|
* Initial empty status, which are returned before the first check was performed, should be cache for less time
|
|
*
|
|
* @param object $status The response from the server being cached.
|
|
* @return int The timestamp when the cache should expire.
|
|
*/
|
|
public static function get_cache_end_date_by_status( $status ) {
|
|
if ( ! is_object( $status ) || empty( $status->last_checked ) ) {
|
|
return time() + static::INITIAL_OPTION_EXPIRES_AFTER;
|
|
}
|
|
return time() + static::OPTION_EXPIRES_AFTER;
|
|
}
|
|
|
|
/**
|
|
* Delete the cached status and its timestamp
|
|
*
|
|
* @return bool Whether all related status options were successfully deleted.
|
|
*/
|
|
public static function delete_option() {
|
|
$option_deleted = delete_option( static::OPTION_NAME );
|
|
$option_timestamp_deleted = delete_option( static::OPTION_TIMESTAMP_NAME );
|
|
|
|
return $option_deleted && $option_timestamp_deleted;
|
|
}
|
|
|
|
/**
|
|
* Checks the current status to see if there are any threats found
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function has_threats() {
|
|
return 0 < self::get_total_threats();
|
|
}
|
|
|
|
/**
|
|
* Gets the total number of threats found
|
|
*
|
|
* @return integer
|
|
*/
|
|
public static function get_total_threats() {
|
|
$status = static::get_status();
|
|
return isset( $status->num_threats ) && is_int( $status->num_threats ) ? $status->num_threats : 0;
|
|
}
|
|
|
|
/**
|
|
* Get all threats combined
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_all_threats() {
|
|
return array_merge(
|
|
self::get_wordpress_threats(),
|
|
self::get_themes_threats(),
|
|
self::get_plugins_threats(),
|
|
self::get_files_threats(),
|
|
self::get_database_threats()
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get threats found for WordPress core
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_wordpress_threats() {
|
|
return self::get_threats( 'core' );
|
|
}
|
|
|
|
/**
|
|
* Get threats found for themes
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_themes_threats() {
|
|
return self::get_threats( 'themes' );
|
|
}
|
|
|
|
/**
|
|
* Get threats found for plugins
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_plugins_threats() {
|
|
return self::get_threats( 'plugins' );
|
|
}
|
|
|
|
/**
|
|
* Get threats found for files
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_files_threats() {
|
|
return self::get_threats( 'files' );
|
|
}
|
|
|
|
/**
|
|
* Get threats found for plugins
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_database_threats() {
|
|
return self::get_threats( 'database' );
|
|
}
|
|
|
|
/**
|
|
* Get the threats for one type of extension or core
|
|
*
|
|
* @param string $type What threats you want to get. Possible values are 'core', 'themes' and 'plugins'.
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_threats( $type ) {
|
|
$status = static::get_status();
|
|
|
|
if ( 'core' === $type ) {
|
|
return isset( $status->$type ) && ! empty( $status->$type->threats ) ? $status->$type->threats : array();
|
|
}
|
|
|
|
if ( 'files' === $type || 'database' === $type ) {
|
|
return isset( $status->$type ) && ! empty( $status->$type ) ? $status->$type : array();
|
|
}
|
|
|
|
$threats = array();
|
|
if ( isset( $status->$type ) ) {
|
|
foreach ( (array) $status->$type as $item ) {
|
|
if ( ! empty( $item->threats ) ) {
|
|
$threats = array_merge( $threats, $item->threats );
|
|
}
|
|
}
|
|
}
|
|
return $threats;
|
|
}
|
|
|
|
/**
|
|
* Check if the WordPress version that was checked matches the current installed version.
|
|
*
|
|
* @param object $core_check The object returned by Protect wpcom endpoint.
|
|
* @return object The object representing the current status of core checks.
|
|
*/
|
|
protected static function normalize_core_information( $core_check ) {
|
|
global $wp_version;
|
|
|
|
$core = new Extension_Model(
|
|
array(
|
|
'type' => 'core',
|
|
'name' => 'WordPress',
|
|
'version' => $wp_version,
|
|
'checked' => false,
|
|
)
|
|
);
|
|
|
|
if ( isset( $core_check->version ) && $core_check->version === $wp_version ) {
|
|
if ( is_array( $core_check->vulnerabilities ) ) {
|
|
$core->checked = true;
|
|
$core->set_threats( $core_check->vulnerabilities );
|
|
}
|
|
}
|
|
|
|
return $core;
|
|
}
|
|
|
|
/**
|
|
* Sort By Threats
|
|
*
|
|
* @param array<object> $threats Array of threats to sort.
|
|
*
|
|
* @return array<object> The sorted $threats array.
|
|
*/
|
|
protected static function sort_threats( $threats ) {
|
|
usort(
|
|
$threats,
|
|
function ( $a, $b ) {
|
|
// sort primarily based on the presence of threats
|
|
$ret = empty( $a->threats ) <=> empty( $b->threats );
|
|
|
|
// sort secondarily on whether the item has been checked
|
|
if ( ! $ret ) {
|
|
$ret = $a->checked <=> $b->checked;
|
|
}
|
|
|
|
return $ret;
|
|
}
|
|
);
|
|
|
|
return $threats;
|
|
}
|
|
}
|