sgcCrypto'nun yaptığı her şey, diskteki 43 birim üzerinden eşlenmiş. Burada bileşen ve tasarım zamanı özelliği yoktur: aşağıdaki her satır, doğrudan çağırdığınız bir fonksiyon veya yordamdır. Tam kaynak kodu her lisansla gelir. Aşağıdaki bağlantılar sizi birimlerin ait olduğu altı yetenek ailesine götürür.
sgcCrypto'nun bileşeni yoktur. Aşağıdaki 43 birim sade fonksiyonlar dışa aktarır, bir Tsgc* sınıfı ve bir sgcCrypto_Reg.pas yoktur. uses cümlenize bir birim ekleyin ve fonksiyonu çağırın.
Zaten dahildir. sgcCrypto, sgcWebSockets Standard, Professional ve Enterprise'ın içinde, ayrıca All-Access'in içinde ücretsiz gelir. Yalnızca Core'a sahip müşteriler için de bağımsız olarak satılır (sgcWebSockets Core çalışma zamanı pakete dahildir). Bkz. Fiyatlandırma.
AES, CCM, ChaCha20, Poly1305, 5 birim
SHA-2/3, BLAKE2, Argon2, 11 birim
Ed25519, X25519, Schnorr, RSA, 10 birim
X.509, ASN.1, RSA ve EC CSR, 5 birim
ML-KEM, ML-DSA, SLH-DSA, 6 birim
HOTP/TOTP, kodlama, ZIP AES, 6 birim
sgcWebSockets/delphi/Source/ altındaki her sgcCrypto_*.pas birimi, aileye göre gruplanmış.
| Birim | Aile | Ne yapar |
|---|---|---|
sgcCrypto_AES | Simetrik | AES-CBC, AES-GCM (AEAD), AES-CTR. |
sgcCrypto_Modes | Simetrik | AES-ECB, OFB, CFB, CTS, CCM (AEAD), Key Wrap / Padding'li Key Wrap ve yedi dolgu şeması. |
sgcCrypto_CMAC | Simetrik | AES-CMAC ve AES-GMAC mesaj kimlik doğrulaması. |
sgcCrypto_ChaCha | Simetrik | ChaCha20, XChaCha20, Salsa20, XSalsa20. |
sgcCrypto_Poly1305 | Simetrik | Poly1305 MAC, ChaCha20-Poly1305 ve XChaCha20-Poly1305 AEAD. |
sgcCrypto_SHA2 | Hashing ve KDF | SHA-1, SHA-224, SHA-256, SHA-384, SHA-512. |
sgcCrypto_Keccak | Hashing ve KDF | SHA-3, SHAKE128/256, cSHAKE, KMAC. |
sgcCrypto_Blake2b | Hashing ve KDF | BLAKE2b, anahtarlı veya anahtarsız. |
sgcCrypto_Blake2s | Hashing ve KDF | BLAKE2s, anahtarlı veya anahtarsız. |
sgcCrypto_HMAC | Hashing ve KDF | HMAC-SHA1/256/384/512. |
sgcCrypto_KDF | Hashing ve KDF | PBKDF2, KDF1, KDF2 ve X9.63, seçilebilir hash. |
sgcCrypto_HKDF | Hashing ve KDF | HKDF extract-and-expand. |
sgcCrypto_Scrypt | Hashing ve KDF | Bellek zorlu scrypt KDF. |
sgcCrypto_Argon2 | Hashing ve KDF | Argon2d, Argon2i, Argon2id. |
sgcCrypto_SipHash | Hashing ve KDF | SipHash-2-4 anahtarlı hash. |
sgcCrypto_TLSH | Hashing ve KDF | TLSH bulanık hash ve benzerlik diff'i. |
sgcCrypto_Ed25519 | İmzalar ve anahtar değişimi | Ed25519 imzala / doğrula. |
sgcCrypto_X25519 | İmzalar ve anahtar değişimi | X25519 Diffie-Hellman. |
sgcCrypto_Ed448 | İmzalar ve anahtar değişimi | Ed448 imzala / doğrula. |
sgcCrypto_X448 | İmzalar ve anahtar değişimi | X448 Diffie-Hellman. |
sgcCrypto_GF448 | İmzalar ve anahtar değişimi | Ed448/X448 için dahili GF(2^448-2^224-1) alan aritmetiği. |
sgcCrypto_ECCurves | İmzalar ve anahtar değişimi | secp256k1, Brainpool P256r1/P384r1/P512r1 ve NIST P-256/P-384/P-521 üzerinde ECDSA / ECDH, DER imzaları, anahtar dışa/içe aktarımı ve BIP-340 Schnorr. |
sgcCrypto_EC | İmzalar ve anahtar değişimi | JWS olarak genel EC imzala/doğrula (ES256/384/512), ECDH. |
sgcCrypto_RSA | İmzalar ve anahtar değişimi | PEM veya ham anahtardan RSA PKCS#1 v1.5 imzala, PKCS#1 v1.5 / PSS doğrula. |
sgcCrypto_RSA_Keys | İmzalar ve anahtar değişimi | RSA anahtar üretimi, OAEP (bağımsız MGF1 hash'iyle), PSS, PKCS#1 v1.5 imzala/doğrula/şifrele/çöz, PKCS#1 ve PKCS#8 DER/PEM dışa ve içe aktarımı. |
sgcCrypto_ECIES | İmzalar ve anahtar değişimi | X25519 üzerinde ECIES mühürleme / açma hibrit şifrelemesi. |
sgcCrypto_ASN1 | PKI | DER okuyucu, PEM kodeği, PKCS#1/SEC 1 anahtar ayrıştırma. |
sgcCrypto_DER | PKI | DER yazıcı ilkelleri. |
sgcCrypto_BigInteger | PKI | Dahili keyfi hassasiyetli tam sayı aritmetiği. |
sgcCrypto_X509 | PKI | X.509 ayrıştır, doğrula, zincirle, CRL, iptal. |
sgcCrypto_X509_Gen | PKI | Kendinden imzalı sertifika ve PKCS#10 CSR üretimi, RSA veya EC imzalı, URI konu alternatif adlarıyla. |
sgcCrypto_MLKEM | Kuantum sonrası | ML-KEM anahtar kapsülleme (FIPS 203), 3 parametre seti. |
sgcCrypto_MLKEM_Poly | Kuantum sonrası | ML-KEM'in arkasındaki dahili polinom halka aritmetiği. |
sgcCrypto_MLKEM_Hybrid | Kuantum sonrası | Hibrit X25519 + ML-KEM anahtar kapsülleme. |
sgcCrypto_MLDSA | Kuantum sonrası | ML-DSA dijital imzalar (FIPS 204), 3 parametre seti. |
sgcCrypto_MLDSA_Poly | Kuantum sonrası | ML-DSA'nın arkasındaki dahili polinom halka aritmetiği. |
sgcCrypto_SLHDSA | Kuantum sonrası | SLH-DSA imzaları (FIPS 205), 6 SHAKE parametre seti. |
sgcCrypto_OTP | OTP ve diğer | HOTP, TOTP, sabit zamanlı doğrulama penceresi. |
sgcCrypto_Encoding | OTP ve diğer | Sabit zamanlı karşılaştırma, güvenli sıfırlama, hex/Base64url/Base32. |
sgcCrypto_Zip_AE2 | OTP ve diğer | ZIP girdileri için WinZip AES şifrelemesi, AE-1 / AE-2. |
sgcCrypto_Legacy | OTP ve diğer | MD4, MD5, HMAC-MD5, DES-ECB, RIPEMD-160 ve HMAC-RIPEMD160, yalnızca birlikte çalışabilirlik için. |
sgcCrypto_Random | OTP ve diğer | Platformlar arası CSPRNG. |
sgcCrypto_Int64 | OTP ve diğer | Delphi 7 için dahili 64 bit tam sayı emülasyonu. |
Üretim kodunun gerçekte kullandığı modlarda AES, artı ChaCha20/Poly1305 AEAD ailesi.
| Yetenek | Fonksiyon | Notlar |
|---|---|---|
| AES-CBC | sgcAES_CBC_Encrypt / sgcAES_CBC_Decrypt | PKCS#7 dolgusu, 16 baytlık IV. Anahtar uzunluğu şifreyi seçer: 16/24/32 bayt = AES-128/192/256. |
| AES-CBC, dolgusuz | sgcAES_CBC_Encrypt_NoPad / sgcAES_CBC_Decrypt_NoPad | Java'nın AES/CBC/NoPadding olarak yazdığı mod. Girdi zaten 16'nın katı olmalıdır; hizasız bir girdi, diğer tarafın okuyamayacağı bir şeye sessizce doldurulmak yerine bir istisna fırlatır. |
| AES-GCM (AEAD) | sgcAES_GCM_Encrypt / sgcAES_GCM_Decrypt | 12 baytlık IV önerilir. Sabit zamanda karşılaştırılan 16 baytlık etiket; başarısız bir etikette decrypt False ve boş düz metin döndürür. |
| AES-CCM (AEAD) | sgcAES_CCM_Encrypt / sgcAES_CCM_Decrypt | Kısıtlı ve IoT yığınlarının belirttiği AEAD, Zigbee, 802.15.4, Bluetooth ve TLS CCM paketleri, çünkü yalnızca blok şifreye ihtiyaç duyar ve bir GHASH tablosuna ihtiyaç duymaz. Nonce 7 ila 13 bayt, etiket 4 ila 16 bayt, sabit zamanda doğrulanır. |
| AES-CTR | sgcAES_CTR | SRTP tarzı AES-CM (RFC 3711). Simetrik çağrı, dolgu yok, 128 bit büyük-endian sayaç. |
| AES-ECB | sgcAES_ECB_Encrypt / sgcAES_ECB_Decrypt | IV yok, zincirleme yok. Bunu belirten biçimlerle birlikte çalışabilirlik için dahildir. |
| Dolgu şemaları | sgcPad_Add / sgcPad_Remove, sgcAES_CBC_EncryptPad / DecryptPad, sgcAES_ECB_EncryptPad / DecryptPad | TsgcPadding, None, PKCS#7, Zero, ANSI X9.23, ISO 7816-4, ISO 10126-2 ve TBC'yi kapsar; bu yüzden CBC ve ECB, PKCS#7'yi seçmemiş bir sistemden veri okuyup yazabilir. sgcPad_Remove, her tür bozuk dolgu için aynı yoldan False döndürür. |
| AES-OFB / AES-CFB | sgcAES_OFB, sgcAES_CFB_Encrypt / sgcAES_CFB_Decrypt | Akış şifresi tarzı geri besleme modları. |
| AES-CTS | sgcAES_CTS_Encrypt / sgcAES_CTS_Decrypt | Şifreli metin çalma: blok boyutunun katı olmayan veriyi dolgu ek yükü olmadan şifreler. |
| AES Key Wrap | sgcAES_KeyWrap / sgcAES_KeyUnwrap | RFC 3394, bir anahtarı başka bir anahtar altında sarmak için. |
| Padding'li AES Key Wrap | sgcAES_KeyWrapPad / sgcAES_KeyUnwrapPad | RFC 5649, 8 baytın katı olmayan anahtar malzemesi için. |
| AES-CMAC | sgcAES_CMAC / sgcAES_CMAC_Verify | RFC 4493 mesaj kimlik doğrulama kodu. |
| AES-GMAC | sgcAES_GMAC / sgcAES_GMAC_Verify | GCM'nin yalnızca kimlik doğrulama modu: tüm mesaj ek veri olarak taşınır, hiçbir şey şifrelenmez. IV, aynı anahtar altında asla tekrarlanmamalıdır, ve 16 baytlık etiket sabit zamanda karşılaştırılır. |
| Düşük seviyeli blok ilkelleri | sgcAES_ExpandKey, sgcAES_EncryptBlock, sgcAES_DecryptBlock | Yukarıdaki mod ve MAC birimleri için açığa çıkarılmıştır; henüz sağlanmayan bir modu inşa etmek için bunları doğrudan yalnızca gerektiğinde çağırın. |
| ChaCha20 | sgcChaCha20 | RFC 8439, 96 bit nonce, 32 bit sayaç. |
| XChaCha20 | sgcXChaCha20 | 192 bit genişletilmiş nonce, ölçekte rastgele nonce üretimi için güvenli. |
| Salsa20 / XSalsa20 | sgcSalsa20 / sgcXSalsa20 | Öncül akış şifresi ailesi, her iki nonce boyutuyla. |
| Alt anahtar türetme | sgcHChaCha20 / sgcHSalsa20 | X varyantlarının, ilk 16 nonce baytından bir alt anahtar türetmek için dahili olarak kullandığı şey. |
| Poly1305 MAC | sgcPoly1305 / sgcPoly1305_Verify | Tek kullanımlık doğrulayıcı, RFC 8439. Bir Poly1305 anahtarını asla yeniden kullanmayın. |
| ChaCha20-Poly1305 AEAD | sgcChaCha20Poly1305_Encrypt / _Decrypt | TLS 1.3'ün ikinci şifre paketinin ve SSH'nin arkasındaki AEAD şifresi. |
| XChaCha20-Poly1305 AEAD | sgcXChaCha20Poly1305_Encrypt / _Decrypt | Aynı AEAD, 192 bit nonce; libsodium'un crypto_aead_xchacha20poly1305_ietf dediği yapı. |
Her yaygın hash ailesi, artı PBKDF2, HKDF, scrypt ve üç Argon2 varyantının tamamı.
| Yetenek | Fonksiyon | Notlar |
|---|---|---|
| SHA-1 / SHA-2 | sgcSHA1, sgcSHA224, sgcSHA256, sgcSHA384, sgcSHA512 | FIPS 180-4. SHA-1, birlikte çalışabilirlik için tutulur, yeni imzalar için önerilmez. |
| SHA-3 | sgcSHA3_224 / _256 / _384 / _512 | FIPS 202, Keccak süngeri, SHA-2'den yapısal olarak bağımsız. |
| SHAKE128 / SHAKE256 | sgcSHAKE128 / sgcSHAKE256 | Genişletilebilir çıktılı fonksiyonlar: herhangi bir özet uzunluğu isteyin. |
| cSHAKE128 / cSHAKE256 | sgcCSHAKE128 / sgcCSHAKE256 | Alan ayrımlı SHAKE, NIST SP 800-185, KMAC'in temeli. |
| KMAC128 / KMAC256 | sgcKMAC128 / sgcKMAC256 | Değişken çıktı uzunluklu Keccak tabanlı MAC. |
| BLAKE2b | sgcBlake2b / sgcBlake2b_Keyed | RFC 7693, 64 bayta kadar özetler, yerleşik anahtarlama (ayrı bir HMAC gerekmez). |
| BLAKE2s | sgcBlake2s / sgcBlake2s_Keyed | RFC 7693, 32 bayta kadar özetler, 32 bit platformlar için ayarlanmış. |
| Akışlı özetler | sgcBlake2b_Init/_Update/_Final, Keccak/Blake2s üzerinde eşleşen çağrılar | Belleğe tek seferde sığmayacak kadar büyük veriyi hashlemek için. |
| HMAC | sgcHMAC_SHA1 / _SHA256 / _SHA384 / _SHA512 | SHA-1/2 ailesi üzerinde RFC 2104 anahtarlı hashing. |
| RIPEMD-160 / HMAC-RIPEMD160 | sgcRIPEMD160, sgcHMAC_RIPEMD160 | ISO/IEC 10118-3 ve RFC 2286. Bitcoin adreslerinin SHA-256 üzerine katmanladığı 160 bitlik özet, ve OpenPGP'nin isim olarak belirttiği özet. |
| PBKDF2 | sgcPBKDF2, sgcPBKDF2_SHA1 / _SHA256 / _SHA512 | RFC 8018. Yalnızca hafifçe bellek zorlu; seçebiliyorsanız Argon2id veya scrypt'i tercih edin. |
| HKDF | sgcHKDF_Extract_SHA256 / _SHA384, sgcHKDF_Expand_SHA256 / _SHA384, sgcHKDF_SHA256 / _SHA384 | RFC 5869, extract-then-expand anahtar türetme; paylaşılan bir gizli anahtarı birkaç anahtara dönüştürmenin standart yolu. |
| KDF1 / KDF2 / X9.63 | sgcKDF1, sgcKDF2, sgcKDF_X963 | ISO 18033-2'nin, IEEE 1363a'nın ve ANSI X9.63'ün tanımladığı sayaç modu türetmeleri; RSA-KEM'in ve ECIES'in isim olarak belirttiği budur. KDF1, 0'dan sayar ve KDF2, 1'den sayar; bu fark gerçek birlikte çalışabilirlik hatalarına neden olmuştur, bu yüzden spesifikasyonunuzun hangisini kastettiğini kontrol edin. |
| scrypt | sgcScrypt | RFC 7914, bellek zorlu, GPU/ASIC saldırısına PBKDF2'den çok daha iyi direnir. |
| Argon2 | sgcArgon2 (d / i / id), sgcArgon2id kolaylık sarmalayıcısı | RFC 9106, Password Hashing Competition kazananı. İsteğe bağlı gizli (pepper) ve ilişkili veriyle tam arayüz. |
| SipHash-2-4 | sgcSipHash24 / sgcSipHash24_Value | Hash tablosu anahtarları için hızlı anahtarlı PRF, hash-flooding hizmet reddine direnir. |
| TLSH bulanık hash | sgcTLSH, sgcTLSH_Init/_Update/_Final | Kriptografik bir özet değil, benzer-yakın tespit için konuma duyarlı hash. |
| TLSH benzerlik skoru | sgcTLSH_Diff | İki TLSH özeti arasındaki mesafe; düşük olması daha benzer demektir. |
Beş ayrı eğri ailesi artı RSA üzerinde imzalayın, doğrulayın ve paylaşılan gizli anahtarlar türetin.
| Yetenek | Fonksiyon | Notlar |
|---|---|---|
| Ed25519 imzala / doğrula | sgcEd25519_Sign / sgcEd25519_Verify | RFC 8032. 32 baytlık genel anahtar, 64 baytlık imza. Doğrulama, kanonik olmayan noktaları ve bölüm 5.1.7'ye göre S >= L'yi reddeder. |
| X25519 anahtar değişimi | sgcX25519, sgcX25519_PublicKey, sgcX25519_SharedSecret | Curve25519 üzerinde RFC 7748 Diffie-Hellman. |
| Ed448 imzala / doğrula | sgcEd448_GenerateKeyPair, sgcEd448_Sign, sgcEd448_Verify | RFC 8032, 448 bitlik (Goldilocks) EdDSA eğrisi. |
| X448 anahtar değişimi | sgcX448, sgcX448_PublicKey, sgcX448_SharedSecret | Curve448 üzerinde RFC 7748 Diffie-Hellman. |
| secp256k1 | eccSecp256k1 ile sgcECDSA_SignHash / VerifyHash | sgcCrypto_ECCurves içinde, Bitcoin/Ethereum eğrisi, SEC 2. |
| Brainpool P256r1 / P384r1 / P512r1 | eccBrainpoolP256r1 / P384r1 / P512r1 ile aynı fonksiyonlar | RFC 5639, AB eIDAS ve devlet profillerinde yaygın. |
| NIST P-256 / P-384 / P-521 | aynı fonksiyonlar eccP256 / eccP384 / eccP521 ile | TsgcECCurve artık yedi eğri adlandırıyor, bu yüzden anahtar üretimi, imzalama, doğrulama, ECDH ve nokta sıkıştırmanın hepsi, yalnızca bir PEM dosyasından değil, ham anahtar baytlarından da NIST asal eğrilerine ulaşır. |
| Deterministik ECDSA nonce'u | sgcECDSA_SignHash'e yerleşik | RFC 6979: nonce, özel anahtardan ve mesajdan türetilir, RNG hata modu yoktur. |
| ECDH (secp256k1 / Brainpool) | sgcECDH_SharedSecret | Aynı dört eğri üzerinde paylaşılan gizli anahtar. |
| Nokta sıkıştırma | sgcEC_Compress / sgcEC_Decompress | Daha kısa sıkıştırılmış genel anahtar biçimini saklayın veya iletin. |
| JWS olarak EC (ES256/384/512) | sgcECDSA_SignJWS / sgcECDSA_VerifyJWS | İstenen bit uzunluğundan otomatik seçilen eğri, doğrudan bir PEM anahtarından imzala/doğrula; ECCurves'in JOSE odaklı kardeşi. |
| Genel ECDH | sgcECDH | Ham bir özel anahtardan ve eş genel noktasından paylaşılan gizli anahtar. |
| Ham / DER ECDSA doğrulama | sgcECDSA_VerifyRaw / sgcECDSA_VerifyDER | Ham bir (Qx, Qy, r, s) demetine ya da DER kodlu bir imzaya karşı doğrulayın. |
| DER ECDSA imzalama ve dönüştürme | sgcECDSA_SignDER / sgcECDSA_VerifyDER, sgcECDSA_RawToDER / sgcECDSA_DERToRaw | X.509, CMS ve TLS, DER ECDSA-Sig-Value'yu taşır; INTEGER r ve ardından INTEGER s'den oluşan bir SEQUENCE. JOSE ve WebAuthn bunun yerine ham R || S çiftini taşır. Doğrudan iki biçimden birine imzalayın, ya da mevcut bir imzayı aralarında dönüştürün. |
| Schnorr imzaları (BIP-340) | sgcSchnorr_PublicKey, sgcSchnorr_Sign, sgcSchnorr_Verify | Yalnızca secp256k1, yalnızca-x 32 baytlık açık anahtarlar ve 64 baytlık imzalarla: Taproot'un, Nostr'un ve Lightning'in kullandığı budur. sgcSchnorr_TaggedHash, BIP-341 ve BIP-342 etiketlerinin aynı yapı üzerine inşa edilebilmesi için dışa açılmıştır. |
| RSA imzalama (PKCS#1 v1.5) | sgcRSA_SignPKCS1 | Bir PEM özel anahtarından, SHA-1/256/384/512 özeti. |
| RSA doğrulama (PKCS#1 v1.5 / PSS) | sgcRSA_VerifyPKCS1, sgcRSA_VerifyPSS ve bir modül/üs üzerinde _Raw varyantları | RFC 8017. Doğrulama, bir anahtar nesnesi oluşturmadan bir PEM anahtarından ya da ham modül ve üsten çalışır. |
| RSA anahtar üretimi | sgcRSA_GenerateKey | İstenen herhangi bir bit uzunluğu, Miller-Rabin asallık testi. |
| RSA-OAEP şifreleme | sgcRSA_OAEP_Encrypt / sgcRSA_OAEP_Decrypt | RFC 8017 optimal asimetrik şifreleme dolgusu. |
| Bağımsız bir MGF1 hash'iyle RSA-OAEP | beş parametreli sgcRSA_OAEP_Encrypt / sgcRSA_OAEP_Decrypt aşırı yüklemeleri | Etiket hash'ini ve MGF1 hash'ini ayrı ayrı sabitleyin. OAEPWithSHA256AndMGF1Padding, Bouncy Castle'da ikisi için de SHA-256 anlamına gelir ama SunJCE'de MGF1-SHA1 ile SHA-256 anlamına gelir, ve bu uyuşmazlık, Java birlikte çalışabilirliğinin başarısız olmasının olağan nedenidir. |
| RSA PKCS#1 v1.5 şifreleme | sgcRSA_PKCS1_Encrypt / sgcRSA_PKCS1_Decrypt | RFC 8017 bölüm 7.2, Java'nın RSA/ECB/PKCS1Padding olarak adlandırdığı mod. Decrypt, her başarısızlık için aynı yoldan geçer, bu yüzden bir padding oracle'a çalışacak hiçbir şey vermez. Yeni herhangi bir şey için OAEP'i tercih edin. |
| RSA-PSS / PKCS#1 imzalama | sgcRSA_PSS_Sign / Verify, sgcRSA_PKCS1_Sign / Verify | Üretilen bir TsgcRSAPrivateKey'den doğrudan imzalayın. |
| RSA anahtar dışa aktarımı | sgcRSA_ExportPrivateKeyPEM, sgcRSA_ExportPublicKeyPEM, eşleşen DER çağrıları | PKCS#1 ve SubjectPublicKeyInfo kodlamaları. |
| PKCS#8 ve SEC 1 anahtar dışa aktarımı | sgcRSA_ExportPrivateKeyPKCS8DER / PKCS8PEM, sgcEC_ExportPrivateKeyPKCS8DER / PKCS8PEM, sgcEC_ExportPrivateKeySEC1DER / SEC1PEM, sgcEC_ExportSubjectPublicKeyInfo, sgcEC_ExportPublicKeyPEM | Java'nın, .NET'in ve çoğu modern araç setinin beklediği BEGIN PRIVATE KEY kabı, SEC 1 BEGIN EC PRIVATE KEY biçiminin ve bir sertifikanın gömdüğü SubjectPublicKeyInfo'nun yanında. Şifresizdir, bu yüzden geri dönen şey çıplak anahtar malzemesidir. |
| RSA ve EC anahtarı içe aktarımı | sgcRSA_ImportPrivateKeyDER / PEM, sgcRSA_ImportPublicKeyDER / PEM, sgcEC_ImportPrivateKeyDER / PEM, sgcEC_ImportPublicKeyDER / PEM | Bu daha önce yoktu: üretilen bir anahtar yazılabiliyordu ama asla geri okunamıyordu. İçe aktarma, PKCS#1, PKCS#8, SEC 1 ve SubjectPublicKeyInfo'yu, DER veya PEM olarak kabul eder, dosya bunları atladığında CRT parametrelerini veya açık noktayı yeniden hesaplar, ve bozuk girdide raise etmek yerine False döndürür; bu yüzden güvenilmeyen dosyalar ona vermek için güvenlidir. |
| ECIES mühürleme / açma | sgcECIES_GenerateKeyPair, sgcECIES_Seal, sgcECIES_Open | Bir X25519 genel anahtarına hibrit şifreleme: geçici ECDH artı bir AEAD, her yönde tek çağrı. |
Başkasının yayınladığı bir sertifikayı okuyun, ya da kendiniz üretin; her ikisinin altında bir DER kodlayıcı ve kod çözücü bulunur.
| Yetenek | Fonksiyon | Notlar |
|---|---|---|
| DER okuyucu | sgcASN1_Read, sgcASN1_Next, sgcASN1_Content | Bir DER yapısını düğüm düğüm gezer. |
| PEM kodeği | sgcPEM_Decode / sgcPEM_Encode | RFC 7468, DER'in etrafındaki -----BEGIN ... -----END sarmalayıcısı. |
| RSA anahtar ayrıştırma | sgcASN1_ParseRSAPrivateKey / PublicKey | PKCS#1 (RFC 8017) anahtar yapıları. |
| EC anahtar ayrıştırma | sgcASN1_ParseECPrivateKey / PublicKey | SEC 1 anahtar yapıları. |
| DER yazıcı, yapısal | sgcDER_Sequence, sgcDER_Set, sgcDER_Tagged, sgcDER_ContextExplicit / Implicit | Her sertifika alanının inşa edildiği yapı taşları. |
| DER yazıcı, değerler | sgcDER_Integer, sgcDER_OctetString, sgcDER_BitString, sgcDER_Boolean, sgcDER_Null | İlkel değer kodlayıcıları. |
| DER yazıcı, dizeler ve tanımlayıcılar | sgcDER_OID, sgcDER_UTF8String, sgcDER_PrintableString, sgcDER_IA5String, sgcDER_Time | Nesne tanımlayıcıları, X.509'un kullandığı üç dize türü, ve UTCTime/GeneralizedTime. |
| Sertifika ayrıştırma | sgcX509_Parse | Tam sertifika yapısı: konu, yayıncı, geçerlilik, genel anahtar, uzantılar. |
| İmza / zincir doğrulama | sgcX509_VerifySignedBy, sgcX509_VerifyChain | Bir sertifikayı bir yayıncıya karşı doğrulayın, ya da bir DER sertifika dizisini yürüyüp doğrulayın. |
| CRL ayrıştırma ve iptal | sgcX509_CRL_Parse, sgcX509_IsRevoked, sgcX509_CRL_VerifySignedBy | Bir Sertifika İptal Listesini ayrıştırın ve bir seri numarasını buna karşı kontrol edin. |
| Ad biçimlendirme | sgcX509_SubjectRFC2253, sgcX509_IssuerRFC2253, sgcX509_SubjectOneLine | Günlükleme ve görüntüleme için RFC 2253 ayırt edici ad dizeleri. |
| Uzantılar ve SAN'lar | sgcX509_GetExtension, sgcX509_GetCRLDistributionURIs | Keyfi uzantı OID'lerini ve CRL dağıtım noktası URI'lerini okuyun. |
| Kendinden imzalı sertifika üretimi | sgcX509_CreateSelfSigned | Tam TsgcX509Options: konu DN'si, geçerlilik penceresi, seri numarası, yol uzunluğu kısıtlamalı CA bayrağı, anahtar kullanımı, genişletilmiş anahtar kullanımı, konu alternatif adları (IPv4 SAN'ları dahil). |
| URI konu alternatif adları | TsgcX509Options.URIs | Bir ana bilgisayar adı yerine SPIFFE tarzı bir hizmet kimliği için uniformResourceIdentifier SAN'ları. Değer, IA5String içeriği olarak olduğu gibi yazılır, bu yüzden tam bir URI geçirin. |
| PKCS#10 CSR üretimi | sgcX509_CreateCSR | Aynı seçenekler kaydından RFC 2986 sertifika imzalama isteği. |
| EC imzalı sertifikalar ve CSR'lar | sgcX509_CreateSelfSignedEx, sgcX509_CreateCSREx, sgcX509_ECKey, sgcX509_RSAKey | Her ikisini de bir TsgcX509SignKey içine sararak RSA'nın yanı sıra bir EC anahtarıyla da imzalayın. Bir EC sertifikası, bir RSA sertifikasının kabaca üçte biri boyutundadır ve çok daha hızlı doğrulanır. TsgcX509Options.Hash, hâlâ yalnızca SHA'yı adlandırır; algoritma anahtarı izler, bu yüzden bir EC anahtarıyla rhSHA256, ecdsa-with-SHA256 anlamına gelir. |
| PEM çıktısı | sgcX509_ToPEM | Üretilen DER'i kaydetmeye hazır bir PEM dosyası olarak sarar. |
NIST'in Ağustos 2024'te FIPS 203, 204 ve 205 olarak kesinleştirdiği üç algoritma, artı geçiş dönemi için bir hibrit birleştirici.
| Yetenek | Fonksiyon | Notlar |
|---|---|---|
| ML-KEM anahtar üretimi | sgcMLKEM_GenerateKeyPair, sgcMLKEM_GenerateKeyPairFromSeed | FIPS 203, eski adıyla Kyber. Üç parametre seti: mlkem512, mlkem768, mlkem1024. |
| ML-KEM kapsülleme | sgcMLKEM_Encapsulate, sgcMLKEM_EncapsulateWithSeed | Taze bir 32 baytlık paylaşılan gizli anahtar ve bunu taşıyan şifreli metni üretir. |
| ML-KEM çözme (decapsulate) | sgcMLKEM_Decapsulate | Asla başarısız olmaz: bozuk bir şifreli metin, bir hata yerine sözde rastgele bir gizli anahtar üretir (örtük ret); bu yüzden zamanlama ve hata davranışı hiçbir şey ortaya çıkarmaz. |
| ML-KEM boyutları | sgcMLKEM_PublicKeySize, PrivateKeySize, CiphertextSize, SharedSecretSize | Tampon boyutlandırma için parametre setine göre bayt uzunlukları. |
| Hibrit X25519 + ML-KEM | sgcHybrid_GenerateKeyPair, sgcHybrid_Encapsulate, sgcHybrid_Decapsulate | Klasik ve kuantum sonrası bir paylaşılan gizli anahtarı bir KDF üzerinden birleştirir; böylece sonuç asla X25519'dan tek başına daha zayıf olmaz. Sektörün ML-KEM'i bugün nasıl devreye aldığının önerilen yolu. |
| ML-DSA anahtar üretimi | sgcMLDSA_GenerateKeyPair, sgcMLDSA_GenerateKeyPairFromSeed | FIPS 204, eski adıyla Dilithium. Üç parametre seti: mldsa44, mldsa65, mldsa87. |
| ML-DSA imzala / doğrula | sgcMLDSA_Sign / sgcMLDSA_Verify | FIPS 204 arayüzüne göre deterministik veya rastgeleleştirilmiş imzalama, artı bir bağlam dizesi. |
| ML-DSA boyutları | sgcMLDSA_PublicKeySize, PrivateKeySize, SignatureSize | Parametre setine göre bayt uzunlukları. |
| SLH-DSA anahtar üretimi | sgcSLHDSA_GenerateKeyPair, sgcSLHDSA_GenerateKeyPairFromSeed | FIPS 205, eski adıyla SPHINCS+. Durumsuz hash tabanlı imzalar: güvenlik yalnızca hash fonksiyonuna dayanır, bir kafes veya eğri varsayımına değil. |
| SLH-DSA imzala / doğrula | sgcSLHDSA_Sign / sgcSLHDSA_Verify | Altı SHAKE parametre seti: slhShake128s, slhShake128f, slhShake192s, slhShake192f, slhShake256s, slhShake256f. s setleri küçük imzaları, f setleri hızlı imzalamayı önceliklendirir. |
| SLH-DSA boyutları ve adlandırma | sgcSLHDSA_PublicKeySize, PrivateKeySize, SignatureSize, sgcSLHDSA_ParamsName | SLH-DSA imzaları büyüktür (sete bağlı olarak 7,8 KB ile 49 KB arası); imzalamadan önce tamponu boyutlandırın. |
sgcCrypto, ed25519187 veya SPECK olduğunu iddia etmez. ed25519187'nin yayınlanmış bir spesifikasyonu yoktur, ve SPECK 2018'de ISO standardizasyonundan geri çekilmiştir; ikisi de burada uygulanmamıştır.
Yardımcı katman: tek kullanımlık kodlar, kütüphanenin geri kalanının dayandığı kodlamalar ve WinZip AES şifrelemesi.
| Yetenek | Fonksiyon | Notlar |
|---|---|---|
| HOTP | sgcHOTP | RFC 4226, sayaç tabanlı tek kullanımlık parola. |
| TOTP | sgcTOTP, sgcTOTP_FromBase32 | RFC 6238, zaman tabanlı tek kullanımlık parola; Base32 varyantı, gizli anahtarı bir kimlik doğrulayıcı uygulamasının gösterdiği tam haliyle kabul eder. |
| TOTP doğrulama | sgcTOTP_Verify | Gönderilen bir kodu bir adım penceresi boyunca sabit zamanda kontrol eder; böylece ne sonuç ne de konumu zamanlama üzerinden sızmaz. Tekrar oynatmayı kendisi durdurmaz; çağıran, kullanılan kodları izler. |
| Sabit zamanlı karşılaştırma | sgcConstantTimeEquals | Kütüphane genelinde etiket ve MAC karşılaştırmaları için kullanılır. |
| Güvenli sıfırlama | sgcSecureZero | Anahtar malzemesinin bellekte kalmaması için bir bayt tamponunun üzerine yazar. |
| Hex | sgcHexEncode / sgcHexDecode | Küçük harf hex, büyük/küçük harfe duyarsız çözme. |
| Base64url | sgcBase64UrlEncode / sgcBase64UrlDecode | RFC 4648 bölüm 5, dolgusuz; JWT ve JOSE'nin kullandığı kodlama. |
| Base32 | sgcBase32Encode / sgcBase32Decode | RFC 4648 bölüm 6; TOTP gizli anahtarlarının ve kimlik doğrulayıcı uygulamalarının kullandığı kodlama. |
| WinZip AES anahtar türetme | sgcZipAE2_DeriveKeys | Bir paroladan ve tuzdan PBKDF2 tabanlı anahtar, kimlik doğrulama anahtarı ve parola doğrulayıcısı. |
| WinZip AES şifrele / çöz | sgcZipAE2_Encrypt / sgcZipAE2_Decrypt | AE-1 ve AE-2, AES-128/192/256; TsgcZipAESStrength üzerinden girdi başına tuz boyutlandırması. |
| WinZip girdi paketleme | sgcZipAE2_PackEntry / sgcZipAE2_UnpackEntry | Tuzu, doğrulayıcıyı, şifreli metni ve kimlik doğrulama kodunu diskteki düzende birleştirir. |
| WinZip ek alanı | sgcZipAE2_BuildExtraField / sgcZipAE2_ParseExtraField | Bir ZIP girdisini AES şifreli olarak işaretleyen 0x9901 ek alanı. |
| Eski hash'ler (yalnızca birlikte çalışabilirlik) | sgcMD4, sgcMD5, sgcHMAC_MD5 | Daha eski biçimleri ve protokolleri okumak için tutulur; yeni bir tasarımda kullanmayın. |
| Eski şifre (yalnızca birlikte çalışabilirlik) | sgcDES_EncryptECB / sgcDES_DecryptECB, sgcDES_NTLM7to8 | DES-ECB ve DES tabanlı NTLM anahtar genişletme adımı; ikisi de geri çekilmiştir (FIPS 46-3), eski birlikte çalışabilirlik için tutulur. |
| Güvenli rastgele bayt | sgcRandomBytes / sgcRandomFill | MSWINDOWS altında Windows CryptoAPI, başka yerlerde /dev/urandom; her iki durumda da tek çağrı. |
Neyin desteklendiği, kesin olarak belirtilmiş.
| Alan | Ayrıntı |
|---|---|
| İşletim sistemi | sgcVer.inc içinde SGC_CRYPTO'yu saran bir MSWINDOWS koruması, ya da başka herhangi bir platform koruması yoktur. 43 birimin tamamı Win32, Win64, Linux64, macOS, iOS ve Android için derlenir. |
| Rastgele sayı kaynağı | Tek platform-farkındalıklı birim olan sgcCrypto_Random, hedef başına bir CSPRNG seçer: MSWINDOWS altında Windows CryptoAPI, POSIX hedeflerde /dev/urandom; hepsi aynı sgcRandomBytes çağrısının arkasında. |
| Delphi | Delphi 7'den RAD Studio 13 Florence'a kadar. Hiçbir yerde yerel bir 64 bitlik tam sayı türü varsayılmaz: sgcCrypto_Int64 ve sgcCrypto_BigInteger içindeki TsgcBigInt türü, hash'lerin, eğrilerin ve kuantum sonrası birimlerin ihtiyaç duyduğu aritmetiği taklit eder. |
| C++ Builder | Üretilen başlıklar üzerinden C++ Builder, aynı kaynak ağacı. |
| Tasarım zamanı izi | Yok. Bir sgcCrypto_Reg.pas yoktur, hiçbir şey RegisterComponents'lanmaz ve hiçbir birim bir bileşen paleti sayfasında görünmez. |
| Bağımlılıklar | OpenSSL bağlaması yok, harici DLL yok. Her ilkel, başvurduğunuz birimin içinde doğrudan Object Pascal olarak uygulanır. |
| Kaynak kodu | Her ücretli katmanda ve sgcCrypto'yu zaten içeren sürüm paketlerinde tam Object Pascal kaynağı. |
| Yeniden dağıtım | Oluşturduğunuz ikili dosyalar, koltuk başına veya sunucu başına bir çalışma zamanı ücreti olmadan telifsizdir. |