नाम

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);

विवरण

बंडल की गई LibTomCrypt लाइब्रेरी पर निर्मित Perl क्रिप्टोग्राफ़िक मॉड्यूल। वितरण में Math::BigInt::LTM भी शामिल है, जो Math::BigInt बैकएंड है जो बंडल की गई LibTomMath लाइब्रेरी पर निर्मित है और LibTomCrypt द्वारा आंतरिक रूप से उपयोग किया जाता है।

यह मॉड्यूल मुख्य रूप से शीर्ष-स्तरीय वितरण/दस्तावेज़ीकरण पृष्ठ के रूप में कार्य करता है। वास्तविक कार्य के लिए, नीचे सूचीबद्ध ठोस मॉड्यूलों में से एक का उपयोग करें।

एल्गोरिदम चयन मार्गदर्शिका

प्रमाणित एन्क्रिप्शन (AEAD)

नए डिज़ाइनों के लिए, नंगे सिफर मोड की तुलना में प्रमाणित एन्क्रिप्शन (AEAD) को प्राथमिकता दें:

ChaCha20-Poly1305 (Crypt::AuthEnc::ChaCha20Poly1305) - तेज़, स्थिर-समय (constant-time), व्यापक रूप से तैनात (TLS 1.3, WireGuard, SSH)। इसे डिफ़ॉल्ट AEAD विकल्प के रूप में उपयोग करें।
XChaCha20-Poly1305 (Crypt::AuthEnc::XChaCha20Poly1305) - विस्तारित 24-बाइट नॉन्स वैरिएंट। जब नॉन्स यादृच्छिक रूप से उत्पन्न किए जाते हैं तो ChaCha20-Poly1305 से अधिक इसे प्राथमिकता दें।
AES-GCM (Crypt::AuthEnc::GCM) - AES के लिए मानक AEAD मोड। आधुनिक CPUs पर हार्डवेयर-त्वरित। अद्वितीय नॉन्स की आवश्यकता होती है; नॉन्स का पुनः उपयोग सुरक्षा को पूरी तरह से तोड़ देता है।
AES-SIV (Crypt::AuthEnc::SIV) - डिटर्मिनिस्टिक AEAD, नॉन्स-दुरुपयोग प्रतिरोधी। जब नॉन्स की विशिष्टता की गारंटी नहीं दी जा सकती तो थोड़ा धीमा लेकिन अधिक सुरक्षित।
AES-GCM-SIV (Crypt::AuthEnc::GCMSIV) - नॉन्स-दुरुपयोग-प्रतिरोधी AEAD (RFC 8452)। AES-SIV से तेज़; इसे तब चुनें जब आपको नॉन्स-पुनःउपयोग सुरक्षा के साथ GCM-जैसा प्रदर्शन चाहिए।
AES-OCB (Crypt::AuthEnc::OCB) - बहुत तेज़ सिंगल-पास AEAD। अपने क्षेत्राधिकार के लिए पेटेंट स्थिति जाँचें।
AES-EAX (Crypt::AuthEnc::EAX) - CTR+OMAC पर आधारित टू-पास AEAD। कोई पेटेंट नहीं, कोई नॉन्स-लंबाई प्रतिबंध नहीं।
AES-CCM (Crypt::AuthEnc::CCM) - WiFi (WPA2) और ब्लूटूथ में उपयोग किया जाता है। प्लेनटेक्स्ट की लंबाई पहले से जानने की आवश्यकता होती है।

क्रिप्टोग्राफ़िक रूप से सुरक्षित यादृच्छिकता और UUID

यादृच्छिक बाइट्स / स्ट्रिंग्स (Crypt::PRNG) - इसे सॉल्ट, कुंजियों, नॉन्स, टोकन और किसी भी अन्य गुप्त यादृच्छिक मान के लिए उपयोग करें। कार्यात्मक सहायक random_bytes, random_bytes_hex, random_bytes_b64, random_bytes_b64u, random_string, और random_string_from अधिकांश उपयोग मामलों को कवर करते हैं। OO API और एल्गोरिदम-विशिष्ट रैपर (Crypt::PRNG::ChaCha20, Crypt::PRNG::Fortuna, आदि) मुख्य रूप से डिटर्मिनिस्टिक स्ट्रीम या किसी विशिष्ट PRNG के साथ इंटरऑपरेबिलिटी के लिए हैं।
UUID ("random_v4uuid" Crypt::Misc में, "random_v7uuid" Crypt::Misc में) - अपारदर्शी यादृच्छिक पहचानकर्ताओं के लिए random_v4uuid का उपयोग करें। जब आप लगभग समय-क्रमित पहचानकर्ता चाहते हैं जो मिलीसेकंड ग्रैन्युलैरिटी पर निर्माण समय के अनुसार क्रमबद्ध होते हैं तो random_v7uuid का उपयोग करें। UUID पहचानकर्ता हैं, गुप्त यादृच्छिक बाइट्स के विकल्प नहीं।

