dcit/perl-cryptxPerl-криптографический набор инструментов, предоставляющий симметричные шифры, режимы AEAD, хеш-функции, MAC-алгоритмы, криптографию с открытым ключом, вывод ключей и безопасную генерацию случайных чисел через встроенную библиотеку LibTomCrypt.
CryptX — криптографический инструментарий
CryptX — это точка входа в дистрибутив. В обычном коде подключайте один из конкретных модулей, перечисленных ниже.
## one-shot hashing
use Crypt::Digest qw(digest_data_hex);
my $sha256 = digest_data_hex('SHA256', 'hello world');
## classic AES-CBC encryption with padding
use Crypt::Mode::CBC;
my $cbc = Crypt::Mode::CBC->new('AES');
my $iv = random_bytes(16); # 16-byte AES block-size IV
my $cbc_ciphertext = $cbc->encrypt('hello world', $key, $iv);
## authenticated encryption (AEAD) with AES
use Crypt::AuthEnc::GCM qw(gcm_encrypt_authenticate);
my $key = random_bytes(32); # 32-byte AES-256 key
my $nonce = random_bytes(12); # 12-byte unique nonce
my ($ciphertext, $tag) = gcm_encrypt_authenticate('AES', $key, $nonce, 'header', 'hello world');
## message authentication
use Crypt::Mac::HMAC qw(hmac_hex);
my $mac = hmac_hex('SHA256', $key, 'hello world');
## secure random data + UUID helpers
use Crypt::PRNG qw(random_bytes random_string);
use Crypt::Misc qw(random_v4uuid random_v7uuid);
my $salt = random_bytes(16);
my $token = random_string(24);
my $uuid4 = random_v4uuid();
my $uuid7 = random_v7uuid();
## classic password-based key derivation
use Crypt::KeyDerivation qw(pbkdf2);
my $dk = pbkdf2('password', $salt, 100_000, 'SHA256', 32);
## bare stream cipher (authenticate separately)
use Crypt::Stream::ChaCha;
my $stream = Crypt::Stream::ChaCha->new($key, $nonce);
my $stream_ciphertext = $stream->crypt('hello world');
## modern signatures
use Crypt::PK::Ed25519;
my $signer = Crypt::PK::Ed25519->new->generate_key;
my $sig = $signer->sign_message('hello world');
my $ok = $signer->verify_message($sig, 'hello world');
## key agreement
use Crypt::PK::X25519;
my $alice = Crypt::PK::X25519->new->generate_key;
my $bob = Crypt::PK::X25519->new->generate_key;
my $shared_secret = $alice->shared_secret($bob);
Perl-модули для криптографии, построенные на встроенной библиотеке LibTomCrypt. Дистрибутив также включает Math::BigInt::LTM, бэкенд для Math::BigInt, построенный на встроенной библиотеке LibTomMath, используемой внутри LibTomCrypt.
Этот модуль в основном служит верхнеуровневой страницей дистрибутива/документации. Для реальной работы используйте один из конкретных модулей, перечисленных ниже.
Для новых разработок предпочитайте аутентифицированное шифрование (AEAD) обычным режимам шифрования:
random_bytes, random_bytes_hex, random_bytes_b64, random_bytes_b64u, random_string и random_string_from покрывают большинство случаев использования. ООП-API и обёртки для конкретных алгоритмов (Crypt::PRNG::ChaCha20, Crypt::PRNG::Fortuna, и т.д.) предназначены в основном для детерминированных потоков или совместимости с конкретным PRNG.random_v4uuid для непрозрачных случайных идентификаторов. Используйте random_v7uuid, когда нужны примерно упорядоченные по времени идентификаторы, сортируемые по времени создания с точностью до миллисекунд. UUID — это идентификаторы, а не замена секретным случайным байтам.Поточные шифры шифруют данные побайтово без выравнивания блоков. Для большинства приложений предпочитайте режим AEAD (см. выше), который объединяет шифрование с аутентификацией. Используйте «голые» поточные шифры только тогда, когда вы обрабатываете аутентификацию отдельно.
Используйте их только когда аутентификация обрабатывается отдельно или не нужна:
Отдельные модули Crypt::Cipher::AES, Crypt::Cipher::Twofish и т.д. реализуют сырое шифрование одиночных блоков и редко используются напрямую. Почти во всех случаях вместо этого следует использовать их через режим AEAD (Crypt::AuthEnc::GCM, Crypt::AuthEnc::CCM) или режим блочного шифрования (Crypt::Mode::CBC, Crypt::Mode::CTR). При выборе шифра AES является вариантом по умолчанию; он аппаратно ускоряется на большинстве современных CPU.
Используйте Crypt::Checksum::CRC32 и Crypt::Checksum::Adler32 только для невраждебных проверок целостности, таких как обнаружение случайного повреждения. Они не являются криптографическими механизмами целостности или подлинности. Для криптографического использования предпочитайте Crypt::Digest, Crypt::Mac или режим AEAD из Crypt::AuthEnc.
Большинство модулей CryptX сообщают об ошибках вызовом croak (из Carp). Недопустимые параметры, неподдерживаемые алгоритмы, неверные размеры ключей, повреждённые входные данные и внутренние сбои библиотеки обычно приводят к croak с описательным сообщением. Перехватывайте исключения с помощью eval или Try::Tiny.
Некоторые вспомогательные функции проверочного типа возвращают значение вместо croak. Самые важные примеры — функции *_decrypt_verify в модулях аутентифицированного шифрования Crypt::AuthEnc::*. Они возвращают undef, когда аутентификация не удалась, указывая, что шифротекст был изменён или использован неверный ключ/nonce. Некоторые помощники парсинга/декодирования в других модулях также возвращают undef или false для повреждённого ввода, поэтому при необходимости точной семантики ошибок обращайтесь к POD конкретного модуля.
Семейные модули верхнего уровня
Crypt::Cipher, Crypt::Mode, Crypt::AuthEnc, Crypt::Digest, Crypt::Mac, Crypt::Checksum, Crypt::PRNG, Crypt::PK, Crypt::KeyDerivation, Crypt::Misc, Crypt::ASN1
Симметричные шифры
Crypt::Cipher::AES, Crypt::Cipher::Anubis, Crypt::Cipher::ARIA, Crypt::Cipher::Blowfish, Crypt::Cipher::Camellia, Crypt::Cipher::CAST5, Crypt::Cipher::DES, Crypt::Cipher::DES_EDE, Crypt::Cipher::IDEA, Crypt::Cipher::KASUMI, Crypt::Cipher::Khazad, Crypt::Cipher::MULTI2, Crypt::Cipher::Noekeon, Crypt::Cipher::RC2, , , , , , , , , , , , ,
Эти низкоуровневые функции раскрывают детали сборки встроенной библиотеки LibTomCrypt. Они предназначены для устранения неполадок и сообщений об ошибках, а не для повседневного использования.
my $str = CryptX::ltc_build_settings();
Возвращает многострочную строку, описывающую все параметры времени компиляции, которые были включены при сборке встроенной библиотеки LibTomCrypt (шифры, хеши, MAC, алгоритмы PK, флаги компилятора и т. д.).
my $name = CryptX::ltc_mp_name();
# e.g. "LTM" (LibTomMath)
Возвращает имя используемого математического бэкенда.
my $bits = CryptX::ltc_mp_bits_per_digit();
# e.g. 60
Возвращает количество бит на цифру, используемое математическим провайдером.
Частью CryptX является Math::BigInt::LTM, бэкенд Math::BigInt, основанный на встроенной библиотеке LibTomMath. Он отделён от криптографических API, описанных выше, но поставляется в том же дистрибутиве и использует тот же движок больших целых чисел, на который опирается LibTomCrypt.
Эта программа является свободным программным обеспечением; вы можете распространять и/или изменять её на тех же условиях, что и сам Perl.
Copyright (c) 2013-2026 DCIT, a.s. https://www.dcit.cz / Karel Miko
Режимы блочного шифрования
Crypt::Mode::CBC, Crypt::Mode::CFB, Crypt::Mode::CTR, Crypt::Mode::ECB, Crypt::Mode::OFB
Поточные шифры
Crypt::Stream::RC4, Crypt::Stream::ChaCha, Crypt::Stream::XChaCha, Crypt::Stream::Salsa20, Crypt::Stream::XSalsa20, Crypt::Stream::Sober128, Crypt::Stream::Sosemanuk, Crypt::Stream::Rabbit
Режимы аутентифицированного шифрования
Crypt::AuthEnc::CCM, Crypt::AuthEnc::EAX, Crypt::AuthEnc::GCM, Crypt::AuthEnc::GCMSIV, Crypt::AuthEnc::OCB, Crypt::AuthEnc::ChaCha20Poly1305, Crypt::AuthEnc::XChaCha20Poly1305, Crypt::AuthEnc::SIV
Хеш-функцииCrypt::Digest::BLAKE2b_160, Crypt::Digest::BLAKE2b_256, Crypt::Digest::BLAKE2b_384, Crypt::Digest::BLAKE2b_512, Crypt::Digest::BLAKE2s_128, Crypt::Digest::BLAKE2s_160, Crypt::Digest::BLAKE2s_224, Crypt::Digest::BLAKE2s_256, Crypt::Digest::CHAES, Crypt::Digest::MD2, Crypt::Digest::MD4, Crypt::Digest::MD5, Crypt::Digest::RIPEMD128, Crypt::Digest::RIPEMD160, Crypt::Digest::RIPEMD256, Crypt::Digest::RIPEMD320, Crypt::Digest::SHA1, Crypt::Digest::SHA224, Crypt::Digest::SHA256, Crypt::Digest::SHA384, Crypt::Digest::SHA512, Crypt::Digest::SHA512_224, Crypt::Digest::SHA512_256, Crypt::Digest::Tiger192, Crypt::Digest::Whirlpool, Crypt::Digest::Keccak224, Crypt::Digest::Keccak256, Crypt::Digest::Keccak384, Crypt::Digest::Keccak512, Crypt::Digest::SHA3_224, Crypt::Digest::SHA3_256, Crypt::Digest::SHA3_384, Crypt::Digest::SHA3_512, Crypt::Digest::SHAKE, Crypt::Digest::TurboSHAKE, Crypt::Digest::KangarooTwelve, Crypt::Digest::SM3
Контрольные суммы
Коды аутентификации сообщений
Crypt::Mac::BLAKE2b, Crypt::Mac::BLAKE2s, Crypt::Mac::F9, Crypt::Mac::HMAC, Crypt::Mac::KMAC, Crypt::Mac::OMAC, Crypt::Mac::Pelican, Crypt::Mac::PMAC, Crypt::Mac::XCBC, Crypt::Mac::Poly1305
Криптография с открытым ключом
Crypt::PK::RSA, Crypt::PK::DSA, Crypt::PK::ECC, Crypt::PK::DH, Crypt::PK::Ed25519, Crypt::PK::X25519, Crypt::PK::Ed448, Crypt::PK::X448
Криптографически стойкие генераторы случайных чисел
Crypt::PRNG::Fortuna, Crypt::PRNG::Yarrow, Crypt::PRNG::RC4, Crypt::PRNG::Sober128, Crypt::PRNG::ChaCha20
Функции формирования ключей
Парсер ASN.1
Используйте Crypt::ASN1 только тогда, когда вам нужен собственный разбор или кодирование ASN.1 / DER.
Большинство распространённых форматов ключей и сертификатов уже обрабатываются модулями PK.
Прочие вспомогательные функции
Crypt::Misc (кодеки base64/base32/base58, помощники PEM, сравнение за постоянное время, генерация UUID, вспомогательные функции инкремента октетов и связанные утилиты)