====== 5. Riferimento API ======

Documentazione API completa per WvdS.System.Security.Cryptography.

----

===== Panoramica =====

La libreria **WvdS.System.Security.Cryptography** estende ''System.Security.Cryptography''((Microsoft .NET Cryptography: https://learn.microsoft.com/dotnet/api/system.security.cryptography)) di Microsoft con crittografia post-quantum basata su OpenSSL 3.6((OpenSSL 3.6: https://www.openssl.org/)).

**Framework target:** .NET 8.0+\\
**Piattaforme:** Windows, Linux, macOS, Blazor WebAssembly

----

===== Tipi principali =====

^  Tipo  ^  Descrizione  ^
| [[.:cryptomode|CryptoMode]] | Enum: Classic, Hybrid, PostQuantum |
| [[.:cryptoconfig|CryptoConfig]] | Configurazione globale |

----

===== Namespace =====

^  Namespace  ^  Descrizione  ^
| [[.:providers:start|WvdS.System.Security.Cryptography.Providers]] | Provider crittografici (Native, WASM) |
| [[.:x509certificates:start|WvdS.System.Security.Cryptography.X509Certificates]] | Extension per certificati |
| [[.:signatures|WvdS.System.Security.Cryptography.Signatures]] | Extension per firme |
| [[.:keyexchange|WvdS.System.Security.Cryptography.KeyExchange]] | Scambio chiavi (ML-KEM) |
| [[.:encryption|WvdS.System.Security.Cryptography.Encryption]] | Cifratura |
| [[.:keyderivation|WvdS.System.Security.Cryptography.KeyDerivation]] | Derivazione chiavi |

----

===== Algoritmi =====

==== ML-DSA (Firme) ====

Firme digitali standardizzate NIST FIPS 204((NIST FIPS 204: https://csrc.nist.gov/pubs/fips/204/final)).

^  Variante  ^  OID  ^  Livello di sicurezza  ^
| ML-DSA-44 | 2.16.840.1.101.3.4.3.16 | NIST Level 1 |
| ML-DSA-65 | 2.16.840.1.101.3.4.3.17 | NIST Level 3 |
| ML-DSA-87 | 2.16.840.1.101.3.4.3.18 | NIST Level 5 |

==== ML-KEM (Scambio chiavi) ====

Key Encapsulation standardizzato NIST FIPS 203((NIST FIPS 203: https://csrc.nist.gov/pubs/fips/203/final)).

^  Variante  ^  OID  ^  Livello di sicurezza  ^
| ML-KEM-512 | 2.16.840.1.101.3.4.4.1 | NIST Level 1 |
| ML-KEM-768 | 2.16.840.1.101.3.4.4.2 | NIST Level 3 |
| ML-KEM-1024 | 2.16.840.1.101.3.4.4.3 | NIST Level 5 |

----

===== Avvio rapido =====

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

// Attivare modalita PQ
CryptoConfig.DefaultMode = CryptoMode.Hybrid;

// Il codice esistente funziona automaticamente con PQ
var cert = request.CreateSelfSigned(notBefore, notAfter);
</code>

----

===== Vedi anche =====

  * [[.:de:int:pqcrypt:start|Panoramica PQ-Crypto]]
  * [[https://learn.microsoft.com/dotnet/api/system.security.cryptography|System.Security.Cryptography (Microsoft)]]

{{tag>api referenz namespace}}

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