स्ट्रीम सिफर

स्ट्रीम सिफर डेटा को ब्लॉक पैडिंग के बिना बाइट-दर-बाइट एन्क्रिप्ट करते हैं। अधिकांश अनुप्रयोगों के लिए AEAD मोड (ऊपर देखें) को प्राथमिकता दें, जो एन्क्रिप्शन को प्रमाणीकरण के साथ जोड़ता है। नंगे स्ट्रीम सिफर का उपयोग केवल तभी करें जब आप प्रमाणीकरण को अलग से संभालते हैं।

ChaCha (Crypt::Stream::ChaCha) - डिफ़ॉल्ट स्ट्रीम सिफर विकल्प। अंतर्निहित MAC के बिना ChaCha20-Poly1305 के समान कोर।
XChaCha (Crypt::Stream::XChaCha) - ChaCha का विस्तारित 24-बाइट नॉन्स वैरिएंट। जब नॉन्स यादृच्छिक रूप से उत्पन्न किए जाते हैं तो इसे प्राथमिकता दें।
Salsa20 / XSalsa20 (Crypt::Stream::Salsa20, Crypt::Stream::XSalsa20) - ChaCha का पूर्ववर्ती। नए डिज़ाइनों के लिए ChaCha को प्राथमिकता दें; Salsa20 केवल इंटरऑपरेबिलिटी के लिए (जैसे NaCl/libsodium)।
RC4 (Crypt::Stream::RC4) - टूटा हुआ; नए डिज़ाइनों के लिए उपयोग न करें। केवल विरासत इंटरऑपरेबिलिटी के लिए प्रदान किया गया।
Rabbit, Sober128, Sosemanuk (Crypt::Stream::Rabbit, Crypt::Stream::Sober128, Crypt::Stream::Sosemanuk) - eSTREAM पोर्टफोलियो के विशेष-उद्देश्य सिफर। ChaCha का उपयोग करें जब तक कि कोई विशिष्ट प्रोटोकॉल इनमें से किसी एक की आवश्यकता न करे।

ब्लॉक सिफर मोड (प्रमाणीकरण के बिना)

इनका उपयोग केवल तब करें जब प्रमाणीकरण अलग से संभाला जाता है या आवश्यक नहीं है:

CTR (Crypt::Mode::CTR) - ब्लॉक सिफर को स्ट्रीम सिफर में बदलता है। समानांतर किया जा सकता है।
CBC (Crypt::Mode::CBC) - क्लासिक मोड, पैडिंग की आवश्यकता होती है। CTR या AEAD मोड को प्राथमिकता दें।
ECB (Crypt::Mode::ECB) - अधिकांश उपयोगों के लिए असुरक्षित। प्रत्येक ब्लॉक स्वतंत्र रूप से एन्क्रिप्ट किया जाता है।

व्यक्तिगत Crypt::Cipher::AES, Crypt::Cipher::Twofish, आदि मॉड्यूल कच्चे सिंगल-ब्लॉक एन्क्रिप्शन लागू करते हैं और शायद ही कभी सीधे उपयोग किए जाते हैं। लगभग सभी मामलों में आपको उन्हें AEAD मोड (Crypt::AuthEnc::GCM, Crypt::AuthEnc::CCM) या ब्लॉक सिफर मोड (Crypt::Mode::CBC, Crypt::Mode::CTR) के माध्यम से उपयोग करना चाहिए। सिफर चुनते समय, AES डिफ़ॉल्ट है; यह अधिकांश आधुनिक CPUs पर हार्डवेयर-त्वरित है।

हैश फ़ंक्शन

