====== OpenSSL 3.6 Build Documentation ======

Welcome to the beginner documentation for building OpenSSL 3.6 from source.

----

===== What is OpenSSL? =====

OpenSSL is an open-source library for:
  * **Encryption** - AES, ChaCha20 and more
  * **Digital Signatures** - RSA, ECDSA, ML-DSA (Post-Quantum)
  * **Certificates** - X.509, PKI infrastructure
  * **TLS/SSL** - Secure network communication

<WRAP info>
**Version 3.6** brings Post-Quantum Cryptography:
  * **ML-DSA** (formerly Dilithium) - NIST FIPS 204
  * **ML-KEM** (formerly Kyber) - NIST FIPS 203
</WRAP>

----

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

<code powershell>
# 1. Install prerequisites (one-time)
winget install Microsoft.VisualStudio.2022.Community
winget install StrawberryPerl.StrawberryPerl
winget install NASM.NASM

# 2. Start build
powershell.exe -ExecutionPolicy Bypass -File "build_openssl.ps1"

# 3. Verify result
openssl version -a
</code>

----

===== Documentation Overview =====

^ Chapter ^ Description ^
| [[.:vorbereitung:start|1. Preparation]] | What do you need? Install tools |
| [[.:quellen:start|2. Sources]] | Clone GitHub repository |
| [[.:build:start|3. Build]] | Compile for Windows, Linux, WASM |
| [[.:testen:start|4. Testing]] | Verify installation |
| [[.:integration:start|5. Integration]] | Integrate into .NET/Blazor |
| [[.:verteilung:start|6. Distribution]] | File share, NuGet |
| [[.:automatisierung:start|7. CI/CD]] | GitHub Actions, Azure DevOps |

----

===== Who is this documentation for? =====

This documentation is intended for **beginners** (newbies) who:
  * Have never compiled OpenSSL before
  * Need a custom build for their project
  * Want to use Post-Quantum cryptography
  * Need FIPS 140-3 compliance

<WRAP important>
**No prior knowledge required!** All steps are explained in detail.
</WRAP>

----

===== Supported Platforms =====

^ Platform ^ Description ^ Page ^
| Windows x64 | Native DLLs for .NET | [[.:build:windows-x64|Build Windows]] |
| Windows x64 FIPS | FIPS 140-3 compliant | [[.:build:windows-fips|Build FIPS]] |
| Linux (WSL) | Native .so for containers | [[.:build:linux-wsl|Build Linux]] |
| WASM | For Blazor WebAssembly | [[.:build:wasm-blazor|Build WASM]] |

----

===== Continue to =====

  * [[.:vorbereitung:start|1. Preparation - Let's get started!]]
  * [[.:troubleshooting|Troubleshooting - Common Problems]]

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