====== TrustStoreExtensions & PqTrustStore ======

Custom trust store management for PQ-compatible PKI infrastructures.

----

===== Overview =====

^  Class  ^  Description  ^
| ''PqTrustStore'' | Full-featured trust store with PQ support |
| ''TrustStoreExtensions'' | Extension methods for ''X509Certificate2Collection'' |
| ''TrustEntry'' | Metadata for trust store entries |

----

===== PqTrustStore Class =====

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

// Create trust store
using var trustStore = new PqTrustStore();

// Add Root CA
var rootCa = new X509Certificate2("root-ca.cer");
trustStore.AddTrustAnchor(rootCa, alias: "Company Root CA");

// Add Intermediate CA
var intermediateCa = new X509Certificate2("intermediate-ca.cer");
trustStore.AddIntermediate(intermediateCa, alias: "Issuing CA");
</code>

----

===== Integration with X509Chain =====

<code csharp>
// Load trust store
using var trustStore = PqTrustStore.LoadFromPem("company-trust-store.pem");

// Validate certificate
var userCert = new X509Certificate2("user.cer");

using var chain = new X509Chain();
bool isValid = chain.Build(userCert, trustStore, CryptoMode.Hybrid);
</code>

----

===== Trust Store Import/Export =====

<code csharp>
// Save/load PEM bundle
trustStore.SaveToPem("trust-store.pem");
var loadedStore = PqTrustStore.LoadFromPem("trust-store.pem");

// PKCS#7 (DER)
trustStore.SaveToPkcs7("trust-store.p7b");
var p7Store = PqTrustStore.LoadFromPkcs7("trust-store.p7b");
</code>

----

===== System Store Import =====

<code csharp>
using var trustStore = new PqTrustStore();

// Import Windows Root CAs
trustStore.ImportFromSystemRootStore();

// Export as PEM for air-gapped systems
trustStore.SaveToPem("system-trust-store.pem");
</code>

----

===== TrustType Enum =====

^  Value  ^  Description  ^
| ''TrustAnchor'' | Trust anchor (Root CA) |
| ''IntermediateCA'' | Intermediate certification authority |
| ''CrossCertifiedCA'' | Cross-certified CA |
| ''EndEntity'' | End entity (non-CA) |

----

===== Trust Store Queries =====

<code csharp>
// Only trust anchors
var roots = trustStore.TrustAnchors;

// Only Intermediate CAs
var intermediates = trustStore.IntermediateCAs;

// Search by Subject/Thumbprint
var found = trustStore.FindBySubjectName("Company");
var entry = trustStore.FindByThumbprint("A1B2C3...");
</code>

----

===== See Also =====

  * [[.:x509chainextensions|X509ChainExtensions]]
  * [[.:revocationextensions|RevocationExtensions]]

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

{{tag>truststore pki ca chain}}