SHA-256 / SHA-384 / SHA-512 (Crypt::Digest::SHA256, आदि) - सामान्य हैशिंग के लिए डिफ़ॉल्ट विकल्प। व्यापक रूप से समर्थित और अच्छी तरह से विश्लेषित।
SHA3-256 / SHA3-512 (Crypt::Digest::SHA3_256, आदि) - पूरी तरह से अलग निर्माण (Keccak स्पंज) के साथ SHA-2 का विकल्प।
BLAKE2b / BLAKE2s (Crypt::Digest::BLAKE2b_256, आदि) - बहुत तेज़, विशेष रूप से सॉफ़्टवेयर में। 64-बिट प्लेटफ़ॉर्म के लिए BLAKE2b, 32-बिट के लिए BLAKE2s।
SHAKE / TurboSHAKE / KangarooTwelve - एक्सटेंडेबल-आउटपुट फ़ंक्शन (XOFs)। जब आपको परिवर्तनीय-लंबाई आउटपुट की आवश्यकता हो तो उपयोग करें।

चेकसम

Crypt::Checksum::CRC32 और Crypt::Checksum::Adler32 का उपयोग केवल गैर-प्रतिकूल अखंडता जाँचों जैसे आकस्मिक भ्रष्टाचार का पता लगाने के लिए करें। वे क्रिप्टोग्राफ़िक अखंडता या प्रामाणिकता तंत्र नहीं हैं। क्रिप्टोग्राफ़िक उपयोग के लिए, Crypt::Digest, Crypt::Mac, या Crypt::AuthEnc से AEAD मोड को प्राथमिकता दें।

संदेश प्रमाणीकरण कोड

HMAC (Crypt::Mac::HMAC) - मानक MAC निर्माण। किसी भी हैश के साथ काम करता है। डिफ़ॉल्ट के रूप में HMAC-SHA256 का उपयोग करें।
Poly1305 (Crypt::Mac::Poly1305) - वन-टाइम MAC, बहुत तेज़। ChaCha20-Poly1305 के भाग के रूप में उपयोग किया जाता है। प्रति संदेश अद्वितीय कुंजी की आवश्यकता होती है।
BLAKE2b-MAC (Crypt::Mac::BLAKE2b) - कीड BLAKE2। सॉफ़्टवेयर में HMAC-SHA256 से तेज़।
CMAC/OMAC (Crypt::Mac::OMAC) - ब्लॉक-सिफर-आधारित MAC। तब उपयोग करें जब आपके पास पहले से AES हो लेकिन हैश फ़ंक्शन न हो।

पब्लिक-कुंजी क्रिप्टोग्राफ़ी

Ed25519 (Crypt::PK::Ed25519) - आधुनिक डिजिटल हस्ताक्षर। तेज़, स्थिर-समय, छोटी कुंजियाँ/हस्ताक्षर। नई हस्ताक्षर योजनाओं के लिए डिफ़ॉल्ट विकल्प।
Ed448 (Crypt::PK::Ed448) - Ed25519 से अधिक सुरक्षा मार्जिन (~224-बिट बनाम ~128-बिट)।
X25519 (Crypt::PK::X25519) - एलिप्टिक-कर्व Diffie-Hellman कुंजी समझौता। कुंजी विनिमय के लिए डिफ़ॉल्ट विकल्प।
X448 (Crypt::PK::X448) - X25519 से अधिक सुरक्षा मार्जिन।
ECDSA (Crypt::PK::ECC) - व्यापक रूप से उपयोग किया जाता है (TLS, Bitcoin)। नए डिज़ाइनों के लिए Ed25519 को प्राथमिकता दें जब तक कि इंटरऑपरेबिलिटी के लिए ECDSA आवश्यक न हो।
RSA (Crypt::PK::RSA) - विरासत लेकिन बहुत व्यापक रूप से उपयोग किया जाता है। न्यूनतम 2048-बिट कुंजियाँ उपयोग करें, 4096-बिट अधिमानित। एन्क्रिप्शन के लिए OAEP और हस्ताक्षरों के लिए PSS को प्राथमिकता दें।
DSA (Crypt::PK::DSA) - विरासत। Ed25519 या ECDSA को प्राथमिकता दें।
DH (Crypt::PK::DH) - क्लासिक Diffie-Hellman। नए डिज़ाइनों के लिए X25519 को प्राथमिकता दें।

कुंजी व्युत्पत्ति / पासवर्ड हैशिंग

