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 ve aynı paketin bunların üzerine kurduğu TLS 1.3 ve TLS 1.2 motoruna 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
iohNativeTLS, X25519MLKEM768, saf Pascal
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, pathLenConstraint ve nameConstraints ile zincirle, CSR doğrula, CRL, iptal. RSA, EC, Ed25519, ML-DSA, SLH-DSA ve ML-KEM genel anahtarlarını okur. |
sgcCrypto_X509_Gen | PKI | Kendinden imzalı, CA tarafından yayınlanan ve PKCS#10 CSR üretimi; RSA, EC, ML-DSA veya SLH-DSA ile imzalı, URI ve IPv6 konu alternatif adları ve nameConstraints ile. |
sgcCrypto_MLKEM | Kuantum sonrası | ML-KEM anahtar kapsülleme (FIPS 203), 3 parametre seti; SubjectPublicKeyInfo, PKCS#8 ve PEM anahtar içe ve dışa aktarımı ile. |
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, X-Wing ve RFC 10024 TLS 1.3 hibrit anahtar paylaşımları. |
sgcCrypto_MLDSA | Kuantum sonrası | ML-DSA dijital imzalar (FIPS 204), 3 parametre seti; SubjectPublicKeyInfo, PKCS#8 ve PEM anahtar içe ve dışa aktarımı ile. |
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; SubjectPublicKeyInfo, PKCS#8 ve PEM anahtar içe ve dışa aktarımı ile. |
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 çekirdeği | sgcAES_GetCore / sgcAES_SetCore | aescConstantTime varsayılandır; belleği hiçbir zaman gizli bir baytla indekslemeyen ve gizli bir bayta göre dallanmayan bitslice bir çekirdektir, bu da anahtar ve düz metin üzerindeki önbellek zamanlama kanalını kapatır. aescTable klasik tablo çekirdeğidir, veri önbelleği üzerinden bilgi sızdırır ve her ölçümde daha yavaştı, bu yüzden yalnızca yedek olarak tutulur. GCM'i doğrulayan GHASH, anahtara göre dallanmak yerine bir maske altında çarpar. Çekirdeği, herhangi bir çalışan iş parçacığı başlamadan önce, başlangıçta bir kez ayarlayın. |
| 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, sgcEd25519_PublicKey | 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. İmzalama, gizli skalerde ve mesaj başına nonce'ta sabit zamanlıdır: sabit dört bitlik pencereler, on altısının hepsini bir maske altında tarayarak seçilen tablo girdisi ve bölüm 5.1.4'teki tam toplama formülü. Genel anahtar 32 baytlık tohumdan gelir. |
| 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. |
| Sabit zamanlı skaler çarpma | sgcECDSA_SignHash, sgcECDH_SharedSecret ve EC anahtar üretiminin içinde | sgcCrypto_ECCurves içindeki her eğri aynı motoru çalıştırır: veriye bağlı adımı olmayan Montgomery indirgemesi, sayısı eğriden gelen sabit bir pencere, tablo girdilerinin hepsini bir maske altında tarayarak seçilmesi ve hangi durumun geçerli olduğuna karar vermek için hiçbir koordinata bakmayan tam bir toplama formülü. sgcCrypto_EC içindeki JOSE, WebAuthn ve E2EE yolları aynı kodu çalıştırır. |
| 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 özel anahtar işlemleri | sgcRSA_SignPKCS1 ve sgcCrypto_RSA_Keys içindeki diğer imzalama ve şifre çözme çağrıları | Her işlem taze bir rastgele çiftle kör edilir, zamanlaması çarpanlara ya da veriye bağlı olmayan sabit pencereli bir üs alma ve CRT birleştirmesinden geçirilir ve sonuç döndürülmeden önce genel üsse karşı kontrol edilir. CRT yarılarından birindeki bir hata, aksi halde tek bir imzada bir çarpanı ele verirdi; bu yüzden uyumsuzluk halinde hiçbir şey döndürülmez. |
| 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. |
| Katı DER | sgcASN1_Read, sgcASN1_IsMinimalUnsignedInteger | Birimin okuduğu her yapı, belirtimi gereği DER'dir; bu yüzden uzunluklar DER kurallarına bağlıdır: belirsiz biçim reddedilir, kısa biçimin taşıyabileceği bir uzun biçim de öyle. INTEGER değerleri en küçük biçimde kodlanmamış bir ECDSA imzası da reddedilir, böylece tek bir imza iki şekilde yazılıp iki farklı değer sanılamaz. |
| 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. |
| CA yayını | sgcX509_CreateSigned, sgcX509_CreateSignedFromCSR | Bir CA anahtarıyla imzalanmış bir sertifika yayınlayın; ister bir seçenekler kaydından, ister ayrıştırılmış bir PKCS#10 isteğinden. |
| Kuantum sonrası imzalama anahtarları | sgcX509_MLDSAKey, sgcX509_SLHDSAKey | Bir ML-DSA veya SLH-DSA anahtarını bir TsgcX509SignKey içine sarın ve sgcX509_CreateSelfSignedEx, sgcX509_CreateCSREx ya da CA yayıncılarına verin. ML-DSA için RFC 9881, SLH-DSA için RFC 9909. |
| ML-KEM sertifikaları | ML-KEM konu anahtarıyla sgcX509_CreateSigned | RFC 9935. Bir CA, imzalayamayan bir ML-KEM genel anahtarını sertifikalandırabilir; bu yüzden sertifika yayınlanmadan önce sahiplik başka bir yolla kanıtlanmalıdır. |
| Okumada kuantum sonrası anahtar türleri | TsgcX509PublicKeyType | x509pkRSA, x509pkEC ve x509pkEd25519'un yanı sıra x509pkMLDSA, x509pkSLHDSA ve x509pkMLKEM. sgcX509_Parse, sgcX509_VerifySignedBy ve sgcX509_CSR_Verify hepsini işler. |
| Zincir kısıtlamaları | sgcX509_VerifyChain | basicConstraints pathLenConstraint değerini ve nameConstraints uzantısını dNSName, iPAddress, rfc822Name, uniformResourceIdentifier ve directoryName üzerinde zorunlu kılar. |
| Üretimde nameConstraints | TsgcX509Options.PermittedDNSNames, ExcludedDNSNames, PermittedIPRanges, ExcludedIPRanges | İzin verilen ve dışlanan alt ağaçları bir CA sertifikasına yazar, böylece yukarıdaki zincir doğrulayıcı bunları zorunlu kılabilir. |
| IPv6 adres SAN'ları | TsgcX509Options.IPAddresses | IPv4'ün yanı sıra, RFC 4291'in herhangi bir metin biçimindeki IPv6 adreslerini kabul eder. |
| 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. Genel anahtar önce FIPS 203 bölüm 7.2'nin girdi kontrollerinden geçer; bu yüzden yanlış uzunlukta olan ya da modül kontrolünü geçemeyen bir anahtar istisna oluşturur. |
| ML-KEM çözme (decapsulate) | sgcMLKEM_Decapsulate | Doğru uzunlukta olup çözülemeyen bir şifreli metin, hata yerine sözde rastgele bir gizli anahtar (örtük ret) üretir, bu yüzden zamanlama ve hata davranışı hiçbir şey ortaya çıkarmaz. Yanlış uzunlukta bir şifreli metin ya da özel anahtar veya hash kontrolünü geçemeyen bir özel anahtar, FIPS 203 bölüm 7.3'ün girdi kontrollerine göre önce istisna oluşturur. |
| 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. |
| Genel anahtar dışa ve içe aktarımı, DER | sgcMLDSA_ExportSubjectPublicKeyInfo / ImportSubjectPublicKeyInfo, ve birebir aynı sgcMLKEM_* ve sgcSLHDSA_* çiftleri | X.509 SubjectPublicKeyInfo, böylece kuantum sonrası bir genel anahtar bir RSA veya EC anahtarının girdiği yapıya girer. RFC 9881, RFC 9909 ve RFC 9935. |
| Özel anahtar dışa & içe aktarımı, DER | sgcMLDSA_ExportPrivateKeyInfo / ImportPrivateKeyInfo, ve sgcMLKEM_* ile sgcSLHDSA_* çiftleri | PKCS#8 OneAsymmetricKey, sürüm 0 ve 1. İçe aktarma anahtarın tutarlılığını kontrol eder: eşleşmeyen gömülü bir genel anahtar reddedilir, aynı anahtarın tohum ve genişletilmiş biçimleri uyuşmalıdır ve bir ML-DSA anahtarı kayıtlı t0 ve tr değerlerini yeniden üretmelidir. SLH-DSA, PK.root değerini tohumdan yeniden hesaplar; bu yaklaşık bir anahtar üretimi kadar maliyetlidir, bu yüzden bu içe aktarımlar aVerify parametresi alır, varsayılan True'dur ve kendi uygulamanızın ürettiği bir anahtar için False geçebilirsiniz. |
| PEM dışa ve içe aktarımı | sgcMLDSA_ExportPublicKeyPEM, ExportPrivateKeyPEM, ImportPublicKeyPEM, ImportPrivateKeyPEM, ve sgcMLKEM_* ile sgcSLHDSA_* setleri | RFC 7468, -----BEGIN ... -----END sarmalayıcısı; böylece anahtarlar PKI'nın geri kalanıyla aynı dosyalara ve aynı araçlara düşer. |
| Özel anahtar biçimi | TsgcPQCPrivateKeyFormat | ML-DSA ve ML-KEM özel anahtarlarının üç biçimi vardır. pqkfSeed yalnızca tohumu yazar (ML-DSA için 32 bayt, ML-KEM için 64 baytlık d||z tohumu), pqkfExpanded genişletilmiş anahtarı yazar, pqkfBoth ikisini birden taşır. SLH-DSA'nın yalnızca tek bir özel anahtar biçimi vardır. |
| Tohumla birlikte anahtar üretimi | sgcMLDSA_GenerateKeyPairAndSeed, sgcMLKEM_GenerateKeyPairAndSeed | Tohumu anahtar çiftiyle birlikte geri verir, böylece üretimden hemen sonra tohum biçimli bir PKCS#8 veya PEM dosyası yazılabilir. |
| X-Wing hibrit KEM | sgcXWing_GenerateKeyPair, sgcXWing_Encapsulate, sgcXWing_Decapsulate | draft-connolly-cfrg-xwing-kem-10: tek bir KEM olarak X25519 ile ML-KEM-768. Genel anahtar 1216 bayt, özel anahtar 32 bayt (tohum), şifreli metin 1120 bayt, paylaşılan gizli anahtar 32 bayt. |
| TLS 1.3 hibrit anahtar paylaşımları | sgcTLSHybrid_ClientKeyShare, sgcTLSHybrid_ServerKeyShare, sgcTLSHybrid_ClientSharedSecret, sgcTLSHybrid_GroupName, sgcTLSHybrid_Available | RFC 10024 grupları X25519MLKEM768, SecP256r1MLKEM768 ve SecP384r1MLKEM1024 (IANA kod noktaları 0x11EC, 0x11EB, 0x11ED). Bunlar bağımsız KEM değildir, yalnızca bir TLS anahtar paylaşımı oluştururlar. |
| JSON Web Token'lar için ML-DSA | JWTOptions.Algorithms.MLDSA.PrivateKey, PublicKey, Enabled, sgcMLDSA_ExportPublicJWK, sgcMLDSA_ExportPrivateJWK, sgcMLDSA_ImportJWK, sgcMLDSA_ImportJWKAsPEM | RFC 9964; bir sgcCrypto_* biriminde değil, sgcHTTP_JWT_MLDSA içinde yer alır. JWS algoritmaları ML-DSA-44, ML-DSA-65 ve ML-DSA-87 (jwtMLDSA44, jwtMLDSA65, jwtMLDSA87), istemcide bir PKCS#8 PEM, sunucuda bir SubjectPublicKeyInfo PEM, AKP JSON Web Key'leri ve bu yolun hiçbir yerinde OpenSSL yok. |
| Bilinen yanıt doğrulaması | NIST ACVP vektörleri | ML-KEM anahtar üretimi, kapsülleme ve çözme ile ML-DSA ve SLH-DSA anahtar üretimi, imza üretimi ve imza doğrulaması, sgcWebSockets QA paketindeki NIST ACVP bilinen yanıt vektörlerine karşı kontrol edilir. |
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.
sgcCrypto ilkelleri üzerine Object Pascal ile yazılmıştır ve aynı pakette gelir. sgcCrypto_* içinde değil, sgcSSL_NativeTLS* birimlerinde yer alır, bu yüzden yukarıda sayılan 43 birimden biri değildir.
| Yetenek | API | Notlar |
|---|---|---|
| Bir istemcide seçin | TLSOptions.IOHandler := iohNativeTLS | OpenSSL'i, SChannel'ı ve platform TLS arka uçlarını süreç içi Pascal motoruyla değiştirir. Hiçbir hedefte dağıtılacak bir şey yoktur. |
| Bir sunucuda seçin | SSLOptions.IOHandler := iohNativeTLS | Varsayılan Indy sunucu motoruyla ve IOCP ile EPOLL motorlarıyla çalışır. |
| Protokol sürümü | TLSOptions.Version | İzin verilen en düşük sürüm. tls1_2 veya tlsUndefined TLS 1.3 ya da TLS 1.2 için el sıkışma yapar, tls1_3 yalnızca TLS 1.3'e izin verir, tls1_0 veya tls1_1 ise bir yapılandırma hatası oluşturur. Bir sunucuda SSLOptions.Version aynısını yapar. Yalnızca TLS 1.2 için, CipherSuites içinde yalnızca TLS 1.2 paketlerini listeleyin. |
| Anahtar değişimi grupları | TLSOptions.NativeTLS_Options.Groups | İki nokta üst üste ile ayrılmış, OpenSSL biçiminde. Varsayılan değer: X25519MLKEM768:X25519:secp256r1:secp384r1, bu yüzden karşı taraf kabul ettiği sürece el sıkışma kuantum sonrası hibrittir. SGC_CRYPTO_FIPS ile yapılan bir derleme bunun yerine varsayılan olarak SecP256r1MLKEM768:SecP384r1MLKEM1024:secp256r1:secp384r1 kullanır. Üç hibrit grup yalnızca TLS 1.3'tedir, bu yüzden bir TLS 1.2 bağlantısı X25519, secp256r1 veya secp384r1 kullanır. |
| Şifre paketleri | TLSOptions.NativeTLS_Options.CipherSuites | İki nokta üst üste ile ayrılmış, OpenSSL biçiminde. Varsayılan değer, TLS 1.3 için TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256, TLS 1.2 için ise buna ek olarak AES-128-GCM, AES-256-GCM ve ChaCha20-Poly1305 ile ECDHE_ECDSA ve ECDHE_RSA'dır. AES-CBC'li ECDHE ve RSA anahtar değişimi yalnızca adlandırıldıklarında kullanılır; toplamda 20 TLS 1.2 paketi vardır. SGC_CRYPTO_FIPS ile yapılan bir derleme ChaCha20-Poly1305'i ve RSA anahtar değişimini dışarıda bırakır. |
| Güvenilen kökler | TLSOptions.RootCertFile, TLSOptions.NativeTLS_Options.UseSystemRoots | Kökler RootCertFile dosyasından gelir. İşletim sisteminin zaten güvendiği kökleri eklemek için UseSystemRoots değerini True yapın: Windows'ta ROOT deposu, diğer her platformda ise standart konumlar arasında bulunan ilk CA paket dosyası. macOS veya iOS anahtar zincirini ya da Android deposunu asla okumaz. Varsayılan olarak kapalıdır, bu yüzden kaynak RootCertFile olarak kalır. SSLOptions üzerindeki aynı özellik, bir sunucunun doğruladığı istemci sertifikaları için geçerlidir. |
| Zincir oluşturma | karşı tarafın gönderdiği sertifika zinciri | Zincirde yaprak sertifikadan bir güvenilen köke giden bir yol aranır, bu yüzden RFC 8446 bölüm 4.4.2'nin istediği gibi fazladan sertifikalar ve herhangi bir sıra kabul edilir. Arama geri izleme yapar; bu yüzden doğru düzenleyeni belirten ama hiçbir yere varmayan bir sertifika artık arkasındaki geçerli bir yolu gizlemez. Sertifika iptali ve sertifika ilkeleri kontrol edilmez. |
| Protokol kapsamı | RFC 8446, RFC 5246 | TLS 1.3 ve TLS 1.2. TLS 1.1, TLS 1.0 veya SSL yok. TLS 1.2, RFC 7627'nin genişletilmiş ana sırrını ve her iki tarafta da RFC 8446 düşürme korumasını kullanır, yeniden görüşmeyi ve SHA-1 imzalarını reddeder (RFC 9155) ve CBC kayıtlarını sabit zamanda denetler. |
| Uygulanmayanlar | n/a | Oturum devam ettirme ve PSK yok, 0-RTT yok, QUIC yok. |
| Eş doğrulama olayı | OnSSLVerifyPeer | Bu motorda kullanılamaz; motorun kendi doğrulama kancaları vardır. Kodunuz bu olaya bağlıysa OpenSSL'de ya da bir platform arka ucunda kalın. |
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 BCryptGenRandom (Windows CNG), 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 BCryptGenRandom (Windows CNG), POSIX hedeflerde /dev/urandom; hepsi aynı sgcRandomBytes çağrısının arkasında. Baytlar doğrudan işletim sisteminin üretecinden gelir, üzerinde kendine ait bir üreteç çalışmaz. Windows’ta RtlGenRandom ve ardından CryptGenRandom yalnızca BCryptGenRandom kullanılamadığında devreye girer ve hiçbir kaynak okunamazsa zayıf bayt döndürmek yerine bir istisna fırlatılır. |
| FIPS modu | Varsayılan olarak kapalı olan isteğe bağlı SGC_CRYPTO_FIPS tanımı, derleme zamanında onaylanmamış her algoritmayı 43 birimden kaldırır ve çalışma zamanında birkaç parametre kuralını denetler. Kütüphaneyi FIPS onaylı algoritmalarla sınırlı tutar, ancak sgcCrypto FIPS 140-3 doğrulanmış bir modül değildir ve bu tanım bir doğrulama iddiası taşımaz. FIPS Modu |
| 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. |