sgcCrypto — una biblioteca criptográfica moderna para Delphi y C++ Builder

sgcCrypto_AES cubre CBC, GCM y CTR; sgcCrypto_Modes añade ECB, OFB, CFB, CTS con robo de texto cifrado, AES-CCM, y AES Key Wrap / Key Wrap with Padding (RFC 3394 / 5649); sgcCrypto_CMAC es AES-CMAC y AES-GMAC. sgcCrypto_ChaCha implementa ChaCha20, XChaCha20, Salsa20 y XSalsa20, y sgcCrypto_Poly1305 combina Poly1305 con ellos en los cifrados AEAD ChaCha20-Poly1305 y XChaCha20-Poly1305 de RFC 8439. AES-CCM es el AEAD que nombran Zigbee, Bluetooth y las suites CCM de TLS, ya que no necesita nada más que el propio cifrado de bloque, y tanto CBC como ECB admiten el esquema de relleno que elija, PKCS#7, ANSI X9.23, ISO 7816-4 y el resto, para el día en que tenga que leer lo que escribió otro sistema. sgcAES_GCM_Decrypt y los verificadores de Poly1305 comparan la etiqueta de autenticación en tiempo constante y se niegan a devolver el texto plano cuando falla.

sgcCrypto_SHA2 y sgcCrypto_Keccak cubren SHA-1/2, SHA-3, SHAKE, cSHAKE y KMAC; sgcCrypto_Blake2b y sgcCrypto_Blake2s añaden BLAKE2. sgcCrypto_HMAC es autenticación de mensajes con clave. Para convertir una contraseña en una clave: sgcCrypto_KDF (PBKDF2), sgcCrypto_HKDF, sgcCrypto_Scrypt y sgcCrypto_Argon2, que implementa las tres variantes de Argon2, d, i e id, la ganadora de la Password Hashing Competition. sgcCrypto_SipHash ofrece un hash con clave rápido para claves de tablas hash, y sgcCrypto_TLSH es un hash difuso con una función de distancia de similitud, no un resumen criptográfico, útil para detectar casi duplicados.

sgcCrypto_Ed25519/Ed448 firman y verifican; sgcCrypto_X25519/X448 hacen el Diffie-Hellman correspondiente. sgcCrypto_ECCurves añade ECDSA y ECDH sobre siete curvas, secp256k1, las tres curvas Brainpool y NIST P-256/P-384/P-521, con nonces deterministas RFC 6979 y firmas en forma en bruto o DER, además de firma Schnorr BIP-340, con las claves públicas x-only que esperan Taproot, Nostr y Lightning. sgcCrypto_EC es la hermana orientada a JOSE: firma y verifica un JWS directamente, ES256/384/512. sgcCrypto_RSA verifica firmas PKCS#1 v1.5 y PSS directamente desde una clave PEM, y sgcCrypto_RSA_Keys va más allá con generación de claves de cualquier longitud, cifrado OAEP y PKCS#1 v1.5, y exportación DER/PEM tanto en la forma PKCS#1 como en la forma PKCS#8 BEGIN PRIVATE KEY. Las claves RSA y EC se importan con la misma facilidad con la que se exportan, DER o PEM, de modo que una clave generada una vez se puede guardar y volver a cargar en lugar de vivir solo mientras dure el proceso. sgcCrypto_ECIES lo completa con cifrado híbrido seal/open hacia una clave pública X25519.

sgcCrypto_ASN1 lee DER y PEM y analiza claves PKCS#1/SEC 1; sgcCrypto_DER escribe todas las etiquetas que necesita un certificado o un CSR. sgcCrypto_X509 analiza un certificado, verifica que fue firmado por un emisor dado, recorre y verifica una cadena, verifica un CSR, y analiza una CRL para comprobar la revocación. sgcCrypto_X509_Gen genera desde cero un certificado autofirmado o un CSR PKCS#10, y una CA emite con sgcX509_CreateSigned o sgcX509_CreateSignedFromCSR: nombre distintivo completo de sujeto y emisor, ventana de validez, indicador de CA con restricción de longitud de ruta, indicadores de uso de clave, OID de uso extendido de clave y nombres alternativos del sujeto, incluyendo SAN de direcciones IP, que ahora aceptan IPv6 en cualquier forma de texto del RFC 4291, y SAN de tipo URI para identidades de servicio al estilo SPIFFE.

