Changeset 43046 for trunk/src/wp-admin/includes/file.php

Timestamp:

04/30/2018 08:08:37 PM (7 years ago)

Author:

iandunn

Message:

Privacy: Add cron to delete expired export files to protect privacy.

The primary means of protecting the files is the CSPRN appended to the filename, but there is no reason to keep the files after the data subject has downloaded them, so deleting them provides an additional layer of protection. Previously this was done from wp_privacy_generate_personal_data_export_file(), but that does not guarantee that it will be run regularly, and on smaller sites that could result in export files being exposed for much longer than necessary.

wp_privacy_delete_old_export_files() was moved to a front end file, so that it can be called from cron.php.

This introduces the wp_privacy_export_expiration filter, which allows plugins to customize how long the exports are kept before being deleted.

index.html was added to the $exclusions parameter of list_files() to make sure that it isn't deleted. If it were, then poorly-configured servers would allow the directory to be traversed, exposing all of the exported files.

Props iandunn, desrosj.
See #43546.

File:

• trunk/src/wp-admin/includes/file.php (modified) (5 diffs)

trunk/src/wp-admin/includes/file.php

@@ -2000 +2000 @@
  */
 function wp_privacy_generate_personal_data_export_file( $request_id ) {
-    // Maybe make this a cron job instead.
-    wp_privacy_delete_old_export_files();
-
     if ( ! class_exists( 'ZipArchive' ) ) {
         wp_send_json_error( __( 'Unable to generate export file. ZipArchive not available.' ) );
@@ -2163 +2160 @@
     }
 
-/* translators: Do not translate LINK, EMAIL, SITENAME, SITEURL: those are placeholders. */
+    /** This filter is documented in wp-admin/includes/file.php */
+    $expiration      = apply_filters( 'wp_privacy_export_expiration', 3 * DAY_IN_SECONDS );
+    $expiration_date = date_i18n( get_option( 'date_format' ), time() + $expiration );
+
+/* translators: Do not translate EXPIRATION, LINK, EMAIL, SITENAME, SITEURL: those are placeholders. */
 $email_text = __(
 'Howdy,
 
 Your request for an export of personal data has been completed. You may
-download your personal data by clicking on the link below. This link is
-good for the next 3 days.
+download your personal data by clicking on the link below. For privacy
+and security, we will automatically delete the file on ###EXPIRATION###,
+so please download it before then.
 
 ###LINK###
@@ -2184 +2186 @@
      *
      * The following strings have a special meaning and will get replaced dynamically:
+     * ###EXPIRATION###         The date when the URL will be automatically deleted.
      * ###LINK###               URL of the personal data export file for the user.
      * ###EMAIL###              The email we are sending to.
@@ -2201 +2204 @@
     $site_url = network_home_url();
 
+    $content = str_replace( '###EXPIRATION###', $expiration_date, $content );
     $content = str_replace( '###LINK###', esc_url_raw( $export_file_url ), $content );
     $content = str_replace( '###EMAIL###', $email_address, $content );
@@ -2345 +2349 @@
     return $response;
 }
-
-/**
- * Cleans up export files older than three days old.
- *
- * @since 4.9.6
- */
-function wp_privacy_delete_old_export_files() {
-    $upload_dir   = wp_upload_dir();
-    $exports_dir  = trailingslashit( $upload_dir['basedir'] . '/exports' );
-    $export_files = list_files( $exports_dir );
-
-    foreach( (array) $export_files as $export_file ) {
-        $file_age_in_seconds = time() - filemtime( $export_file );
-
-        if ( 3 * DAY_IN_SECONDS < $file_age_in_seconds ) {
-            @unlink( $export_file );
-        }
-    }
-}