Wszystko, co robi sgcCrypto, zestawione dla 43 jednostek na dysku. Nie ma tu komponentów ani właściwości w trybie projektowania: każdy wiersz poniżej to funkcja lub procedura wywoływana bezpośrednio. Pełny kod źródłowy jest dołączony do każdej licencji. Poniższe kotwice prowadzą do sześciu rodzin możliwości, do których należą jednostki.
sgcCrypto nie ma komponentów. 43 jednostki poniżej eksportują zwykłe funkcje, nie ma tu klasy Tsgc* ani jednostki sgcCrypto_Reg.pas. Dodaj jednostkę do sekcji uses i wywołaj funkcję.
Już dołączony. sgcCrypto jest dołączony bezpłatnie do sgcWebSockets Standard, Professional i Enterprise, a także do All-Access. Jest też sprzedawany samodzielnie (z dołączonym środowiskiem uruchomieniowym sgcWebSockets Core) dla klientów posiadających wyłącznie Core. Zobacz Cennik.
AES, CCM, ChaCha20, Poly1305, 5 jednostek
SHA-2/3, BLAKE2, Argon2, 11 jednostek
Ed25519, X25519, Schnorr, RSA, 10 jednostek
X.509, ASN.1, RSA i EC CSR, 5 jednostek
ML-KEM, ML-DSA, SLH-DSA, 6 jednostek
HOTP/TOTP, kodowanie, ZIP AES, 6 jednostek
Każda jednostka sgcCrypto_*.pas pod sgcWebSockets/delphi/Source/, pogrupowana według rodziny.
| Jednostka | Rodzina | Co robi |
|---|---|---|
sgcCrypto_AES | Symetryczna | AES-CBC, AES-GCM (AEAD), AES-CTR. |
sgcCrypto_Modes | Symetryczna | AES-ECB, OFB, CFB, CTS, CCM (AEAD), Key Wrap / Key Wrap with Padding oraz siedem schematów wypełniania. |
sgcCrypto_CMAC | Symetryczna | Uwierzytelnianie wiadomości AES-CMAC i AES-GMAC. |
sgcCrypto_ChaCha | Symetryczna | ChaCha20, XChaCha20, Salsa20, XSalsa20. |
sgcCrypto_Poly1305 | Symetryczna | MAC Poly1305, AEAD ChaCha20-Poly1305 i XChaCha20-Poly1305. |
sgcCrypto_SHA2 | Skróty i KDF | SHA-1, SHA-224, SHA-256, SHA-384, SHA-512. |
sgcCrypto_Keccak | Skróty i KDF | SHA-3, SHAKE128/256, cSHAKE, KMAC. |
sgcCrypto_Blake2b | Skróty i KDF | BLAKE2b, kluczowany lub nie. |
sgcCrypto_Blake2s | Skróty i KDF | BLAKE2s, kluczowany lub nie. |
sgcCrypto_HMAC | Skróty i KDF | HMAC-SHA1/256/384/512. |
sgcCrypto_KDF | Skróty i KDF | PBKDF2, KDF1, KDF2 i X9.63, wybieralny skrót. |
sgcCrypto_HKDF | Skróty i KDF | HKDF extract-and-expand. |
sgcCrypto_Scrypt | Skróty i KDF | scrypt, KDF wymagający dużo pamięci. |
sgcCrypto_Argon2 | Skróty i KDF | Argon2d, Argon2i, Argon2id. |
sgcCrypto_SipHash | Skróty i KDF | Kluczowany skrót SipHash-2-4. |
sgcCrypto_TLSH | Skróty i KDF | Rozmyty skrót TLSH i różnica podobieństwa. |
sgcCrypto_Ed25519 | Podpisy i wymiana kluczy | Podpis / weryfikacja Ed25519. |
sgcCrypto_X25519 | Podpisy i wymiana kluczy | Diffie-Hellman X25519. |
sgcCrypto_Ed448 | Podpisy i wymiana kluczy | Podpis / weryfikacja Ed448. |
sgcCrypto_X448 | Podpisy i wymiana kluczy | Diffie-Hellman X448. |
sgcCrypto_GF448 | Podpisy i wymiana kluczy | Wewnętrzna arytmetyka ciała GF(2^448-2^224-1) dla Ed448/X448. |
sgcCrypto_ECCurves | Podpisy i wymiana kluczy | ECDSA / ECDH nad secp256k1, Brainpool P256r1/P384r1/P512r1 oraz NIST P-256/P-384/P-521, podpisy DER, eksport/import kluczy oraz Schnorr BIP-340. |
sgcCrypto_EC | Podpisy i wymiana kluczy | Ogólny podpis/weryfikacja EC jako JWS (ES256/384/512), ECDH. |
sgcCrypto_RSA | Podpisy i wymiana kluczy | Podpis RSA PKCS#1 v1.5, weryfikacja PKCS#1 v1.5 / PSS, z PEM lub surowych danych. |
sgcCrypto_RSA_Keys | Podpisy i wymiana kluczy | Generowanie kluczy RSA, OAEP (z niezależnym skrótem MGF1), PSS, podpis/weryfikacja/szyfrowanie/deszyfrowanie PKCS#1 v1.5, eksport i import DER/PEM PKCS#1 i PKCS#8. |
sgcCrypto_ECIES | Podpisy i wymiana kluczy | Hybrydowe szyfrowanie ECIES seal / open nad X25519. |
sgcCrypto_ASN1 | PKI | Czytnik DER, kodek PEM, parsowanie kluczy PKCS#1/SEC 1. |
sgcCrypto_DER | PKI | Prymitywy zapisu DER. |
sgcCrypto_BigInteger | PKI | Wewnętrzna arytmetyka liczb całkowitych o dowolnej precyzji. |
sgcCrypto_X509 | PKI | Parsowanie X.509, weryfikacja, łańcuch, CRL, unieważnienie. |
sgcCrypto_X509_Gen | PKI | Generowanie certyfikatu samopodpisanego i CSR PKCS#10, podpisanego kluczem RSA lub EC, z alternatywnymi nazwami podmiotu typu URI. |
sgcCrypto_MLKEM | Post-kwantowa | Enkapsulacja kluczy ML-KEM (FIPS 203), 3 zestawy parametrów. |
sgcCrypto_MLKEM_Poly | Post-kwantowa | Wewnętrzna arytmetyka pierścienia wielomianów za ML-KEM. |
sgcCrypto_MLKEM_Hybrid | Post-kwantowa | Hybrydowa enkapsulacja kluczy X25519 + ML-KEM. |
sgcCrypto_MLDSA | Post-kwantowa | Podpisy cyfrowe ML-DSA (FIPS 204), 3 zestawy parametrów. |
sgcCrypto_MLDSA_Poly | Post-kwantowa | Wewnętrzna arytmetyka pierścienia wielomianów za ML-DSA. |
sgcCrypto_SLHDSA | Post-kwantowa | Podpisy SLH-DSA (FIPS 205), 6 zestawów parametrów SHAKE. |
sgcCrypto_OTP | OTP i inne | HOTP, TOTP, okno weryfikacji w stałym czasie. |
sgcCrypto_Encoding | OTP i inne | Porównanie w stałym czasie, bezpieczne zerowanie, hex/Base64url/Base32. |
sgcCrypto_Zip_AE2 | OTP i inne | Szyfrowanie WinZip AES dla wpisów ZIP, AE-1 / AE-2. |
sgcCrypto_Legacy | OTP i inne | MD4, MD5, HMAC-MD5, DES-ECB, RIPEMD-160 i HMAC-RIPEMD160, wyłącznie dla współpracy wstecznej. |
sgcCrypto_Random | OTP i inne | Wieloplatformowy CSPRNG. |
sgcCrypto_Int64 | OTP i inne | Wewnętrzna emulacja liczby 64-bitowej dla Delphi 7. |
AES w trybach faktycznie używanych w kodzie produkcyjnym, plus rodzina AEAD ChaCha20/Poly1305.
| Możliwość | Funkcja | Uwagi |
|---|---|---|
| AES-CBC | sgcAES_CBC_Encrypt / sgcAES_CBC_Decrypt | Wypełnienie PKCS#7, 16-bajtowy IV. Długość klucza wybiera szyfr: 16/24/32 bajty = AES-128/192/256. |
| AES-CBC, bez wypełnienia | sgcAES_CBC_Encrypt_NoPad / sgcAES_CBC_Decrypt_NoPad | Tryb, który Java zapisuje jako AES/CBC/NoPadding. Dane wejściowe muszą już być wielokrotnością 16 bajtów; niewyrównane dane wejściowe zgłaszają wyjątek, zamiast zostać po cichu wypełnione w coś, czego druga strona nie odczyta. |
| AES-GCM (AEAD) | sgcAES_GCM_Encrypt / sgcAES_GCM_Decrypt | Zalecany 12-bajtowy IV. 16-bajtowy znacznik, porównywany w stałym czasie; deszyfrowanie zwraca False i pusty jawny tekst przy nieudanej weryfikacji znacznika. |
| AES-CCM (AEAD) | sgcAES_CCM_Encrypt / sgcAES_CCM_Decrypt | Szyfr AEAD, który określają stosy ograniczone zasobowo i IoT, Zigbee, 802.15.4, Bluetooth i zestawy szyfrów CCM w TLS, ponieważ potrzebuje wyłącznie szyfru blokowego i żadnej tablicy GHASH. Nonce 7 do 13 bajtów, znacznik 4 do 16 bajtów, weryfikowany w stałym czasie. |
| AES-CTR | sgcAES_CTR | AES-CM w stylu SRTP (RFC 3711). Wywołanie symetryczne, bez wypełnienia, 128-bitowy licznik big-endian. |
| AES-ECB | sgcAES_ECB_Encrypt / sgcAES_ECB_Decrypt | Bez IV, bez łańcuchowania. Dołączony dla współpracy z formatami, które go wymagają. |
| Schematy wypełniania | sgcPad_Add / sgcPad_Remove, sgcAES_CBC_EncryptPad / DecryptPad, sgcAES_ECB_EncryptPad / DecryptPad | TsgcPadding obejmuje None, PKCS#7, Zero, ANSI X9.23, ISO 7816-4, ISO 10126-2 i TBC, dzięki czemu CBC i ECB mogą odczytywać i zapisywać dane z systemu, który nie wybrał PKCS#7. sgcPad_Remove zwraca False tą samą ścieżką dla każdego rodzaju złego wypełnienia. |
| AES-OFB / AES-CFB | sgcAES_OFB, sgcAES_CFB_Encrypt / sgcAES_CFB_Decrypt | Tryby sprzężenia zwrotnego w stylu szyfru strumieniowego. |
| AES-CTS | sgcAES_CTS_Encrypt / sgcAES_CTS_Decrypt | Ciphertext stealing: szyfruje dane niebędące wielokrotnością rozmiaru bloku bez narzutu wypełnienia. |
| AES Key Wrap | sgcAES_KeyWrap / sgcAES_KeyUnwrap | RFC 3394, do owijania jednego klucza pod innym. |
| AES Key Wrap with Padding | sgcAES_KeyWrapPad / sgcAES_KeyUnwrapPad | RFC 5649, dla materiału klucza niebędącego wielokrotnością 8 bajtów. |
| AES-CMAC | sgcAES_CMAC / sgcAES_CMAC_Verify | Kod uwierzytelniania wiadomości RFC 4493. |
| AES-GMAC | sgcAES_GMAC / sgcAES_GMAC_Verify | Tryb GCM ograniczony wyłącznie do uwierzytelniania: cała wiadomość podróżuje jako dane dodatkowe, nic nie jest szyfrowane. IV nigdy nie może się powtórzyć pod tym samym kluczem, a 16-bajtowy znacznik jest porównywany w stałym czasie. |
| Prymitywy blokowe niskiego poziomu | sgcAES_ExpandKey, sgcAES_EncryptBlock, sgcAES_DecryptBlock | Ujawnione dla powyższych jednostek trybów i MAC; wywołuj je bezpośrednio tylko do zbudowania trybu, którego jeszcze nie ma. |
| ChaCha20 | sgcChaCha20 | RFC 8439, 96-bitowy nonce, 32-bitowy licznik. |
| XChaCha20 | sgcXChaCha20 | 192-bitowy rozszerzony nonce, bezpieczny do losowego generowania nonce na dużą skalę. |
| Salsa20 / XSalsa20 | sgcSalsa20 / sgcXSalsa20 | Poprzednia rodzina szyfrów strumieniowych, oba rozmiary nonce. |
| Wyprowadzanie podklucza | sgcHChaCha20 / sgcHSalsa20 | To, czego warianty X używają wewnętrznie do wyprowadzenia podklucza z pierwszych 16 bajtów nonce. |
| MAC Poly1305 | sgcPoly1305 / sgcPoly1305_Verify | Jednorazowy uwierzytelniacz, RFC 8439. Nigdy nie używaj ponownie klucza Poly1305. |
| AEAD ChaCha20-Poly1305 | sgcChaCha20Poly1305_Encrypt / _Decrypt | Szyfr AEAD stojący za drugim zestawem szyfrów TLS 1.3 i za SSH. |
| AEAD XChaCha20-Poly1305 | sgcXChaCha20Poly1305_Encrypt / _Decrypt | Ten sam AEAD, 192-bitowy nonce, konstrukcja, którą libsodium nazywa crypto_aead_xchacha20poly1305_ietf. |
Każda popularna rodzina skrótów, plus PBKDF2, HKDF, scrypt i wszystkie trzy warianty Argon2.
| Możliwość | Funkcja | Uwagi |
|---|---|---|
| SHA-1 / SHA-2 | sgcSHA1, sgcSHA224, sgcSHA256, sgcSHA384, sgcSHA512 | FIPS 180-4. SHA-1 zachowany dla współpracy wstecznej, niezalecany do nowych podpisów. |
| SHA-3 | sgcSHA3_224 / _256 / _384 / _512 | FIPS 202, gąbka Keccak, strukturalnie niezależna od SHA-2. |
| SHAKE128 / SHAKE256 | sgcSHAKE128 / sgcSHAKE256 | Funkcje o rozszerzalnym wyjściu: żądaj dowolnej długości skrótu. |
| cSHAKE128 / cSHAKE256 | sgcCSHAKE128 / sgcCSHAKE256 | SHAKE z separacją domen, NIST SP 800-185, podstawa KMAC. |
| KMAC128 / KMAC256 | sgcKMAC128 / sgcKMAC256 | MAC oparty na Keccak, ze zmienną długością wyjścia. |
| BLAKE2b | sgcBlake2b / sgcBlake2b_Keyed | RFC 7693, skróty do 64 bajtów, wbudowane kluczowanie (bez osobnego HMAC). |
| BLAKE2s | sgcBlake2s / sgcBlake2s_Keyed | RFC 7693, skróty do 32 bajtów, dostrojone do platform 32-bitowych. |
| Skróty strumieniowe | sgcBlake2b_Init/_Update/_Final, odpowiadające wywołania dla Keccak/Blake2s | Do haszowania danych zbyt dużych, by trzymać je naraz w pamięci. |
| HMAC | sgcHMAC_SHA1 / _SHA256 / _SHA384 / _SHA512 | Kluczowane haszowanie RFC 2104 nad rodziną SHA-1/2. |
| RIPEMD-160 / HMAC-RIPEMD160 | sgcRIPEMD160, sgcHMAC_RIPEMD160 | ISO/IEC 10118-3 i RFC 2286. 160-bitowy skrót, który adresy Bitcoin nakładają na SHA-256, i ten sam, który wymienia z nazwy OpenPGP. |
| PBKDF2 | sgcPBKDF2, sgcPBKDF2_SHA1 / _SHA256 / _SHA512 | RFC 8018. Tylko umiarkowanie wymagający pamięci; preferuj Argon2id lub scrypt, gdy masz wybór. |
| HKDF | sgcHKDF_Extract_SHA256 / _SHA384, sgcHKDF_Expand_SHA256 / _SHA384, sgcHKDF_SHA256 / _SHA384 | RFC 5869, wyprowadzanie kluczy extract-then-expand, standardowy sposób zamiany współdzielonego sekretu na kilka kluczy. |
| KDF1 / KDF2 / X9.63 | sgcKDF1, sgcKDF2, sgcKDF_X963 | Wyprowadzenia w trybie licznikowym zdefiniowane przez ISO 18033-2, IEEE 1363a i ANSI X9.63, czyli te, które z nazwy wymieniają RSA-KEM i ECIES. KDF1 liczy od 0, a KDF2 od 1, różnica, która wywołała realne błędy interoperacyjności, więc sprawdź, o którą z nich chodzi w Twojej specyfikacji. |
| scrypt | sgcScrypt | RFC 7914, wymagający dużo pamięci, znacznie lepiej odporny na atak GPU/ASIC niż PBKDF2. |
| Argon2 | sgcArgon2 (d / i / id), wygodny opakowujący sgcArgon2id | RFC 9106, zwycięzca Password Hashing Competition. Pełny interfejs z opcjonalnym sekretem (pieprzem) i danymi powiązanymi. |
| SipHash-2-4 | sgcSipHash24 / sgcSipHash24_Value | Szybka kluczowana funkcja pseudolosowa do kluczy tablic mieszających, odporna na atak hash-flooding. |
| Rozmyty skrót TLSH | sgcTLSH, sgcTLSH_Init/_Update/_Final | Skrót wrażliwy na lokalność do wykrywania niemal identycznych plików, nie skrót kryptograficzny. |
| Wynik podobieństwa TLSH | sgcTLSH_Diff | Odległość między dwoma skrótami TLSH; niższa wartość oznacza większe podobieństwo. |
Podpisuj, weryfikuj i wyprowadzaj sekrety współdzielone w pięciu odrębnych rodzinach krzywych plus RSA.
| Możliwość | Funkcja | Uwagi |
|---|---|---|
| Podpis / weryfikacja Ed25519 | sgcEd25519_Sign / sgcEd25519_Verify | RFC 8032. 32-bajtowy klucz publiczny, 64-bajtowy podpis. Weryfikacja odrzuca punkty niekanoniczne oraz S >= L zgodnie z sekcją 5.1.7. |
| Wymiana kluczy X25519 | sgcX25519, sgcX25519_PublicKey, sgcX25519_SharedSecret | Diffie-Hellman RFC 7748 nad Curve25519. |
| Podpis / weryfikacja Ed448 | sgcEd448_GenerateKeyPair, sgcEd448_Sign, sgcEd448_Verify | RFC 8032, 448-bitowa krzywa EdDSA (Goldilocks). |
| Wymiana kluczy X448 | sgcX448, sgcX448_PublicKey, sgcX448_SharedSecret | Diffie-Hellman RFC 7748 nad Curve448. |
| secp256k1 | sgcECDSA_SignHash / VerifyHash z eccSecp256k1 | Krzywa Bitcoin/Ethereum, SEC 2, w sgcCrypto_ECCurves. |
| Brainpool P256r1 / P384r1 / P512r1 | te same funkcje z eccBrainpoolP256r1 / P384r1 / P512r1 | RFC 5639, powszechne w profilach eIDAS UE i rządowych. |
| NIST P-256 / P-384 / P-521 | te same funkcje z eccP256 / eccP384 / eccP521 | TsgcECCurve nazywa teraz siedem krzywych, więc generowanie kluczy, podpisywanie, weryfikacja, ECDH i kompresja punktu docierają teraz do krzywych pierwszych NIST z surowych bajtów klucza, a nie tylko z pliku PEM. |
| Deterministyczny nonce ECDSA | wbudowany w sgcECDSA_SignHash | RFC 6979: nonce jest wyprowadzany z klucza prywatnego i wiadomości, bez trybu awarii RNG. |
| ECDH (secp256k1 / Brainpool) | sgcECDH_SharedSecret | Sekret współdzielony nad tymi samymi czterema krzywymi. |
| Kompresja punktu | sgcEC_Compress / sgcEC_Decompress | Przechowuj lub przesyłaj krótszą, skompresowaną postać klucza publicznego. |
| EC jako JWS (ES256/384/512) | sgcECDSA_SignJWS / sgcECDSA_VerifyJWS | Krzywa wybierana automatycznie na podstawie żądanej długości bitowej, podpis/weryfikacja bezpośrednio z klucza PEM, bliźniak zorientowany na JOSE dla ECCurves. |
| Ogólne ECDH | sgcECDH | Sekret współdzielony z surowego klucza prywatnego i publicznego punktu drugiej strony. |
| Weryfikacja ECDSA raw / DER | sgcECDSA_VerifyRaw / sgcECDSA_VerifyDER | Weryfikacja wobec surowej krotki (Qx, Qy, r, s) lub podpisu zakodowanego w DER. |
| Podpisywanie ECDSA w DER i konwersja | sgcECDSA_SignDER / sgcECDSA_VerifyDER, sgcECDSA_RawToDER / sgcECDSA_DERToRaw | X.509, CMS i TLS niosą DER ECDSA-Sig-Value, SEQUENCE złożony z INTEGER r, a potem INTEGER s. JOSE i WebAuthn niosą zamiast tego surową parę R || S. Podpisuj wprost w dowolną z tych postaci albo konwertuj istniejący podpis między nimi. |
| Podpisy Schnorra (BIP-340) | sgcSchnorr_PublicKey, sgcSchnorr_Sign, sgcSchnorr_Verify | Wyłącznie secp256k1, z 32-bajtowymi kluczami publicznymi x-only i 64-bajtowymi podpisami: to, czego używają Taproot, Nostr i Lightning. sgcSchnorr_TaggedHash jest udostępniony, aby na tej samej konstrukcji można było zbudować tagi BIP-341 i BIP-342. |
| Podpis RSA (PKCS#1 v1.5) | sgcRSA_SignPKCS1 | Z klucza prywatnego PEM, skrót SHA-1/256/384/512. |
| Weryfikacja RSA (PKCS#1 v1.5 / PSS) | sgcRSA_VerifyPKCS1, sgcRSA_VerifyPSS, oraz warianty _Raw nad modułem/wykładnikiem | RFC 8017. Weryfikacja działa z klucza PEM albo surowego modułu i wykładnika, bez potrzeby budowania obiektu klucza. |
| Generowanie klucza RSA | sgcRSA_GenerateKey | Dowolna żądana długość bitowa, test pierwszości Millera-Rabina. |
| Szyfrowanie RSA-OAEP | sgcRSA_OAEP_Encrypt / sgcRSA_OAEP_Decrypt | Optymalne asymetryczne wypełnienie szyfrujące RFC 8017. |
| RSA-OAEP z niezależnym skrótem MGF1 | pięcioparametrowe przeciążenia sgcRSA_OAEP_Encrypt / sgcRSA_OAEP_Decrypt | Ustal skrót etykiety i skrót MGF1 osobno. OAEPWithSHA256AndMGF1Padding oznacza SHA-256 dla obu w Bouncy Castle, ale SHA-256 z MGF1-SHA1 w SunJCE, i ta niezgodność jest zwykłą przyczyną niepowodzeń interoperacyjności z Javą. |
| Szyfrowanie RSA PKCS#1 v1.5 | sgcRSA_PKCS1_Encrypt / sgcRSA_PKCS1_Decrypt | RFC 8017 sekcja 7.2, tryb, który Java nazywa RSA/ECB/PKCS1Padding. Deszyfrowanie przechodzi tę samą ścieżkę dla każdego niepowodzenia, więc nie daje padding oracle niczego do wykorzystania. Do wszystkiego nowego preferuj OAEP. |
| Podpisywanie RSA-PSS / PKCS#1 | sgcRSA_PSS_Sign / Verify, sgcRSA_PKCS1_Sign / Verify | Podpis bezpośrednio z wygenerowanego TsgcRSAPrivateKey. |
| Eksport klucza RSA | sgcRSA_ExportPrivateKeyPEM, sgcRSA_ExportPublicKeyPEM, odpowiadające wywołania DER | Kodowania PKCS#1 i SubjectPublicKeyInfo. |
| Eksport kluczy PKCS#8 i SEC 1 | sgcRSA_ExportPrivateKeyPKCS8DER / PKCS8PEM, sgcEC_ExportPrivateKeyPKCS8DER / PKCS8PEM, sgcEC_ExportPrivateKeySEC1DER / SEC1PEM, sgcEC_ExportSubjectPublicKeyInfo, sgcEC_ExportPublicKeyPEM | Kontener BEGIN PRIVATE KEY, jakiego oczekują Java, .NET i większość nowoczesnych narzędzi, obok postaci SEC 1 BEGIN EC PRIVATE KEY oraz SubjectPublicKeyInfo osadzanego w certyfikacie. Niezaszyfrowane, więc to, co wraca, to nagi materiał klucza. |
| Import kluczy RSA i EC | sgcRSA_ImportPrivateKeyDER / PEM, sgcRSA_ImportPublicKeyDER / PEM, sgcEC_ImportPrivateKeyDER / PEM, sgcEC_ImportPublicKeyDER / PEM | To wcześniej nie istniało: wygenerowany klucz dało się zapisać, ale nigdy wczytać z powrotem. Import przyjmuje PKCS#1, PKCS#8, SEC 1 i SubjectPublicKeyInfo, DER albo PEM, przelicza na nowo parametry CRT albo punkt publiczny, gdy plik ich nie zawiera, i zwraca False przy zniekształconych danych wejściowych zamiast zgłaszać wyjątek, więc niezaufane pliki można mu bezpiecznie przekazywać. |
| ECIES seal / open | sgcECIES_GenerateKeyPair, sgcECIES_Seal, sgcECIES_Open | Hybrydowe szyfrowanie do klucza publicznego X25519: efemeryczny ECDH plus AEAD, jedno wywołanie w każdą stronę. |
Odczytaj certyfikat wystawiony przez kogoś innego albo wygeneruj własny, z koderem i dekoderem DER pod spodem w obu przypadkach.
| Możliwość | Funkcja | Uwagi |
|---|---|---|
| Czytnik DER | sgcASN1_Read, sgcASN1_Next, sgcASN1_Content | Przechodzi strukturę DER węzeł po węźle. |
| Kodek PEM | sgcPEM_Decode / sgcPEM_Encode | RFC 7468, opakowanie -----BEGIN ... -----END wokół DER. |
| Parsowanie klucza RSA | sgcASN1_ParseRSAPrivateKey / PublicKey | Struktury klucza PKCS#1 (RFC 8017). |
| Parsowanie klucza EC | sgcASN1_ParseECPrivateKey / PublicKey | Struktury klucza SEC 1. |
| Zapis DER, strukturalny | sgcDER_Sequence, sgcDER_Set, sgcDER_Tagged, sgcDER_ContextExplicit / Implicit | Bloki budulcowe, z których składane jest każde pole certyfikatu. |
| Zapis DER, wartości | sgcDER_Integer, sgcDER_OctetString, sgcDER_BitString, sgcDER_Boolean, sgcDER_Null | Kodery wartości prymitywnych. |
| Zapis DER, ciągi i identyfikatory | sgcDER_OID, sgcDER_UTF8String, sgcDER_PrintableString, sgcDER_IA5String, sgcDER_Time | Identyfikatory obiektów, trzy typy ciągów używane przez X.509, oraz UTCTime/GeneralizedTime. |
| Parsowanie certyfikatu | sgcX509_Parse | Pełna struktura certyfikatu: podmiot, wystawca, ważność, klucz publiczny, rozszerzenia. |
| Weryfikacja podpisu / łańcucha | sgcX509_VerifySignedBy, sgcX509_VerifyChain | Weryfikuje jeden certyfikat wobec wystawcy albo przechodzi i weryfikuje tablicę certyfikatów DER. |
| Parsowanie CRL i unieważnienie | sgcX509_CRL_Parse, sgcX509_IsRevoked, sgcX509_CRL_VerifySignedBy | Parsuje listę unieważnionych certyfikatów (CRL) i sprawdza wobec niej numer seryjny. |
| Formatowanie nazw | sgcX509_SubjectRFC2253, sgcX509_IssuerRFC2253, sgcX509_SubjectOneLine | Ciągi nazwy wyróżniającej RFC 2253, do logowania i wyświetlania. |
| Rozszerzenia i SAN-y | sgcX509_GetExtension, sgcX509_GetCRLDistributionURIs | Odczyt dowolnych OID-ów rozszerzeń i adresów URI punktów dystrybucji CRL. |
| Generowanie certyfikatu samopodpisanego | sgcX509_CreateSelfSigned | Pełny TsgcX509Options: DN podmiotu i wystawcy, okno ważności, numer seryjny, flaga CA z ograniczeniem długości ścieżki, użycie klucza, rozszerzone użycie klucza, alternatywne nazwy podmiotu (w tym SAN-y IPv4). |
| Alternatywne nazwy podmiotu typu URI | TsgcX509Options.URIs | SAN-y typu uniformResourceIdentifier, dla tożsamości usługi w postaci URI zamiast nazwy hosta, w stylu SPIFFE. Wartość jest zapisywana dosłownie jako zawartość IA5String, więc przekaż pełny URI. |
| Generowanie CSR PKCS#10 | sgcX509_CreateCSR | Żądanie podpisania certyfikatu RFC 2986 z tego samego rekordu opcji. |
| Certyfikaty i CSR podpisane kluczem EC | sgcX509_CreateSelfSignedEx, sgcX509_CreateCSREx, sgcX509_ECKey, sgcX509_RSAKey | Podpisuj kluczem EC tak samo jak RSA, opakowując dowolny z nich w TsgcX509SignKey. Certyfikat EC ma w przybliżeniu jedną trzecią rozmiaru certyfikatu RSA i weryfikuje się dużo szybciej. TsgcX509Options.Hash nadal nazywa wyłącznie SHA, algorytm zależy od klucza, więc rhSHA256 z kluczem EC oznacza ecdsa-with-SHA256. |
| Wyjście PEM | sgcX509_ToPEM | Opakowuje wygenerowany DER jako gotowy do zapisu plik PEM. |
Trzy algorytmy sfinalizowane przez NIST w sierpniu 2024 jako FIPS 203, 204 i 205, plus hybrydowy kombinator na okres migracji.
| Możliwość | Funkcja | Uwagi |
|---|---|---|
| Generowanie klucza ML-KEM | sgcMLKEM_GenerateKeyPair, sgcMLKEM_GenerateKeyPairFromSeed | FIPS 203, dawniej Kyber. Trzy zestawy parametrów: mlkem512, mlkem768, mlkem1024. |
| Enkapsulacja ML-KEM | sgcMLKEM_Encapsulate, sgcMLKEM_EncapsulateWithSeed | Wytwarza świeży 32-bajtowy sekret współdzielony oraz szyfrogram, który go przenosi. |
| Dekapsulacja ML-KEM | sgcMLKEM_Decapsulate | Nigdy nie zawodzi: nieprawidłowy szyfrogram daje pseudolosowy sekret (niejawne odrzucenie) zamiast błędu, więc czas działania i zachowanie błędu niczego nie ujawniają. |
| Rozmiary ML-KEM | sgcMLKEM_PublicKeySize, PrivateKeySize, CiphertextSize, SharedSecretSize | Długości w bajtach dla każdego zestawu parametrów, do ustalania rozmiaru bufora. |
| Hybrydowe X25519 + ML-KEM | sgcHybrid_GenerateKeyPair, sgcHybrid_Encapsulate, sgcHybrid_Decapsulate | Łączy klasyczny i post-kwantowy sekret współdzielony przez KDF, więc wynik nigdy nie jest słabszy niż samo X25519. Zalecany dziś sposób wdrażania ML-KEM. |
| Generowanie klucza ML-DSA | sgcMLDSA_GenerateKeyPair, sgcMLDSA_GenerateKeyPairFromSeed | FIPS 204, dawniej Dilithium. Trzy zestawy parametrów: mldsa44, mldsa65, mldsa87. |
| Podpis / weryfikacja ML-DSA | sgcMLDSA_Sign / sgcMLDSA_Verify | Podpisywanie deterministyczne lub losowe zgodnie z interfejsem FIPS 204, plus ciąg kontekstu. |
| Rozmiary ML-DSA | sgcMLDSA_PublicKeySize, PrivateKeySize, SignatureSize | Długości w bajtach dla każdego zestawu parametrów. |
| Generowanie klucza SLH-DSA | sgcSLHDSA_GenerateKeyPair, sgcSLHDSA_GenerateKeyPairFromSeed | FIPS 205, dawniej SPHINCS+. Bezstanowe podpisy oparte na skrótach: bezpieczeństwo opiera się wyłącznie na funkcji skrótu, nie na założeniu o kratach czy krzywej. |
| Podpis / weryfikacja SLH-DSA | sgcSLHDSA_Sign / sgcSLHDSA_Verify | Sześć zestawów parametrów SHAKE: slhShake128s, slhShake128f, slhShake192s, slhShake192f, slhShake256s, slhShake256f. Zestawy s faworyzują małe podpisy, zestawy f szybkie podpisywanie. |
| Rozmiary i nazewnictwo SLH-DSA | sgcSLHDSA_PublicKeySize, PrivateKeySize, SignatureSize, sgcSLHDSA_ParamsName | Podpisy SLH-DSA są duże (od 7,8 KB do 49 KB w zależności od zestawu); ustal rozmiar bufora przed podpisaniem. |
sgcCrypto nie oferuje ed25519187 ani SPECK. ed25519187 nie ma opublikowanej specyfikacji, a SPECK zostało wycofane ze standaryzacji ISO w 2018 roku; żadne z nich nie jest tutaj zaimplementowane.
Warstwa narzędziowa: kody jednorazowe, kodowania wykorzystywane przez pozostałe rodziny oraz szyfrowanie WinZip AES.
| Możliwość | Funkcja | Uwagi |
|---|---|---|
| HOTP | sgcHOTP | RFC 4226, hasło jednorazowe oparte na liczniku. |
| TOTP | sgcTOTP, sgcTOTP_FromBase32 | RFC 6238, hasło jednorazowe oparte na czasie; wariant Base32 przyjmuje sekret dokładnie tak, jak wyświetla go aplikacja uwierzytelniająca. |
| Weryfikacja TOTP | sgcTOTP_Verify | Sprawdza podany kod w oknie kroków w stałym czasie, więc ani wynik, ani jego pozycja nie ujawniają się przez czas działania. Sama w sobie nie zatrzymuje powtórek; śledzenie użytych kodów należy do wywołującego. |
| Porównanie w stałym czasie | sgcConstantTimeEquals | Używane w całej bibliotece do porównań znaczników i MAC. |
| Bezpieczne zerowanie | sgcSecureZero | Nadpisuje bufor bajtów, tak by materiał klucza nie pozostawał w pamięci. |
| Hex | sgcHexEncode / sgcHexDecode | Hex małymi literami, dekodowanie niewrażliwe na wielkość liter. |
| Base64url | sgcBase64UrlEncode / sgcBase64UrlDecode | RFC 4648 sekcja 5, bez wypełnienia, kodowanie używane przez JWT i JOSE. |
| Base32 | sgcBase32Encode / sgcBase32Decode | RFC 4648 sekcja 6, kodowanie używane przez sekrety TOTP i aplikacje uwierzytelniające. |
| Wyprowadzanie kluczy WinZip AES | sgcZipAE2_DeriveKeys | Klucz oparty na PBKDF2, klucz uwierzytelniający i weryfikator hasła z hasła i soli. |
| Szyfrowanie / deszyfrowanie WinZip AES | sgcZipAE2_Encrypt / sgcZipAE2_Decrypt | AE-1 i AE-2, AES-128/192/256, rozmiar soli na wpis przez TsgcZipAESStrength. |
| Pakowanie wpisu WinZip | sgcZipAE2_PackEntry / sgcZipAE2_UnpackEntry | Łączy sól, weryfikator, szyfrogram i kod uwierzytelniający w układ na dysku. |
| Dodatkowe pole WinZip | sgcZipAE2_BuildExtraField / sgcZipAE2_ParseExtraField | Pole dodatkowe 0x9901, które oznacza wpis ZIP jako zaszyfrowany AES. |
| Starsze skróty (tylko interoperacyjność) | sgcMD4, sgcMD5, sgcHMAC_MD5 | Zachowane do odczytu starszych formatów i protokołów; nie używać w nowych projektach. |
| Starszy szyfr (tylko interoperacyjność) | sgcDES_EncryptECB / sgcDES_DecryptECB, sgcDES_NTLM7to8 | DES-ECB oraz oparty na DES krok ekspansji klucza NTLM, oba wycofane (FIPS 46-3), zachowane dla współpracy wstecznej. |
| Bezpieczne losowe bajty | sgcRandomBytes / sgcRandomFill | Windows CryptoAPI pod MSWINDOWS, /dev/urandom gdzie indziej, jedno wywołanie w obu przypadkach. |
Co jest obsługiwane, podane precyzyjnie.
| Obszar | Szczegóły |
|---|---|
| System operacyjny | Żadna osłona MSWINDOWS ani inna osłona platformowa nie otacza SGC_CRYPTO w sgcVer.inc. Wszystkie 43 jednostki kompilują się dla Win32, Win64, Linux64, macOS, iOS i Android. |
| Źródło liczb losowych | Jedyna jednostka świadoma platformy, sgcCrypto_Random, wybiera CSPRNG dla celu: Windows CryptoAPI pod MSWINDOWS, /dev/urandom na celach POSIX, za tym samym wywołaniem sgcRandomBytes. |
| Delphi | Delphi 7 do RAD Studio 13 Florence. Nigdzie nie zakłada się natywnego typu 64-bitowego: sgcCrypto_Int64 oraz typ TsgcBigInt w sgcCrypto_BigInteger emulują arytmetykę potrzebną skrótom, krzywym i jednostkom post-kwantowym. |
| C++ Builder | C++ Builder poprzez wygenerowane nagłówki, to samo drzewo źródeł. |
| Ślad w trybie projektowania | Brak. Nie ma jednostki sgcCrypto_Reg.pas, nic nie jest rejestrowane przez RegisterComponents, i żadna jednostka nie pojawia się na stronie palety komponentów. |
| Zależności | Brak powiązania z OpenSSL, brak zewnętrznego DLL. Każdy prymityw jest zaimplementowany bezpośrednio w Object Pascal wewnątrz jednostki, do której się odwołujesz. |
| Kod źródłowy | Pełny kod źródłowy Object Pascal w każdej płatnej wersji oraz w pakietach edycji, które już zawierają sgcCrypto. |
| Redystrybucja | Budowane przez Ciebie binaria są wolne od opłat licencyjnych, bez opłaty za stanowisko czy serwer w środowisku uruchomieniowym. |