sgcCrypto — una libreria di crittografia moderna per Delphi e C++ Builder

sgcCrypto_AES copre CBC, GCM e CTR; sgcCrypto_Modes aggiunge ECB, OFB, CFB, il ciphertext stealing CTS, AES-CCM, e AES Key Wrap / Key Wrap with Padding (RFC 3394 / 5649); sgcCrypto_CMAC è AES-CMAC e AES-GMAC. sgcCrypto_ChaCha implementa ChaCha20, XChaCha20, Salsa20 e XSalsa20, e sgcCrypto_Poly1305 li abbina a Poly1305 nei cifrari AEAD ChaCha20-Poly1305 e XChaCha20-Poly1305 di RFC 8439. AES-CCM è l'AEAD che Zigbee, Bluetooth e le cipher suite TLS CCM indicano per nome, poiché non richiede nulla oltre al block cipher stesso, e CBC ed ECB accettano entrambi lo schema di padding a scelta, PKCS#7, ANSI X9.23, ISO 7816-4 e gli altri, per il giorno in cui si deve leggere ciò che un altro sistema ha scritto. sgcAES_GCM_Decrypt e i verificatori Poly1305 confrontano il tag di autenticazione in tempo costante e rifiutano di restituire il testo in chiaro quando il controllo fallisce.

sgcCrypto_SHA2 e sgcCrypto_Keccak coprono SHA-1/2, SHA-3, SHAKE, cSHAKE e KMAC; sgcCrypto_Blake2b e sgcCrypto_Blake2s aggiungono BLAKE2. sgcCrypto_HMAC è l'autenticazione dei messaggi con chiave. Per trasformare una password in una chiave: sgcCrypto_KDF (PBKDF2), sgcCrypto_HKDF, sgcCrypto_Scrypt e sgcCrypto_Argon2, che implementa tutte e tre le varianti di Argon2, d, i e id, vincitore della Password Hashing Competition. sgcCrypto_SipHash offre un hash veloce con chiave per le chiavi di hash-table, e sgcCrypto_TLSH è un fuzzy hash con una funzione di distanza di similarità, non un digest crittografico, utile per il rilevamento di quasi-duplicati.

sgcCrypto_Ed25519/Ed448 firmano e verificano; sgcCrypto_X25519/X448 eseguono il corrispondente Diffie-Hellman. sgcCrypto_ECCurves aggiunge ECDSA ed ECDH su sette curve, secp256k1, le tre curve Brainpool e NIST P-256/P-384/P-521, con nonce deterministici RFC 6979 e firme nella forma raw o DER, oltre alla firma Schnorr BIP-340, con le chiavi pubbliche x-only che Taproot, Nostr e Lightning si aspettano. sgcCrypto_EC è la sorella orientata a JOSE: firma e verifica direttamente un JWS, ES256/384/512. sgcCrypto_RSA verifica firme PKCS#1 v1.5 e PSS direttamente da una chiave PEM, e sgcCrypto_RSA_Keys va oltre con la generazione di chiavi a qualsiasi lunghezza in bit, crittografia OAEP e PKCS#1 v1.5, ed esportazione DER/PEM sia nella forma PKCS#1 che in quella PKCS#8 BEGIN PRIVATE KEY. Le chiavi RSA ed EC si importano con la stessa facilità con cui si esportano, DER o PEM, così una chiave generata una volta può essere salvata e ricaricata anziché vivere solo per la durata del processo. sgcCrypto_ECIES completa il quadro con crittografia ibrida seal/open verso una chiave pubblica X25519.

sgcCrypto_ASN1 legge DER e PEM e analizza chiavi PKCS#1/SEC 1; sgcCrypto_DER scrive ogni tag di cui un certificato o una CSR hanno bisogno. sgcCrypto_X509 analizza un certificato, verifica che sia stato firmato da un dato emittente, percorre e verifica una catena, verifica una CSR, e analizza una CRL per controllare la revoca. sgcCrypto_X509_Gen genera da zero un certificato autofirmato o una CSR PKCS#10, e una CA emette con sgcX509_CreateSigned oppure sgcX509_CreateSignedFromCSR: distinguished name completo di soggetto ed emittente, finestra di validità, flag CA con vincolo di lunghezza del percorso, flag di key usage, OID di extended key usage e subject alternative name, inclusi i SAN di indirizzo IP, che ora accettano IPv6 in qualsiasi forma testuale della RFC 4291, e i SAN URI per le identità di servizio in stile SPIFFE.

