====== Documentazione Build OpenSSL 3.6 ======

Benvenuti nella documentazione per principianti sulla compilazione di OpenSSL 3.6 dal codice sorgente.

----

===== Cos'è OpenSSL? =====

OpenSSL è una libreria open-source per:
  * **Crittografia** - AES, ChaCha20 e altro
  * **Firme Digitali** - RSA, ECDSA, ML-DSA (Post-Quantum)
  * **Certificati** - X.509, infrastruttura PKI
  * **TLS/SSL** - Comunicazione di rete sicura

<WRAP info>
**La versione 3.6** introduce la crittografia Post-Quantum:
  * **ML-DSA** (ex Dilithium) - NIST FIPS 204
  * **ML-KEM** (ex Kyber) - NIST FIPS 203
</WRAP>

----

===== Avvio Rapido =====

<code powershell>
# 1. Installare i prerequisiti (una tantum)
winget install Microsoft.VisualStudio.2022.Community
winget install StrawberryPerl.StrawberryPerl
winget install NASM.NASM

# 2. Avviare la compilazione
powershell.exe -ExecutionPolicy Bypass -File "build_openssl.ps1"

# 3. Verificare il risultato
openssl version -a
</code>

----

===== Panoramica della Documentazione =====

^ Capitolo ^ Descrizione ^
| [[.:vorbereitung:start|1. Preparazione]] | Cosa serve? Installazione degli strumenti |
| [[.:quellen:start|2. Sorgenti]] | Clonare il repository GitHub |
| [[.:build:start|3. Compilazione]] | Compilare per Windows, Linux, WASM |
| [[.:testen:start|4. Test]] | Verificare l'installazione |
| [[.:integration:start|5. Integrazione]] | Integrare in .NET/Blazor |
| [[.:verteilung:start|6. Distribuzione]] | Condivisione file, NuGet |
| [[.:automatisierung:start|7. CI/CD]] | GitHub Actions, Azure DevOps |

----

===== A chi è destinata questa documentazione? =====

Questa documentazione è rivolta ai **principianti** che:
  * Non hanno mai compilato OpenSSL
  * Necessitano di una versione personalizzata per il loro progetto
  * Vogliono utilizzare la crittografia Post-Quantum
  * Necessitano della conformità FIPS 140-3

<WRAP important>
**Non sono richieste conoscenze pregresse!** Tutti i passaggi sono spiegati in dettaglio.
</WRAP>

----

===== Piattaforme Supportate =====

^ Piattaforma ^ Descrizione ^ Pagina ^
| Windows x64 | DLL native per .NET | [[.:build:windows-x64|Build Windows]] |
| Windows x64 FIPS | Conforme FIPS 140-3 | [[.:build:windows-fips|Build FIPS]] |
| Linux (WSL) | .so native per container | [[.:build:linux-wsl|Build Linux]] |
| WASM | Per Blazor WebAssembly | [[.:build:wasm-blazor|Build WASM]] |

----

===== Continua con =====

  * [[.:vorbereitung:start|1. Preparazione - Iniziamo!]]
  * [[.:troubleshooting|Risoluzione Problemi - Problemi Comuni]]

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