man > Crypt::Cipher::AES

man perldoc info pydoc3 ri search

🧬 NAME

Crypt::Cipher::AES - Symmetric cipher AES (aka Rijndael), key size: 128/192/256 bits

🚀 Quick Reference

Use Case	Command	Description
🔐 Encrypt data with CBC mode	use Crypt::Mode::CBC; $cbc = Crypt::Mode::CBC->new('AES'); $ciphertext = $cbc->encrypt($data, $key, $iv);	Encrypts plaintext using AES in CBC mode with a 16-byte IV and key of valid size
🔐 Encrypt data with Crypt::CBC (slower)	use Crypt::CBC; use Crypt::Cipher::AES; $cbc = Crypt::CBC->new( -cipher => 'Cipher::AES', -key => $key, -iv => $iv ); $ciphertext = $cbc->encrypt("secret data");	Alternative interface for CBC encryption
🔑 Create cipher object	$c = Crypt::Cipher::AES->new($key);	Instantiate AES cipher with a key (128/192/256 bits)
📏 Get key size	Crypt::Cipher::AES->keysize;	Return the key size in bytes (32 for AES-256)
📦 Get block size	Crypt::Cipher::AES->blocksize;	Return block size in bytes (16)

📝 SYNOPSIS

### example 1
use Crypt::Mode::CBC;

my $key = '...'; # length has to be valid key size for this cipher
my $iv = '...';  # 16 bytes
my $cbc = Crypt::Mode::CBC->new('AES');
my $ciphertext = $cbc->encrypt("secret data", $key, $iv);

### example 2 (slower)
use Crypt::CBC;
use Crypt::Cipher::AES;

my $key = '...'; # length has to be valid key size for this cipher
my $iv = '...';  # 16 bytes
my $cbc = Crypt::CBC->new( -cipher => 'Cipher::AES', -key => $key, -iv => $iv );
my $ciphertext = $cbc->encrypt("secret data");

📖 DESCRIPTION

This module implements the AES cipher. Provided interface is compliant with Crypt::CBC module.

⚠️ BEWARE: This module implements just elementary "one-block-(en|de)cryption" operation - if you want to encrypt/decrypt generic data you have to use some of the cipher block modes - check for example Crypt::Mode::CBC, Crypt::Mode::CTR or Crypt::CBC (which will be slower).

🛠️ METHODS

🆕 new

$c = Crypt::Cipher::AES->new($key);
#or
$c = Crypt::Cipher::AES->new($key, $rounds);

🔒 encrypt

$ciphertext = $c->encrypt($plaintext);

🔓 decrypt

$plaintext = $c->decrypt($ciphertext);

📏 keysize

$c->keysize;
#or
Crypt::Cipher::AES->keysize;
#or
Crypt::Cipher::AES::keysize;

📦 blocksize

$c->blocksize;
#or
Crypt::Cipher::AES->blocksize;
#or
Crypt::Cipher::AES::blocksize;

📐 max_keysize

$c->max_keysize;
#or
Crypt::Cipher::AES->max_keysize;
#or
Crypt::Cipher::AES::max_keysize;

📏 min_keysize

$c->min_keysize;
#or
Crypt::Cipher::AES->min_keysize;
#or
Crypt::Cipher::AES::min_keysize;

🔄 default_rounds

$c->default_rounds;
#or
Crypt::Cipher::AES->default_rounds;
#or
Crypt::Cipher::AES::default_rounds;

👀 SEE ALSO

• • CryptX, Crypt::Cipher
• • https://en.wikipedia.org/wiki/Advanced_Encryption_Standard

perl v5.34.0 2022-02-06 Crypt::Cipher::AES(3pm)

🧬 NAME 🚀 Quick Reference 📝 SYNOPSIS 📖 DESCRIPTION 🛠️ METHODS 👀 SEE ALSO