La firma non è più limitata a RSA ed EC. sgcX509_MLDSAKey e sgcX509_SLHDSAKey incapsulano una chiave post-quantum per sgcX509_CreateSelfSignedEx e sgcX509_CreateCSREx, così un certificato o una CSR possono essere firmati con ML-DSA oppure SLH-DSA. Una CA può anche certificare una chiave pubblica ML-KEM (RFC 9935), che non può firmare, quindi il possesso va dimostrato in un altro modo. Sul lato della lettura TsgcX509PublicKeyType ha acquisito x509pkMLDSA, x509pkSLHDSA e x509pkMLKEM, e sgcX509_VerifyChain applica ora la lunghezza del percorso di basicConstraints e l'estensione nameConstraints su dNSName, iPAddress, rfc822Name, uniformResourceIdentifier e directoryName, scritta sul lato della generazione a partire da PermittedDNSNames, ExcludedDNSNames, PermittedIPRanges ed ExcludedIPRanges. Un certificato EC risulta comunque all'incirca un terzo della dimensione di uno RSA e verifica molto più velocemente, il motivo per cui le nuove implementazioni scelgono EC.

sgcCrypto_MLKEM è l'incapsulamento di chiavi FIPS 203, tre parameter set (ML-KEM-512/768/1024), con rifiuto implicito su un ciphertext malformato. sgcCrypto_MLDSA è la firma FIPS 204, ML-DSA-44/65/87. sgcCrypto_SLHDSA è FIPS 205, tutti e sei i parameter set SHAKE: 128s, 128f, 192s, 192f, 256s, 256f. Poiché ML-KEM da solo punta tutto su un'ipotesi reticolare più giovane delle curve ellittiche, sgcCrypto_MLKEM_Hybrid combina un segreto X25519 e un segreto ML-KEM in un'unica chiave condivisa, così il risultato non è mai più debole della metà classica, lo schema di migrazione verso cui l'industria sta convergendo.

La stessa unità implementa X-Wing (draft-connolly-cfrg-xwing-kem-10), X25519 con ML-KEM-768 come un unico KEM: chiave pubblica di 1216 byte, chiave privata di 32 byte (il seed), ciphertext di 1120 byte e segreto condiviso di 32 byte, tramite sgcXWing_GenerateKeyPair, sgcXWing_Encapsulate e sgcXWing_Decapsulate. Costruisce anche le key share ibride TLS 1.3 della RFC 10024 per X25519MLKEM768, SecP256r1MLKEM768 e SecP384r1MLKEM1024 (codepoint IANA 0x11EC, 0x11EB e 0x11ED). Questi tre non sono KEM a sé stanti, servono soltanto a costruire una key share TLS.

Tutti e tre gli algoritmi ora leggono e scrivono le chiavi come SubjectPublicKeyInfo X.509, OneAsymmetricKey PKCS#8 e PEM, così una chiave post-quantum vive negli stessi file di una chiave RSA o EC. Le chiavi private ML-DSA e ML-KEM hanno tre forme, scelte con TsgcPQCPrivateKeyFormat: pqkfSeed scrive solo il seed (32 byte per ML-DSA, il seed d||z di 64 byte per ML-KEM), pqkfExpanded scrive la chiave espansa, pqkfBoth le contiene entrambe. SLH-DSA ha un'unica forma di chiave privata. sgcMLDSA_GenerateKeyPairAndSeed e sgcMLKEM_GenerateKeyPairAndSeed restituiscono il seed insieme alla coppia di chiavi, così un file in forma seed può essere scritto subito dopo la generazione.

sgcCrypto_OTP genera e verifica codici HOTP e TOTP, gli stessi codici a sei cifre che mostra un'app di autenticazione, con una finestra di verifica in tempo costante che assorbe lo sfasamento dell'orologio. sgcCrypto_Encoding contiene le funzioni di utilità condivise dal resto della libreria: confronto in tempo costante, azzeramento sicuro dei buffer, hex, Base64url e Base32. sgcCrypto_Zip_AE2 implementa la crittografia AES di WinZip, AE-1 e AE-2, per crittografare singole voci ZIP. sgcCrypto_Random è il CSPRNG multipiattaforma dietro ogni chiave e nonce generati altrove nella libreria, e sgcCrypto_Legacy mantiene disponibili MD4/MD5/HMAC-MD5/DES-ECB per l'interoperabilità con formati più vecchi, non per nuovi progetti.