Voraussetzungen

Was Ihre Anwendung, der Rechner, auf dem sie läuft, und Ihre Entwicklungsumgebung mitbringen müssen.

Die Erweiterungen von CertificateRequest, X509SignatureGenerator und CopyWithPrivateKey gibt es ab .NET Framework 4.7.2, weil .NET diese Typen erst dort einführt. Unter 4.6.2 stellen Sie Zertifikate mit X509CertificateBuilder aus. Alle Unterschiede: Zielsysteme.

Alle Post-Quanten-Verfahren rechnet OpenSSL. Die Bibliothek liefert es nicht mit.

• Version: 3.5 oder höher. Die Bibliothek lädt jede Fassung ab 3.0 und fragt die Installation dann je Verfahren, ob sie es anbietet. ML-DSA und ML-KEM bietet der Default-Provider ab 3.5 an, Argon2id ab 3.2. Fehlt ein Verfahren, wirft die Bibliothek eine CryptographicException, die Verfahren, Version und Pfad nennt; EnablePostQuantum prüft ML-DSA-65 und ML-KEM-768 schon beim Start.
• Bestandteile: libcrypto für alle Funktionen dieser Bibliothek.
• Architektur: passend zum Prozess. Ein 32-Bit-Prozess braucht ein 32-Bit-OpenSSL.
• Dateinamen: libcrypto-3-x64.dll (Windows, 64 Bit), libcrypto-3.dll (Windows, 32 Bit), libcrypto-3-arm64.dll (Windows auf ARM), libcrypto.so.3 (Linux), libcrypto.3.dylib (macOS).

Wie Sie die Bibliothek auf die Installation verweisen: So binden Sie OpenSSL ein.

• SDK: .NET 10 SDK zum Übersetzen der Bibliothek; ihr Quelltext verwendet Sprachmittel von C# 14. Das gilt auch, wenn Ihre Anwendung für .NET Framework übersetzt wird.

• Einbindung: Die Bibliothek wird als Projektverweis eingebunden:

  <ItemGroup>
    <ProjectReference Include="..\sys-sec-crypto\WKL.System.Security.Cryptography.Extensions.csproj" />
  </ItemGroup>

  Für Blazor WebAssembly verweisen Sie stattdessen auf WKL.System.Security.Cryptography.WASM\WKL.System.Security.Cryptography.WASM.csproj.

• Die erste hybride Zertifikatskette
• So binden Sie OpenSSL ein
• Zielsysteme