- Installation
- Configure Provider
- Updating your Eloquent Models
- Creating tables to support encrypt columns
- Set encryption key in .env file
- Encrypt existing data
- Decrypt your data in MySQL
Based on https://github.com/devmaster10/mysql-aes-encrypt
Improvements:
- Added improved security by using an unique IV for each encrypted field.
- Added support for multiple encryption methods including: aes-256-cbc
- Added use of MySQL session variables to prevent the encryption key from being outputted when an sql error occures.
- Added laravel 6 support
- Added laravel 7 support (By me)
Laravel 5.x, 6.x & 7.x Database Encryption in mysql side, use native mysql function AES_DECRYPT and AES_ENCRYPT
Auto encrypt and decrypt signed fields/columns in your Model
Can use all functions of Eloquent/Model
You can perform the operations "=>, <',' between ',' LIKE ' in encrypted columns
For laravel 7.x:
$ composer require mrzainulabideen/aesencrypt
For laravel 6.x:
$ composer require mrzainulabideen/aesencrypt:6.0.x-dev
For laravel 5.x:
$ composer require mrzainulabideen/aesencrypt:5.0.x-dev
You'll need to add to add a service provider if you are using Laravel 5.4 or lower or if the encryption is not working, add to following in config/app.php:
'providers' => array(
mrzainulabideen\AESEncrypt\Database\DatabaseServiceProviderEncrypt::class
)
Your models that have encrypted columns, should extend from ModelEncrypt:
namespace App\Models;
use mrzainulabideen\AESEncrypt\Database\Eloquent\ModelEncrypt;
class Person extends ModelEncrypt
{
/**
* The attributes that are encrypted.
*
* @var array
*/
protected $fillableEncrypt = [
'name'
];
}
It adds new features to Schema which you can use in your migrations:
Schema::create('persons', function (Blueprint $table) {
// here you do all columns supported by the schema builder
$table->increments('id')->unsigned;
$table->string('description', 250);
$table ->unsignedInteger('created_by')->nullable();
$table ->unsignedInteger('updated_by')->nullable();
});
// once the table is created use a raw query to ALTER it and add the BLOB, MEDIUMBLOB or LONGBLOB
DB::statement("ALTER TABLE persons ADD name MEDIUMBLOB after id");
});
APP_AESENCRYPT_KEY=yourencryptedkey
APP_AESENCRYPT_MODE=aes-256-cbc
See https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_block_encryption_mode for all available encryption methods.
To publish the config file and view run the following command
php artisan vendor:publish --provider="mrzainulabideen\AESEncrypt\AesEncryptServiceProvider"
In order to use this package with existing data, you must first encrypt all existing columns you want to use.
Note: If the database is allready encrypted, make sure to decrypt it before executing the folowing query.
Always make a back-up before making changes to your data
The easiest and more secure way to use this, is to use this MySQL function when updating your records:
CREATE FUNCTION `aes_encrypt_string` (col blob, aeskey char(255))
RETURNS blob
BEGIN
SET @iv = RANDOM_BYTES(16);
RETURN CONCAT(AES_ENCRYPT(col, aeskey, @iv), ".iv.",@iv);
END
After adding the MySQL function, update your records like so:
SET @@SESSION.block_encryption_mode = 'aes-256-cbc';
SET @AESKEY = 'yourencryptedkey';
UPDATE your_table SET your_column = aes_encrypt_string(your_column, @AESKEY), your_column2 = aes_encrypt_string(your_column2, @AESKEY) WHERE your_column NOT LIKE '%.iv.%';
The folowing code will ensure the only data that isn't encrypted yet will be encrypted, in case you need to run the query multiple times.
If you cannot create MySQL functions you can perform the following but this will use the same IV for every record which is less secure.
SET @@SESSION.block_encryption_mode = 'aes-256-cbc';
SET @AESKEY = 'yourencryptedkey';
SET @iv = RANDOM_BYTES(16);
UPDATE your_table SET your_column = CONCAT(AES_ENCRYPT(your_column, @AESKEY, @iv), ".iv.",@iv), your_column2 = CONCAT(AES_ENCRYPT(your_column2, @AESKEY, @iv), ".iv.",@iv) WHERE your_column NOT LIKE '%.iv.%';
The folowing code will ensure the only data that isn't encrypted yet will be encrypted, in case you need to run the query multiple times.
If you want to decrypt your data using mysql query, you can add this function to your mysql database:
CREATE FUNCTION `aes_decrypt_string` (col blob, aeskey char(255))
RETURNS text
BEGIN
RETURN CAST(AES_DECRYPT(SUBSTRING_INDEX(col, '.iv.', 1), aeskey, SUBSTRING_INDEX(col, '.iv.', -1)) as char);
END
Now when you want to decrypt your mysql you can do so like this:
SET @@SESSION.block_encryption_mode = 'aes-256-cbc';
SET @AESKEY = 'yourencryptedkey';
SELECT *, aes_decrypt_string(yourEncryptedColum, @AESKEY) decryptedColumn, aes_decrypt_string(yourEncryptedColum2, @AESKEY) decryptedColumn2 FROM yourtable;
Or if you cannot or do not want to use a MySQL function you can use the following query
SET @@SESSION.block_encryption_mode = 'aes-256-cbc';
SET @AESKEY = 'yourencryptedkey';
SELECT CAST(AES_DECRYPT(SUBSTRING_INDEX(yourEncryptedColum, '.iv.', 1), @AESKEY, SUBSTRING_INDEX(yourEncryptedColum, '.iv.', -1)) as CHAR) decrypted_column FROM yourtable WHERE yourEncryptedColum LIKE '%.iv.%';