class backup_migrate_filter_encryption in Backup and Migrate 7.2
Same name and namespace in other branches
- 8.2 includes/filters.encryption.inc \backup_migrate_filter_encryption
- 8.3 includes/filters.encryption.inc \backup_migrate_filter_encryption
- 6.3 includes/filters.encryption.inc \backup_migrate_filter_encryption
- 6.2 includes/filters.encryption.inc \backup_migrate_filter_encryption
- 7.3 includes/filters.encryption.inc \backup_migrate_filter_encryption
A filter for encrypting backup files.
Hierarchy
- class \backup_migrate_filter
Expanded class hierarchy of backup_migrate_filter_encryption
1 string reference to 'backup_migrate_filter_encryption'
- backup_migrate_backup_migrate_filters in includes/
filters.inc - Implementation of hook_backup_migrate_filters().
File
- includes/
filters.encryption.inc, line 14 - A filter for encrypting bckups with AES.
View source
class backup_migrate_filter_encryption extends backup_migrate_filter {
var $op_weights = array(
'backup' => 170,
'restore' => -170,
);
/**
* This function is called on a backup file after the backup has been completed.
*/
function backup($file, &$settings) {
return $this
->file_encrypt($file, $settings);
}
/**
* This function is called on a backup file before importing it.
*/
function restore($file, &$settings) {
return $this
->file_decrypt($file);
}
/**
* Get the form for the settings for this filter.
*/
function backup_settings_default() {
return array(
'encryption' => 'none',
);
}
/**
* Get the form for the settings for this filter.
*/
function backup_settings_form($settings) {
$form = array();
$options = $this
->_backup_migrate_get_encryption_form_item_options();
if (count($options) > 1) {
$form['file']['encryption'] = array(
"#type" => "select",
"#title" => t("File Encryption (EXPERIMENTAL)"),
"#options" => $options,
"#default_value" => @$settings['encryption'],
'#description' => t('Encrypted files can only be restored by Backup and Migrate and only on sites with the same encryption key. <strong>This functionality is experimental, and should only be used for testing.</strong>'),
);
}
else {
$form['file']['encryption'] = array(
"#type" => 'item',
"#title" => t("File Encryption"),
"#markup" => t('Install the !link to enable backup file encryption.', array(
'!link' => l(t('AES Encryption Module'), 'http://drupal.org/project/aes'),
)),
);
}
return $form;
}
/**
* Return a list of backup filetypes.
*/
function file_types() {
return array(
"aes" => array(
"extension" => "aes",
"filemime" => "application/octet-stream",
"backup" => TRUE,
"restore" => TRUE,
),
);
}
/**
* Get the compression options as an options array for a form item.
*/
function _backup_migrate_get_encryption_form_item_options() {
$options = array();
$options = array(
'' => t('No Encryption'),
);
if (@function_exists("aes_encrypt")) {
$options['aes'] = t("AES Encryption");
}
return $options;
}
/**
* AES encrypt a file.
*/
function aes_encrypt($source, $dest) {
$success = FALSE;
if (function_exists('aes_encrypt')) {
if ($data = $source
->get_contents()) {
// Add a marker to the end of the data so we can trim the padding on decrpypt.
$data = pack("a*H2", $data, "80");
if ($data = aes_encrypt($data, FALSE)) {
$dest
->put_contents($data);
$success = TRUE;
}
}
}
return $success;
}
/**
* Gzip decode a file.
*/
function aes_decrypt($source, $dest) {
$success = FALSE;
if (function_exists('aes_decrypt')) {
if ($data = $source
->get_contents()) {
if ($data = aes_decrypt($data, FALSE)) {
// Trim all the padding zeros plus our non-zero marker.
$data = substr(rtrim($data, "\0"), 0, -1);
$dest
->put_contents($data);
$success = TRUE;
}
}
}
return $success;
}
/**
* Compress a file with the given settings.
* Also updates settings to reflect new file mime and file extension.
*/
function file_encrypt($file, $settings) {
if (!empty($settings->filters['encryption'])) {
switch ($settings->filters['encryption']) {
case "aes":
$from = $file
->push_type('aes');
$from = new backup_file(array(
'filepath' => $from,
));
if (!($success = $this
->aes_encrypt($from, $file))) {
$file = NULL;
}
break;
}
if (!$file) {
_backup_migrate_message("Could not encrypt backup file. Try backing up without encryption.", array(), 'error');
}
}
return $file;
}
/**
* Decompress a file with the given settings.
* Also updates settings to reflect new file mime and file extension.
*/
function file_decrypt($file) {
$success = FALSE;
if ($file) {
switch ($file
->type_id()) {
case "aes":
$from = $file
->pop_type();
$success = $this
->aes_decrypt($from, $file);
break;
default:
return $file;
break;
}
if (!$success) {
if (function_exists('aes_decrypt')) {
_backup_migrate_message("Could not decrpyt backup file. Please check that the file is valid and that the encryption key of the server matches the server that created the backup.", array(), 'error');
}
else {
_backup_migrate_message('You must install the !link to restore encrypted backkups.', array(
'!link' => l(t('AES Encryption Module'), 'http://drupal.org/project/aes'),
), 'error');
}
}
}
return $success ? $file : NULL;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
backup_migrate_filter:: |
property | |||
backup_migrate_filter:: |
function | Submit the settings form. Any values returned will be saved. | 1 | |
backup_migrate_filter:: |
function | Get the form for the settings for this filter. | 1 | |
backup_migrate_filter:: |
function | Declare any default destinations for this filter. | 1 | |
backup_migrate_filter:: |
function | This function is called immediately post backup. | 1 | |
backup_migrate_filter:: |
function | This function is called immediately prior to backup. | 1 | |
backup_migrate_filter:: |
function | Get the form for the settings for this filter. | 2 | |
backup_migrate_filter:: |
function | Get the form for the settings for this filter. | 2 | |
backup_migrate_filter:: |
function | Submit the settings form. Any values returned will be saved. | ||
backup_migrate_filter:: |
function | Get the form for the settings for this filter. | ||
backup_migrate_filter:: |
function | Get the weight of the filter for the given op. | ||
backup_migrate_filter_encryption:: |
property |
Overrides backup_migrate_filter:: |
||
backup_migrate_filter_encryption:: |
function | Gzip decode a file. | ||
backup_migrate_filter_encryption:: |
function | AES encrypt a file. | ||
backup_migrate_filter_encryption:: |
function |
This function is called on a backup file after the backup has been completed. Overrides backup_migrate_filter:: |
||
backup_migrate_filter_encryption:: |
function |
Get the form for the settings for this filter. Overrides backup_migrate_filter:: |
||
backup_migrate_filter_encryption:: |
function |
Get the form for the settings for this filter. Overrides backup_migrate_filter:: |
||
backup_migrate_filter_encryption:: |
function | Decompress a file with the given settings. Also updates settings to reflect new file mime and file extension. | ||
backup_migrate_filter_encryption:: |
function | Compress a file with the given settings. Also updates settings to reflect new file mime and file extension. | ||
backup_migrate_filter_encryption:: |
function |
Return a list of backup filetypes. Overrides backup_migrate_filter:: |
||
backup_migrate_filter_encryption:: |
function |
This function is called on a backup file before importing it. Overrides backup_migrate_filter:: |
||
backup_migrate_filter_encryption:: |
function | Get the compression options as an options array for a form item. |