MagicCrypt is a Java/PHP/NodeJS library to encrypt/decrpyt strings, files, or data, using Data Encryption Standard(DES) or Advanced Encryption Standard(AES) algorithms. It supports CBC block cipher mode, PKCS5 padding and 64, 128, 192 or 256-bits key length. If the encrypted data is a string, it will be formatted automatically to Base64.

MagicCrypt class is in the org.magiclen.magiccrypt package. It can help you encrypt/decrpyt strings, files, or data, using Data Encryption Standard(DES) or Advanced Encryption Standard(AES) algorithms.

You have to input your DES/AES key and key length to construct MagicCrypt object. For example,

final MagicCrypt mc = new MagicCrypt("magickey", 256);

Note. MagicCrypt only supports 64(DES), 128, 192 and 256-bits key length. The larger key length, the stronger security of course. The default length is 128 bits. If you want to use 192 or 256 bits in your Java Runtime Machine (JRE), you have to install Java Cryptography Extension (JCE) first.

By the way, if you want to change Initialization Vector(IV), you can set it by passing your IV string into the third parameter to the constructor of MagicCrypt object.

You can use encrypt method to encrypt any string, file, or data. For example,

final MagicCrypt mc = new MagicCrypt("magickey", 256);
System.out.println(mc.encrypt("http://magiclen.org"));

The result is,

DS/2U8royDnJDiNY2ps3f6ZoTbpZo8ZtUGYLGEjwLDQ=

You can use decrypt method to decrypt any encrypted string or data. For example,

final MagicCrypt mc = new MagicCrypt("magickey", 256);
System.out.println(mc.decrypt("DS/2U8royDnJDiNY2ps3f6ZoTbpZo8ZtUGYLGEjwLDQ="));

The result is,

http://magiclen.org

If you want to observe the progress when MagicCrypt is running. You can add your listener object which implemented the interface CryptListener in the Crypt class in the org.magiclen.magiccrypt.lib package to MagicCrypt's encrypt or decrypt method as a parameter.

For example, if you want to encrypt a file, you can write the code as below,

final File from = new File("/home/magiclen/plainFile");
final File to = new File("/home/magiclen/encryptedFile");
final MagicCrypt mc = new MagicCrypt("magickey", 192);
mc.encrypt(from, to, new Crypt.CryptListener() {
    @Override
    public void onStarted(final long totalBytes) {
    }

    @Override
    public boolean onRunning(final long currentBytes, final long totalBytes) {
        return true; // return false to stop
    }

    @Override
    public void onFinished(final long finishedBytes, final long totalBytes) {
    }
});

Base64 class is in the org.magiclen.magiccrypt package. It is a clone of an implementation of Base64 in Java 8 SE adjusted for the old Java versions lower than 8.

require of include MagicCrypt.php into your PHP program. Then, you have to input your DES/AES key and key length to construct MagicCrypt object. For example,

require('MagicCrypt.php');
use org\magiclen\magiccrypt\MagicCrypt;

$mc = new MagicCrypt('magickey', 256);

If you want to change Initialization Vector(IV), you can set it by passing your IV string into the third parameter to the constructor of MagicCrypt object.

You can use encrypt method to encrypt any string. For example,

$mc = new MagicCrypt('magickey', 256);
echo $mc->encrypt('http://magiclen.org');

The result is,

DS/2U8royDnJDiNY2ps3f6ZoTbpZo8ZtUGYLGEjwLDQ=

You can use decrypt method to decrypt any encrypted string. For example,

$mc = new MagicCrypt('magickey', 256);
echo $mc->decrypt('DS/2U8royDnJDiNY2ps3f6ZoTbpZo8ZtUGYLGEjwLDQ=');

The result is,

http://magiclen.org

MagicCrypt on Node.js requires crypto, mhash and long modules. You can install them by using npm.

npm install crypto mhash long

In your Node.js program, you should use require function to include MagicCrypt.js.

var MagicCrypt = require('/path/to/MagicCrypt.js');

Then, input your DES/AES key and key length to create an instance of MagicCrypt.

var mc = new MagicCrypt(key, bit, iv);

You can use encrypt method to encrypt any string. For example,

var mc = new MagicCrypt('magickey', 256);
console.log(mc.encrypt('http://magiclen.org'));

The result is,

DS/2U8royDnJDiNY2ps3f6ZoTbpZo8ZtUGYLGEjwLDQ=

You can use decrypt method to decrypt any encrypted string. For example,

var mc = new MagicCrypt('magickey', 256);
console.log(mc.decrypt('DS/2U8royDnJDiNY2ps3f6ZoTbpZo8ZtUGYLGEjwLDQ='));

The result is,

http://magiclen.org

Copyright 2015-2017 magiclen.org

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Please check out our web page at

https://magiclen.org/aes/