..zip` bzw. * `…/plugin/..zip`. Gesendet werden nur Ordnername und * Version, mit eigenem User-Agent (ohne die Adresse der Website). * - Das Paket wird nie entpackt und nie ausgefuehrt: Jede Datei darin wird * als Datenstrom gelesen und gehasht. Auf der Platte liegt nur das Paket * selbst in einer temporaeren Datei, die danach geloescht wird, auch nach * einem Abbruch (Shutdown-Funktion und Aufraeumen beim naechsten Lauf). * - Standardmaessig aus (Einstellungen `integrity_themes`, in Pro `integrity_zip`). */ if ( ! defined( 'ABSPATH' ) ) { exit; } class Wp360_Security_Digest_Zip_Compare { const THEME_URL = 'https://downloads.wordpress.org/theme/'; const PLUGIN_URL = 'https://downloads.wordpress.org/plugin/'; const TMP_OPTION = 'wp360_sd_zip_tmp'; /** Grenzen gegen uebergrosse Pakete: Paketgroesse, entpackte Groesse, Zahl der Dateien. */ const MAX_ZIP_BYTES = 104857600; const MAX_BYTES = 419430400; const MAX_FILES = 20000; public static function init() { add_filter( 'wp360_sd_integrity_packages', array( __CLASS__, 'add_themes' ) ); add_filter( 'wp360_sd_integrity_expected', array( __CLASS__, 'filter_expected' ), 10, 2 ); } public static function enabled() { return self::themes_enabled() || self::plugins_enabled(); } /** Themes pruefen: kostenloser Schalter, oder in Pro der Paketvergleich. */ public static function themes_enabled() { $settings = Wp360_Security_Digest_Settings::get(); if ( ! empty( $settings['integrity_themes'] ) ) { return true; } return self::plugins_enabled(); } /** Plugins ohne Pruefsummen gegen das Paket pruefen: nur Pro. */ public static function plugins_enabled() { return false; } /** * Haengt die installierten Themes an die Liste der zu pruefenden Pakete. * * @param mixed $packages Pakete aus Wp360_Security_Digest_Integrity::packages(). */ public static function add_themes( $packages ) { if ( ! is_array( $packages ) || ! self::themes_enabled() ) { return $packages; } foreach ( wp_get_themes() as $slug => $theme ) { $version = (string) $theme->get( 'Version' ); $update_uri = (string) $theme->get( 'UpdateURI' ); $foreign = '' !== $update_uri && false === strpos( $update_uri, 'w.org/' ) && false === strpos( $update_uri, 'wordpress.org/' ); $packages[] = array( 'type' => 'theme', 'slug' => (string) $slug, 'name' => (string) $theme->get( 'Name' ), 'version' => $version, 'reason' => $foreign ? 'update_uri' : ( '' === $version ? 'no_checksums' : '' ), ); } return $packages; } /** * Liefert die Soll-Liste aus dem Paket, wenn es fuer das Paket keine * Pruefsummen-Datei gibt. * * @param mixed $expected Bisherige Soll-Liste, null oder WP_Error. * @param mixed $package Paket. * @return array|null|WP_Error */ public static function filter_expected( $expected, $package ) { // Eine vorhandene Liste bleibt. Bei einem Fehler der Quelle wird nicht ausgewichen. if ( null !== $expected || ! is_array( $package ) ) { return $expected; } $type = $package['type'] ?? ''; if ( ! ( 'theme' === $type && self::themes_enabled() ) && ! ( 'plugin' === $type && self::plugins_enabled() ) ) { return $expected; } return self::expected( $package['type'], (string) $package['slug'], (string) $package['version'] ); } /** * Soll-Liste eines Pakets: Pfad => SHA-256. * * @param string $type `theme` oder `plugin`. * @param string $slug Ordnername. * @param string $version Installierte Version. * @return array|null|WP_Error null, wenn WordPress.org diese Version nicht anbietet. */ public static function expected( $type, $slug, $version ) { $key = 'wp360_sd_zip_' . md5( $type . '|' . $slug . '|' . $version ); $cached = get_transient( $key ); if ( is_array( $cached ) ) { return $cached; } if ( 'none' === $cached ) { return null; } self::remove_leftover(); $url = ( 'theme' === $type ? self::THEME_URL : self::PLUGIN_URL ) . rawurlencode( $slug ) . '.' . rawurlencode( $version ) . '.zip'; $tmp = wp_tempnam( 'wp360-sd-zip' ); if ( ! $tmp ) { return new WP_Error( 'wp360_sd_zip_tmp', 'No temporary file.' ); } // Merken, damit die Datei auch nach einem harten Abbruch verschwindet. update_option( self::TMP_OPTION, $tmp, false ); register_shutdown_function( array( __CLASS__, 'remove_leftover' ) ); $response = wp_remote_get( $url, array( 'timeout' => 20, 'stream' => true, 'filename' => $tmp, 'limit_response_size' => self::MAX_ZIP_BYTES, 'user-agent' => '360-Orbit-Security-Digest/' . WP360_SD_VERSION, ) ); if ( is_wp_error( $response ) ) { self::remove_leftover(); return $response; } $code = (int) wp_remote_retrieve_response_code( $response ); if ( 200 !== $code ) { self::remove_leftover(); if ( 404 === $code ) { set_transient( $key, 'none', HOUR_IN_SECONDS ); return null; } return new WP_Error( 'wp360_sd_zip_http', 'HTTP ' . $code ); } $expected = self::hash_zip( $tmp, $slug ); self::remove_leftover(); if ( is_array( $expected ) && 'theme' === $type ) { $expected = self::with_bundled( $expected, $slug ); } if ( is_array( $expected ) ) { set_transient( $key, $expected, HOUR_IN_SECONDS ); } return $expected; } /** * Standard-Themes liefert WordPress im eigenen Paket mit, und dort weichen * einzelne Dateien (style.css, readme.txt) vom Theme-Paket derselben Version * ab. Fuer diese Dateien nennt der Kern eigene Pruefsummen. Eine Datei, die * dazu passt, ist unveraendert. * * @param array $expected Soll-Liste aus dem Theme-Paket. * @param string $slug Ordnername des Themes. * @return array */ private static function with_bundled( array $expected, $slug ) { $bundled = self::bundled( $slug ); if ( ! $bundled ) { return $expected; } $base = trailingslashit( get_theme_root( $slug ) ) . $slug . '/'; $local = array(); foreach ( array_keys( $bundled ) as $path ) { if ( is_file( $base . $path ) && is_readable( $base . $path ) ) { $local[ $path ] = array( 'md5' => (string) md5_file( $base . $path ), 'sha256' => (string) hash_file( 'sha256', $base . $path ), ); } } return self::accept_bundled( $expected, $bundled, $local ); } /** * Nimmt fuer jede Datei, die zur Kern-Pruefsumme passt, deren SHA-256 als * gueltigen Wert in die Soll-Liste auf. Reine Logik. * * @param array $expected Soll-Liste aus dem Theme-Paket. * @param array $bundled Pfad => MD5 aus den Kern-Pruefsummen. * @param array $local Hashes der vorhandenen Dateien. * @return array */ public static function accept_bundled( array $expected, array $bundled, array $local ): array { foreach ( $bundled as $path => $md5 ) { if ( ! isset( $local[ $path ] ) || ! is_string( $md5 ) || ! hash_equals( strtolower( $md5 ), strtolower( $local[ $path ]['md5'] ) ) ) { continue; } $known = isset( $expected[ $path ] ) ? (array) $expected[ $path ] : array(); $known[] = $local[ $path ]['sha256']; $expected[ $path ] = array_values( array_unique( $known ) ); } return $expected; } /** * Pruefsummen der Dateien, die der Kern fuer ein mitgeliefertes Theme nennt. * * @param string $slug Ordnername des Themes. * @return array Pfad im Theme => MD5; leer, wenn der Kern das Theme nicht mitliefert. */ private static function bundled( $slug ) { global $wp_version, $wp_local_package; $locale = is_string( $wp_local_package ) && '' !== $wp_local_package ? $wp_local_package : 'en_US'; $key = 'wp360_sd_zipb_' . md5( $wp_version . '|' . $locale ); $themes = get_transient( $key ); if ( ! is_array( $themes ) ) { $themes = array(); $response = wp_remote_get( add_query_arg( array( 'version' => rawurlencode( (string) $wp_version ), 'locale' => rawurlencode( $locale ), ), 'https://api.wordpress.org/core/checksums/1.0/' ), array( 'timeout' => 15, 'user-agent' => '360-Orbit-Security-Digest/' . WP360_SD_VERSION, ) ); if ( is_wp_error( $response ) || 200 !== (int) wp_remote_retrieve_response_code( $response ) ) { return array(); } $data = json_decode( (string) wp_remote_retrieve_body( $response ), true ); foreach ( is_array( $data ) && isset( $data['checksums'] ) && is_array( $data['checksums'] ) ? $data['checksums'] : array() as $path => $md5 ) { if ( 0 === strpos( (string) $path, 'wp-content/themes/' ) && is_string( $md5 ) ) { $themes[ substr( (string) $path, strlen( 'wp-content/themes/' ) ) ] = $md5; } } set_transient( $key, $themes, HOUR_IN_SECONDS ); } $prefix = $slug . '/'; $out = array(); foreach ( $themes as $path => $md5 ) { if ( 0 === strpos( $path, $prefix ) ) { $out[ substr( $path, strlen( $prefix ) ) ] = $md5; } } return $out; } /** Loescht die temporaere Paketdatei, falls noch eine da ist. */ public static function remove_leftover() { $tmp = get_option( self::TMP_OPTION ); if ( is_string( $tmp ) && '' !== $tmp ) { if ( is_file( $tmp ) ) { wp_delete_file( $tmp ); } delete_option( self::TMP_OPTION ); } } /** * Pfad einer Datei im Paket, relativ zum Paketordner. Reine Logik. * * @param string $name Name des Eintrags im ZIP. * @param string $slug Erwarteter Ordner im ZIP. * @return string Leer fuer Ordner, fremde Ordner und verdaechtige Namen. */ public static function entry_path( $name, $slug ): string { $name = str_replace( '\\', '/', (string) $name ); if ( '' === $name || '/' === substr( $name, -1 ) || false !== strpos( $name, "\0" ) ) { return ''; } $prefix = $slug . '/'; if ( 0 !== strpos( $name, $prefix ) ) { return ''; } $path = substr( $name, strlen( $prefix ) ); foreach ( explode( '/', $path ) as $part ) { if ( '' === $part || '.' === $part || '..' === $part ) { return ''; } } return $path; } /** * Hasht jede Datei eines ZIP-Pakets, ohne es zu entpacken. * * @param string $file Pfad der ZIP-Datei. * @param string $slug Erwarteter Ordner im ZIP. * @return array|WP_Error Pfad => SHA-256. */ public static function hash_zip( $file, $slug ) { if ( ! class_exists( 'ZipArchive' ) ) { return new WP_Error( 'wp360_sd_zip_support', 'ZipArchive is not available.' ); } $zip = new ZipArchive(); if ( true !== $zip->open( $file, ZipArchive::RDONLY ) ) { return new WP_Error( 'wp360_sd_zip_open', 'The package could not be read.' ); } $expected = array(); $bytes = 0; $failed = false; if ( $zip->numFiles > self::MAX_FILES ) { $failed = true; } for ( $i = 0; ! $failed && $i < $zip->numFiles; $i++ ) { $stat = $zip->statIndex( $i ); if ( ! is_array( $stat ) ) { $failed = true; break; } $path = self::entry_path( $stat['name'], $slug ); if ( '' === $path ) { continue; } $bytes += (int) $stat['size']; if ( $bytes > self::MAX_BYTES ) { $failed = true; break; } $stream = $zip->getStream( $stat['name'] ); if ( ! is_resource( $stream ) ) { $failed = true; break; } $context = hash_init( 'sha256' ); hash_update_stream( $context, $stream ); fclose( $stream ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_system_operations_fclose -- Datenstrom aus dem ZIP, keine Datei. $expected[ $path ] = array( hash_final( $context ) ); } $zip->close(); if ( $failed || ! $expected ) { return new WP_Error( 'wp360_sd_zip_content', 'The package could not be read completely.' ); } return $expected; } }