====== X509ChainExtensions ======

**Namespace:** ''WvdS.System.Security.Cryptography.X509Certificates''

Drop-In Replacement Extensions für ''X509Chain'' mit Post-Quantum Signatur-Validierung. Erweitert die Standard-Chain-Validierung um PQ-Signaturprüfung in allen drei Crypto-Modi.

===== Methoden =====

^ Methode ^ Beschreibung ^
| ''Build(certificate, mode)'' | Baut und validiert die Zertifikatskette mit CryptoMode |
| ''Build(certificate, customTrustStore, mode)'' | Chain-Validierung mit Custom Trust Store |
| ''Build(certificate, trustStore, mode)'' | Chain-Validierung mit PqTrustStore |
| ''BuildWithRevocationCheck(...)'' | Chain-Build mit CRL/OCSP Prüfung |
| ''BuildWithOfflineCrl(...)'' | Chain-Build mit offline CRL-Daten |
| ''IsFullyPqProtected()'' | Prüft ob gesamte Kette PQ-geschützt ist |
| ''GetChainCryptoModes()'' | Gibt CryptoModes aller Kettenglieder zurück |
| ''GetValidationReport()'' | Erstellt detaillierten Validierungsbericht |

===== Build mit CryptoMode =====

<code csharp>
using var chain = new X509Chain();
var cert = new X509Certificate2("certificate.pfx");

// Mit explizitem CryptoMode
bool isValid = chain.Build(cert, CryptoMode.Hybrid);

// Mit Default-Mode aus CryptoConfig
bool isValid2 = chain.Build(cert, null);
</code>

==== Validierungsverhalten nach Modus ====

^ Modus ^ Klassische Signatur ^ PQ-Signatur ^
| Classic | Geprüft | Ignoriert |
| Hybrid | Geprüft | Geprüft (falls vorhanden) |
| PostQuantum | Geprüft (Struktur) | **Erforderlich** |

===== IsFullyPqProtected =====

<code csharp>
using var chain = new X509Chain();
chain.Build(cert, CryptoMode.Hybrid);

if (chain.IsFullyPqProtected())
{
    Console.WriteLine("Gesamte Kette ist PQ-geschützt");
}
else
{
    var modes = chain.GetChainCryptoModes();
    for (int i = 0; i < modes.Length; i++)
    {
        if (modes[i] == CryptoMode.Classic)
            Console.WriteLine($"Element {i} hat keinen PQ-Schutz");
    }
}
</code>

===== GetValidationReport =====

<code csharp>
using var chain = new X509Chain();
chain.Build(cert, CryptoMode.Hybrid);

var report = chain.GetValidationReport();
Console.WriteLine($"Gültig: {report.IsValid}");
Console.WriteLine($"Kettenlänge: {report.ChainLength}");
Console.WriteLine($"Vollständig PQ-geschützt: {report.IsFullyPqProtected}");
</code>

===== Siehe auch =====

  * [[.:x509certificate2extensions|X509Certificate2Extensions]]
  * [[.:truststoreextensions|TrustStoreExtensions]]
  * [[.:revocationextensions|RevocationExtensions]]

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