43200, 'daily' => 86400, 'weekly' => 604800, ); /** Der erste Lauf liegt in der Nacht: zwischen 2 und 5 Uhr Ortszeit der Website. */ const NIGHT_START = 2; const NIGHT_HOURS = 3; public static function init() { add_action( self::CRON_HOOK, array( __CLASS__, 'cron' ) ); add_action( self::MORE_HOOK, array( __CLASS__, 'cron' ) ); add_action( 'wp360_sd_settings_saved', array( __CLASS__, 'reschedule' ) ); add_action( 'admin_init', array( __CLASS__, 'maybe_reschedule' ) ); } public static function on_deactivate() { wp_clear_scheduled_hook( self::CRON_HOOK ); wp_clear_scheduled_hook( self::MORE_HOOK ); delete_transient( self::LOCK ); } /** Gewaehlter Rhythmus (WP-Cron-Name); Standard: einmal am Tag. */ public static function interval() { $settings = Wp360_Security_Digest_Settings::get(); $interval = (string) ( $settings['vuln_interval'] ?? 'daily' ); return isset( self::INTERVALS[ $interval ] ) ? $interval : 'daily'; } /** * Wie lange ein Stand frisch ist: zwei Stunden kuerzer als der Rhythmus, * damit der naechste planmaessige Lauf das Paket sicher wieder fragt. Reine Logik. * * @param string $interval Rhythmus aus {@see self::INTERVALS}. */ public static function fresh_for( $interval ): int { $seconds = self::INTERVALS[ $interval ] ?? self::FRESH; return max( 3600, $seconds - 7200 ); } /** * Zeitpunkt des ersten Laufs: die naechste Nacht zwischen 2 und 5 Uhr * Ortszeit, mit Versatz, damit nicht alle Websites gleichzeitig fragen. Reine Logik. * * @param int $now Zeitstempel. * @param DateTimeZone $zone Zeitzone der Website. * @param int $offset Versatz in Sekunden innerhalb des Nachtfensters. */ public static function next_night( $now, DateTimeZone $zone, $offset ): int { $offset = max( 0, min( (int) $offset, self::NIGHT_HOURS * 3600 - 1 ) ); $start = ( new DateTimeImmutable( '@' . (int) $now ) )->setTimezone( $zone )->setTime( self::NIGHT_START, 0 ); $time = $start->getTimestamp() + $offset; if ( $time <= $now ) { $time = $start->modify( '+1 day' )->getTimestamp() + $offset; } return $time; } /** Aeltere Versionen liefen stuendlich: auf den gewaehlten Rhythmus umstellen. */ public static function maybe_reschedule() { $event = wp_get_scheduled_event( self::CRON_HOOK ); if ( $event && $event->schedule !== self::interval() ) { self::reschedule( Wp360_Security_Digest_Settings::get() ); } } public static function enabled() { $settings = Wp360_Security_Digest_Settings::get(); return ! empty( $settings['vuln_enabled'] ); } /** * Lauf im gewaehlten Rhythmus (Standard: einmal pro Nacht), solange der * Abgleich eingeschaltet ist. Er ruft nur ab, was faellig ist. * * @param array $settings Einstellungen. */ public static function reschedule( $settings ) { if ( ! is_array( $settings ) || empty( $settings['vuln_enabled'] ) ) { wp_clear_scheduled_hook( self::CRON_HOOK ); wp_clear_scheduled_hook( self::MORE_HOOK ); return; } $interval = isset( self::INTERVALS[ $settings['vuln_interval'] ?? '' ] ) ? $settings['vuln_interval'] : 'daily'; $event = wp_get_scheduled_event( self::CRON_HOOK ); if ( $event && $event->schedule === $interval ) { return; } wp_clear_scheduled_hook( self::CRON_HOOK ); wp_schedule_event( self::next_night( time(), wp_timezone(), wp_rand( 0, self::NIGHT_HOURS * 3600 - 1 ) ), $interval, self::CRON_HOOK ); } /** Planmaessiger Lauf; was nicht in einen Lauf passt, folgt in Nachlaeufen. */ public static function cron() { $result = self::refresh(); if ( is_array( $result ) && $result['remaining'] > 0 && ! wp_next_scheduled( self::MORE_HOOK ) ) { wp_schedule_single_event( time() + 120, self::MORE_HOOK ); } } /** * Antwort des Dienstes auswerten. Reine Logik. * * @param string $body Antworttext. * @param string $type `plugin`, `theme` oder `core`. * @param string $version Installierte Version; Eintraege, die sie schon hinter * sich hat, werden nicht aufbewahrt. * @return array{known:bool,entries:array>}|null null, wenn die * Antwort nicht lesbar ist. `known` ist false, wenn der Dienst das Paket nicht kennt. */ public static function parse( $body, $type, $version ) { $json = json_decode( (string) $body, true ); $data = is_array( $json ) && isset( $json['data'] ) && is_array( $json['data'] ) ? $json['data'] : null; if ( null === $data || ! array_key_exists( 'vulnerability', $data ) ) { return null; } $list = $data['vulnerability']; if ( null !== $list && ! is_array( $list ) ) { return null; } $list = (array) $list; if ( 'core' === $type ) { // Der Dienst nennt die Treffer fuer genau diese Version, ohne Bereich. // Sie werden zu einem Eintrag zusammengefasst. if ( ! $list ) { return array( 'known' => true, 'entries' => array(), ); } $level = ''; $score = 0.0; foreach ( $list as $item ) { $severity = Wp360_Security_Digest_Version_Range::severity( is_array( $item ) ? ( $item['impact'] ?? null ) : null ); $level = Wp360_Security_Digest_Version_Range::higher( $level, $severity['level'] ); $score = max( $score, $severity['score'] ); } return array( 'known' => true, 'entries' => array( array( 'id' => 'core-' . $version, 'title' => '', 'cve' => '', 'link' => '', 'range' => null, 'count' => count( $list ), 'severity' => $level, 'score' => $score, ), ), ); } if ( ! isset( $data['name'] ) || ! is_string( $data['name'] ) || '' === $data['name'] ) { return array( 'known' => false, 'entries' => array(), ); } $entries = array(); foreach ( $list as $item ) { $range = is_array( $item ) ? Wp360_Security_Digest_Version_Range::normalize( $item['operator'] ?? null ) : null; if ( null === $range ) { return null; } if ( Wp360_Security_Digest_Version_Range::outdated( $version, $range ) ) { continue; } $title = ''; $cve = ''; $link = ''; foreach ( isset( $item['source'] ) && is_array( $item['source'] ) ? $item['source'] : array() as $source ) { if ( ! is_array( $source ) ) { continue; } $id = isset( $source['id'] ) && is_string( $source['id'] ) ? $source['id'] : ''; $name = isset( $source['name'] ) && is_string( $source['name'] ) ? $source['name'] : ''; $url = isset( $source['link'] ) && is_string( $source['link'] ) ? $source['link'] : ''; if ( '' === $cve && 0 === strpos( $id, 'CVE-' ) ) { $cve = $id; $link = $url; } if ( '' === $title && '' !== $name && $name !== $id ) { $title = html_entity_decode( $name, ENT_QUOTES, 'UTF-8' ); } if ( '' === $link ) { $link = $url; } } $severity = Wp360_Security_Digest_Version_Range::severity( $item['impact'] ?? null ); $entries[] = array( 'id' => isset( $item['uuid'] ) && is_string( $item['uuid'] ) && '' !== $item['uuid'] ? $item['uuid'] : md5( implode( '|', array_map( 'strval', $range ) ) . $cve . $title ), 'title' => function_exists( 'mb_substr' ) ? mb_substr( $title, 0, 200 ) : substr( $title, 0, 200 ), 'cve' => $cve, 'link' => $link, 'range' => $range, 'count' => 1, 'severity' => $severity['level'], 'score' => $severity['score'], ); } return array( 'known' => true, 'entries' => $entries, ); } /** * Kann ein gespeicherter Stand fuer die installierte Version noch gelten? * Beim Kern nur fuer genau dieselbe Version, sonst fuer dieselbe oder eine * neuere (aeltere Eintraege wurden beim Speichern verworfen). Reine Logik. * * @param array|null $stored Gespeicherter Stand eines Pakets. * @param string $type `plugin`, `theme` oder `core`. * @param string $version Installierte Version. * @param int $now Zeitstempel. */ public static function usable( $stored, $type, $version, $now ): bool { if ( ! is_array( $stored ) || empty( $stored['fetched_at'] ) || $now - (int) $stored['fetched_at'] > self::KEEP ) { return false; } $known = (string) ( $stored['version'] ?? '' ); return 'core' === $type ? $known === (string) $version : version_compare( (string) $version, $known, '>=' ); } /** * Ist fuer dieses Paket jetzt ein Abruf faellig? Reine Logik. * * @param array|null $stored Gespeicherter Stand eines Pakets. * @param string $type `plugin`, `theme` oder `core`. * @param string $version Installierte Version. * @param int $now Zeitstempel. * @param int $fresh So lange gilt ein Stand als frisch (Sekunden). */ public static function due( $stored, $type, $version, $now, $fresh = self::FRESH ): bool { if ( is_array( $stored ) && $now - (int) ( $stored['tried_at'] ?? 0 ) < self::RETRY ) { return false; } if ( ! self::usable( $stored, $type, $version, $now ) ) { return true; } return $now - (int) $stored['fetched_at'] >= $fresh; } /** * Zustand eines Pakets aus dem gespeicherten Stand. Reine Logik. * * @param array $package Paket aus {@see self::packages()}. * @param array|null $stored Gespeicherter Stand. * @param int $now Zeitstempel. * @return array Paket mit `state` (affected|clean|unchecked), `reason`, `checked_at`, `entries`, `muted`. */ public static function evaluate( array $package, $stored, $now ): array { $row = $package + array( 'state' => 'unchecked', 'checked_at' => 0, 'entries' => array(), 'muted' => array(), ); if ( '' !== $row['reason'] ) { return $row; } if ( ! self::usable( $stored, $package['type'], $package['version'], $now ) ) { // Noch nie gefragt („pending“) oder gefragt, aber ohne brauchbare Antwort. $row['reason'] = is_array( $stored ) && ! empty( $stored['tried_at'] ) ? 'source_error' : 'pending'; return $row; } $row['checked_at'] = (int) $stored['fetched_at']; if ( empty( $stored['known'] ) ) { $row['reason'] = 'unknown'; return $row; } foreach ( (array) ( $stored['entries'] ?? array() ) as $entry ) { if ( null === $entry['range'] || Wp360_Security_Digest_Version_Range::matches( $package['version'], $entry['range'] ) ) { $row['entries'][] = $entry; } } $row['state'] = $row['entries'] ? 'affected' : 'clean'; return $row; } /** * Pakete, die abgeglichen werden: der Kern, jedes Plugin mit eigenem Ordner * und jedes Theme, aktiv oder nicht. * * @return array */ public static function packages() { global $wp_version; if ( ! function_exists( 'get_plugins' ) ) { require_once ABSPATH . 'wp-admin/includes/plugin.php'; } $packages = array( array( 'key' => 'core:wordpress', 'type' => 'core', 'slug' => 'wordpress', 'name' => 'WordPress', 'version' => (string) $wp_version, 'reason' => '', ), ); $seen = array(); foreach ( get_plugins() as $file => $data ) { $dir = dirname( $file ); if ( '.' !== $dir && isset( $seen[ $dir ] ) ) { continue; } $seen[ $dir ] = true; $reason = ''; if ( '.' === $dir ) { // Einzeldatei: Der Dateiname ist nicht der Name im Verzeichnis. $reason = 'single_file'; } elseif ( '' === (string) $data['Version'] ) { $reason = 'no_version'; } else { // Ein Plugin mit eigenem Update-Server kann denselben Ordnernamen wie // ein Plugin im Verzeichnis tragen; dessen Eintraege gelten dann nicht. $update_uri = isset( $data['UpdateURI'] ) ? (string) $data['UpdateURI'] : ''; if ( '' !== $update_uri && false === strpos( $update_uri, 'w.org/' ) && false === strpos( $update_uri, 'wordpress.org/' ) ) { $reason = 'update_uri'; } } $slug = '.' === $dir ? basename( $file, '.php' ) : $dir; $packages[] = array( 'key' => 'plugin:' . $slug, 'type' => 'plugin', 'slug' => $slug, 'name' => (string) $data['Name'], 'version' => (string) $data['Version'], 'reason' => $reason, ); } foreach ( wp_get_themes() as $slug => $theme ) { $version = (string) $theme->get( 'Version' ); $packages[] = array( 'key' => 'theme:' . $slug, 'type' => 'theme', 'slug' => (string) $slug, 'name' => (string) $theme->get( 'Name' ), 'version' => $version, 'reason' => '' === $version ? 'no_version' : '', ); } return $packages; } /** * Ruft ab, was faellig ist: hoechstens {@see self::BATCH} Pakete und * hoechstens {@see self::BUDGET} Sekunden. * * @return array{fetched:int,remaining:int}|WP_Error */ public static function refresh() { if ( ! self::enabled() ) { return new WP_Error( 'wp360_sd_vuln_off', __( 'The vulnerability check is switched off.', '360-orbit-security-digest' ) ); } if ( get_transient( self::LOCK ) ) { return array( 'fetched' => 0, 'remaining' => 0, ); } set_transient( self::LOCK, 1, 2 * MINUTE_IN_SECONDS ); $cache = self::cache(); $packages = self::packages(); $fresh = self::fresh_for( self::interval() ); $started = microtime( true ); $fetched = 0; $remaining = 0; $keys = array(); foreach ( $packages as $package ) { $key = $package['key']; $keys[ $key ] = true; $now = time(); if ( '' !== $package['reason'] || ! self::due( $cache[ $key ] ?? null, $package['type'], $package['version'], $now, $fresh ) ) { continue; } if ( $fetched >= self::BATCH || microtime( true ) - $started > self::BUDGET ) { ++$remaining; continue; } ++$fetched; $body = self::fetch( $package ); $parsed = null === $body ? null : self::parse( $body, $package['type'], $package['version'] ); if ( null === $parsed ) { // Alter Stand bleibt; nur der Fehlversuch wird vermerkt. $cache[ $key ] = isset( $cache[ $key ] ) && is_array( $cache[ $key ] ) ? $cache[ $key ] : array( 'fetched_at' => 0 ); $cache[ $key ]['tried_at'] = $now; continue; } $cache[ $key ] = array( 'version' => $package['version'], 'fetched_at' => $now, 'tried_at' => $now, 'known' => $parsed['known'], 'entries' => $parsed['entries'], ); } // Staende von Paketen, die nicht mehr installiert sind, fallen weg. $cache = array_intersect_key( $cache, $keys ); update_option( self::OPTION, $cache, false ); delete_transient( self::LOCK ); if ( $fetched ) { /** * Der Schwachstellen-Abgleich hat neue Daten geholt. * * @param array $report Bericht wie {@see Wp360_Security_Digest_Vulnerabilities::report()}. */ do_action( 'wp360_sd_vuln_refreshed', self::report() ); } return array( 'fetched' => $fetched, 'remaining' => $remaining, ); } /** * Bericht ueber alle Pakete. * * @return array{checked_at:int,pending:int,packages:array>} */ public static function report() { $cache = self::cache(); $now = time(); $fresh = self::fresh_for( self::interval() ); $report = array( 'checked_at' => 0, 'pending' => 0, 'packages' => array(), ); foreach ( self::packages() as $package ) { $stored = $cache[ $package['key'] ] ?? null; $row = self::evaluate( $package, $stored, $now ); $report['checked_at'] = max( $report['checked_at'], $row['checked_at'] ); if ( '' === $package['reason'] && self::due( $stored, $package['type'], $package['version'], $now, $fresh ) ) { ++$report['pending']; } $report['packages'][] = $row; } /** * Bericht des Schwachstellen-Abgleichs vor der Anzeige (Pro: Stummschaltungen). * * @param array $report Bericht. */ return apply_filters( 'wp360_sd_vuln_report', $report ); } /** * Kurzfassung fuer Digest und Uebersicht. * * @return array{enabled:bool,checked_at:int,affected:int,total:int,failed:int,severity:string,names:string[]} */ public static function summary() { $summary = array( 'enabled' => self::enabled(), 'checked_at' => 0, 'affected' => 0, 'total' => 0, 'failed' => 0, 'severity' => '', 'names' => array(), ); if ( ! $summary['enabled'] ) { return $summary; } $report = self::report(); $summary['checked_at'] = (int) $report['checked_at']; foreach ( $report['packages'] as $package ) { if ( 'unchecked' === $package['state'] && 'source_error' === $package['reason'] ) { ++$summary['failed']; } if ( 'affected' !== $package['state'] ) { continue; } ++$summary['affected']; $summary['names'][] = trim( $package['name'] . ' ' . $package['version'] ); foreach ( $package['entries'] as $entry ) { $summary['total'] += (int) $entry['count']; $summary['severity'] = Wp360_Security_Digest_Version_Range::higher( $summary['severity'], (string) $entry['severity'] ); } } return $summary; } /** * @return array> */ private static function cache() { $cache = get_option( self::OPTION, array() ); return is_array( $cache ) ? $cache : array(); } /** * @param array $package Paket aus {@see self::packages()}. * @return string|null Antworttext; null bei jedem Fehler. */ private static function fetch( array $package ) { $path = 'core' === $package['type'] ? 'core/' . rawurlencode( $package['version'] ) : $package['type'] . '/' . rawurlencode( $package['slug'] ); $response = wp_remote_get( self::BASE_URL . $path . '/', array( 'timeout' => 8, 'user-agent' => '360-Orbit-Security-Digest/' . WP360_SD_VERSION, ) ); if ( is_wp_error( $response ) || 200 !== (int) wp_remote_retrieve_response_code( $response ) ) { return null; } return (string) wp_remote_retrieve_body( $response ); } }