== WvdS Crypto Library ==
====== WvdS.System.Security.Cryptography ======

Post-quantum cryptography extension for .NET - based on OpenSSL 3.6.

----

===== Overview =====

**WvdS.System.Security.Cryptography** extends ''System.Security.Cryptography''((Microsoft .NET: https://learn.microsoft.com/dotnet/api/system.security.cryptography)) from Microsoft with post-quantum cryptography. The library uses OpenSSL 3.6((OpenSSL: https://www.openssl.org/)) for ML-DSA((NIST FIPS 204: https://csrc.nist.gov/pubs/fips/204/final)) and ML-KEM((NIST FIPS 203: https://csrc.nist.gov/pubs/fips/203/final)) algorithms.

**Platforms:** .NET 8.0+, Blazor Server, Blazor WebAssembly

----

===== Quick Start =====

<code bash>
dotnet add package EMSR.Crypto
</code>

<code csharp>
using WvdS.System.Security.Cryptography;

CryptoConfig.DefaultMode = CryptoMode.Hybrid;

// Existing code automatically works with PQ
var cert = request.CreateSelfSigned(notBefore, notAfter);
</code>

----

===== Documentation by Audience =====

^  Section  ^  Audience  ^  Description  ^
| [[.:developer:start|Developer]] | Developer | Integration, migration, code examples |
| [[.:administrator:start|Administrator]] | Sysadmin | Installation, configuration, operations |
| [[.:konzepte:start|Concepts]] | All | Crypto modes, algorithms, security |
| [[.:business:start|Business]] | Management | Compliance, risk, strategy |

----

===== Technical Documentation =====

^  Section  ^  Description  ^
| [[.:api:start|API Reference]] | Complete namespace, class, and member documentation |
| [[.:proxy|PQ-Proxy]] | Post-quantum TLS proxy for existing infrastructure |

----

===== Crypto Modes =====

-> Detailed explanation: [[.:konzepte:start|Understanding Crypto Modes]]

^  Mode  ^  Algorithms  ^  Compatibility  ^
| Classic | RSA/ECDSA | Universal |
| **Hybrid** | RSA + ML-DSA | Forward/backward compatible |
| PostQuantum | ML-DSA/ML-KEM | PQ-capable systems only |

----

===== Prerequisites =====

^  Component  ^  Version  ^
| .NET | 8.0+ |
| OpenSSL | 3.6.0+ |

-> Installation guide: [[.:administrator:installation|Installation]]

----

===== References =====

  * [[https://csrc.nist.gov/pubs/fips/203/final|NIST FIPS 203: ML-KEM]]
  * [[https://csrc.nist.gov/pubs/fips/204/final|NIST FIPS 204: ML-DSA]]
  * [[https://www.openssl.org/|OpenSSL Project]]
  * [[https://learn.microsoft.com/dotnet/api/system.security.cryptography|System.Security.Cryptography (Microsoft)]]

----
//Wolfgang van der Stille @ EMSR DATA d.o.o. - Post-Quantum Cryptography Professional//

{{tag>pq-crypto ml-dsa ml-kem openssl dotnet}}