La firma ya no se limita a RSA y EC. sgcX509_MLDSAKey y sgcX509_SLHDSAKey envuelven una clave poscuántica para sgcX509_CreateSelfSignedEx y sgcX509_CreateCSREx, de modo que un certificado o un CSR pueden firmarse con ML-DSA o SLH-DSA. Una CA también puede certificar una clave pública ML-KEM (RFC 9935), que no puede firmar, así que la posesión hay que demostrarla de otra manera. En el lado de la lectura, TsgcX509PublicKeyType ha ganado x509pkMLDSA, x509pkSLHDSA y x509pkMLKEM, y sgcX509_VerifyChain aplica ahora la longitud de ruta de basicConstraints y la extensión nameConstraints sobre dNSName, iPAddress, rfc822Name, uniformResourceIdentifier y directoryName, escrita en el lado de la generación desde PermittedDNSNames, ExcludedDNSNames, PermittedIPRanges y ExcludedIPRanges. Un certificado EC sigue saliendo con aproximadamente un tercio del tamaño de uno RSA y verifica mucho más rápido, razón por la cual los despliegues nuevos recurren a él.

sgcCrypto_MLKEM es encapsulación de claves FIPS 203, tres conjuntos de parámetros (ML-KEM-512/768/1024), con rechazo implícito ante un texto cifrado malformado. sgcCrypto_MLDSA es firma FIPS 204, ML-DSA-44/65/87. sgcCrypto_SLHDSA es FIPS 205, los seis conjuntos de parámetros SHAKE: 128s, 128f, 192s, 192f, 256s, 256f. Como ML-KEM por sí solo apuesta todo a una suposición reticular más joven que las curvas elípticas, sgcCrypto_MLKEM_Hybrid combina un secreto X25519 y un secreto ML-KEM en una única clave compartida, de modo que el resultado nunca es más débil que la mitad clásica, el patrón de migración hacia el que converge la industria.

La misma unidad implementa X-Wing (draft-connolly-cfrg-xwing-kem-10), X25519 con ML-KEM-768 como un único KEM: una clave pública de 1216 bytes, una clave privada de 32 bytes (la semilla), un texto cifrado de 1120 bytes y un secreto compartido de 32 bytes, a través de sgcXWing_GenerateKeyPair, sgcXWing_Encapsulate y sgcXWing_Decapsulate. También construye los key shares híbridos de TLS 1.3 del RFC 10024 para X25519MLKEM768, SecP256r1MLKEM768 y SecP384r1MLKEM1024 (puntos de código IANA 0x11EC, 0x11EB y 0x11ED). Esos tres no son KEM independientes, solo construyen un key share de TLS.

Los tres algoritmos leen y escriben ahora las claves como SubjectPublicKeyInfo de X.509, OneAsymmetricKey de PKCS#8 y PEM, así que una clave poscuántica vive en los mismos ficheros que una RSA o EC. Las claves privadas de ML-DSA y ML-KEM tienen tres formas, elegidas con TsgcPQCPrivateKeyFormat: pqkfSeed escribe solo la semilla (32 bytes para ML-DSA, la semilla d||z de 64 bytes para ML-KEM), pqkfExpanded escribe la clave expandida, pqkfBoth lleva las dos. SLH-DSA tiene una única forma de clave privada. sgcMLDSA_GenerateKeyPairAndSeed y sgcMLKEM_GenerateKeyPairAndSeed devuelven la semilla junto con el par de claves, así que se puede escribir un fichero en forma de semilla justo después de generarlo.

sgcCrypto_OTP genera y verifica códigos HOTP y TOTP, los mismos códigos de seis dígitos que muestra una app de autenticación, con una ventana de verificación en tiempo constante que absorbe el desfase de reloj. sgcCrypto_Encoding contiene las funciones de utilidad que comparte el resto de la biblioteca: comparación en tiempo constante, puesta a cero segura de buffers, hex, Base64url y Base32. sgcCrypto_Zip_AE2 implementa el cifrado WinZip AES, AE-1 y AE-2, para cifrar entradas individuales de un ZIP. sgcCrypto_Random es el CSPRNG multiplataforma detrás de cada clave y nonce generados en el resto de la biblioteca, y sgcCrypto_Legacy mantiene disponibles MD4/MD5/HMAC-MD5/DES-ECB para interoperar con formatos antiguos, no para diseños nuevos.