HKDF ("hkdf" Crypt::KeyDerivation में) - एक्सट्रैक्ट-फिर-एक्सपैंड KDF। साझा रहस्यों से कुंजियाँ व्युत्पन्न करने के लिए उपयोग करें (जैसे ECDH के बाद)।
Argon2 ("argon2_pbkdf" Crypt::KeyDerivation में) - मेमोरी-हार्ड पासवर्ड हैशिंग। पासवर्ड भंडारण के लिए अनुशंसित विकल्प।
Bcrypt ("bcrypt_pbkdf" Crypt::KeyDerivation में) - मुख्य रूप से उन प्रारूपों और प्रोटोकॉल के साथ संगतता के लिए उपयोग करें जिन्हें विशेष रूप से bcrypt-आधारित कुंजी व्युत्पत्ति की आवश्यकता होती है (उदाहरण के लिए कुछ OpenSSH वर्कफ़्लो)। नए पासवर्ड-भंडारण डिज़ाइनों के लिए Argon2 को प्राथमिकता दें।
Scrypt ("scrypt_pbkdf" Crypt::KeyDerivation में) - मेमोरी-हार्ड KDF। उपलब्ध होने पर Argon2 का उपयोग करें।
PBKDF2 ("pbkdf2" Crypt::KeyDerivation में) - व्यापक रूप से समर्थित लेकिन केवल CPU-आधारित कठोरता। संभव होने पर Argon2 या Scrypt का उपयोग करें।
PBKDF1 ("pbkdf1" Crypt::KeyDerivation में, "pbkdf1_openssl" Crypt::KeyDerivation में) - केवल विरासत व्युत्पत्ति। इसे पुराने प्रारूपों के साथ इंटरऑपरेबिलिटी के लिए रखें; नए डिज़ाइनों के लिए इसका उपयोग न करें।

त्रुटि प्रबंधन

अधिकांश CryptX मॉड्यूल croak (Carp से) कॉल करके त्रुटियों की रिपोर्ट करते हैं। अमान्य पैरामीटर, असमर्थित एल्गोरिदम, गलत कुंजी आकार, विकृत इनपुट, और आंतरिक लाइब्रेरी विफलताएँ आमतौर पर एक वर्णनात्मक संदेश के साथ croak करती हैं। eval या Try::Tiny से अपवादों को पकड़ें।

कुछ वैलिडेशन-शैली सहायक croak करने के बजाय रिटर्न वैल्यू का उपयोग करते हैं। सबसे महत्वपूर्ण उदाहरण प्रमाणित एन्क्रिप्शन मॉड्यूल Crypt::AuthEnc::* में *_decrypt_verify फ़ंक्शन हैं। प्रमाणीकरण विफल होने पर ये undef लौटाते हैं, जो इंगित करता है कि सिफरटेक्स्ट के साथ छेड़छाड़ की गई थी या गलत कुंजी/नॉन्स का उपयोग किया गया था। अन्य मॉड्यूलों में कुछ पार्सर/डिकोडर सहायक विकृत इनपुट के लिए भी 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 बिल्ड का विवरण उजागर करते हैं। इनका उद्देश्य समस्या निवारण और बग रिपोर्ट के लिए है, नियमित उपयोग के लिए नहीं।

ltc_build_settings

my $str = CryptX::ltc_build_settings();

एक बहु-पंक्ति स्ट्रिंग लौटाता है जो हर कंपाइल-टाइम विकल्प का वर्णन करता है जो बंडल किए गए LibTomCrypt लाइब्रेरी के निर्माण के समय सक्षम था (सिफर, हैश, MACs, PK एल्गोरिदम, कंपाइलर फ़्लैग, आदि)।

ltc_mp_name

my $name = CryptX::ltc_mp_name();
# e.g. "LTM" (LibTomMath)

उपयोग में आने वाले गणित प्रदाता (math provider) बैक-एंड का नाम लौटाता है।

ltc_mp_bits_per_digit

my $bits = CryptX::ltc_mp_bits_per_digit();
# e.g. 60

गणित प्रदाता द्वारा उपयोग किए जाने वाले प्रति अंक (digit) बिट्स की संख्या लौटाता है।

Math::BigInt बैकएंड

CryptX का एक हिस्सा Math::BigInt::LTM है, जो Math::BigInt बैकएंड है जो बंडल किए गए LibTomMath लाइब्रेरी पर आधारित है। यह ऊपर दिए गए क्रिप्टोग्राफ़िक APIs से अलग है, लेकिन यह उसी वितरण में शामिल होता है और उसी बड़े-पूर्णांक (big-integer) इंजन का उपयोग करता है जिस पर LibTomCrypt निर्भर करता है।

लाइसेंस

यह प्रोग्राम मुक्त सॉफ़्टवेयर है; आप इसे Perl के समान शर्तों के अंतर्गत पुनर्वितरित और/या संशोधित कर सकते हैं।

perl-CryptX

सबसे लोकप्रिय