====== Dokumentacija za gradnjo OpenSSL 3.6 ======

Dobrodošli v dokumentaciji za začetnike o gradnji OpenSSL 3.6 iz izvorne kode.

----

===== Kaj je OpenSSL? =====

OpenSSL je odprtokodna knjižnica za:
  * **Šifriranje** - AES, ChaCha20 in več
  * **Digitalne podpise** - RSA, ECDSA, ML-DSA (Post-Quantum)
  * **Certifikate** - X.509, PKI-infrastruktura
  * **TLS/SSL** - Varna omrežna komunikacija

<WRAP info>
**Verzija 3.6** prinaša post-kvantno kriptografijo:
  * **ML-DSA** (prej Dilithium) - NIST FIPS 204
  * **ML-KEM** (prej Kyber) - NIST FIPS 203
</WRAP>

----

===== Hitri začetek =====

<code powershell>
# 1. Namestitev predpogojev (enkrat)
winget install Microsoft.VisualStudio.2022.Community
winget install StrawberryPerl.StrawberryPerl
winget install NASM.NASM

# 2. Zagon gradnje
powershell.exe -ExecutionPolicy Bypass -File "build_openssl.ps1"

# 3. Preverjanje rezultata
openssl version -a
</code>

----

===== Pregled dokumentacije =====

^ Poglavje ^ Opis ^
| [[.:vorbereitung:start|1. Priprava]] | Kaj potrebujete? Namestitev orodij |
| [[.:quellen:start|2. Viri]] | Kloniranje GitHub repozitorija |
| [[.:build:start|3. Gradnja]] | Prevajanje za Windows, Linux, WASM |
| [[.:testen:start|4. Testiranje]] | Preverjanje namestitve |
| [[.:integration:start|5. Integracija]] | Vključitev v .NET/Blazor |
| [[.:verteilung:start|6. Distribucija]] | Skupna raba datotek, NuGet |
| [[.:automatisierung:start|7. CI/CD]] | GitHub Actions, Azure DevOps |

----

===== Za koga je ta dokumentacija? =====

Ta dokumentacija je namenjena **začetnikom** (newbies), ki:
  * Še nikoli niso prevajali OpenSSL
  * Potrebujejo lastno gradnjo za svoj projekt
  * Želijo uporabiti post-kvantno kriptografijo
  * Potrebujejo skladnost s FIPS 140-3

<WRAP important>
**Predznanje ni potrebno!** Vsi koraki so podrobno razloženi.
</WRAP>

----

===== Podprte platforme =====

^ Platforma ^ Opis ^ Stran ^
| Windows x64 | Izvorne DLL knjižnice za .NET | [[.:build:windows-x64|Gradnja Windows]] |
| Windows x64 FIPS | Skladno s FIPS 140-3 | [[.:build:windows-fips|Gradnja FIPS]] |
| Linux (WSL) | Izvorne .so za vsebnike | [[.:build:linux-wsl|Gradnja Linux]] |
| WASM | Za Blazor WebAssembly | [[.:build:wasm-blazor|Gradnja WASM]] |

----

===== Naprej na =====

  * [[.:vorbereitung:start|1. Priprava - Začnimo!]]
  * [[.:troubleshooting|Odpravljanje težav - Pogoste težave]]

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