~~NOTOC~~
====== 12. Import/Export ======

<WRAP round info>
**Scenari:** 4 \\
**Funzioni FFI:** ~30 \\
**Stato:** ⏳ Pianificato
</WRAP>

Questa categoria comprende tutti gli scenari per l'importazione e l'esportazione di certificati e chiavi. PEM, PFX/PKCS#12, PKCS#7 e interoperabilità con altri sistemi.

----

===== Scenari =====

^  ID  ^  Scenario  ^  Descrizione  ^  Complessità  ^  Stato  ^
| [[.:pem_export|12.1]] | Esportazione/Importazione PEM | Certificati codificati Base64 | ⭐⭐ | ⏳ |
| [[.:pfx_export|12.2]] | PFX/PKCS#12 | Bundle Certificato + Chiave privata | ⭐⭐⭐ | ⏳ |
| [[.:pkcs7_chain|12.3]] | Catena PKCS#7 | Esportazione catena di certificati | ⭐⭐ | ⏳ |
| [[.:interop|12.4]] | Interoperabilità | OpenSSL, Windows, Java | ⭐⭐⭐⭐ | ⏳ |

----

===== Formati =====

<mermaid>
flowchart TB
    subgraph CERT["📜 Certificati"]
        PEM_C[".crt.pem<br/>Base64 + Header"]
        DER_C[".crt.der<br/>Binary DER"]
    end

    subgraph KEY["🔑 Chiavi"]
        PEM_K[".key.pem<br/>PKCS#8 Base64"]
        DER_K[".key.der<br/>PKCS#8 Binary"]
        ENC_K[".key.enc.pem<br/>PKCS#8 cifrato"]
    end

    subgraph BUNDLE["📦 Bundle"]
        PFX[".pfx / .p12<br/>Cert + Key"]
        P7B[".p7b<br/>Cert Chain"]
    end

    PEM_C <--> DER_C
    PEM_K <--> DER_K
    PEM_K <--> ENC_K
    PEM_C --> PFX
    PEM_K --> PFX
    PEM_C --> P7B

    style PFX fill:#e8f5e9
    style P7B fill:#e3f2fd
</mermaid>

----

===== Panoramica dei formati =====

^  Formato  ^  Estensione  ^  Contenuto  ^  Cifrato  ^  Utilizzo  ^
| **PEM** | .pem, .crt, .key | Oggetti singoli | Opzionale | Linux, OpenSSL |
| **DER** | .der, .cer | Oggetti singoli | No | Protocolli binari |
| **PFX/PKCS#12** | .pfx, .p12 | Cert + Key + Chain | Sì | Windows, Java |
| **PKCS#7** | .p7b, .p7c | Catena di certificati | No | Distribuzione catena |
| **JKS** | .jks | Java KeyStore | Sì | Applicazioni Java |

----

===== Interoperabilità =====

^  Da/A  ^  OpenSSL  ^  Windows  ^  Java  ^  .NET  ^
| **OpenSSL** | - | PFX | PKCS#7 → JKS | PEM |
| **Windows** | PFX → PEM | - | PFX | PFX |
| **Java** | JKS → PEM | JKS → PFX | - | PFX |
| **.NET** | PEM | PFX | PFX | - |

----

===== Avvio rapido con codice =====

==== Esportazione PEM ====

<code csharp>
// Certificato come PEM
string certPem = certificate.ToPem();
File.WriteAllText("server.crt.pem", certPem);

// Chiave privata cifrata come PEM
string keyPem = privateKey.ToEncryptedPem(
    password: securePassword,
    algorithm: EncryptionAlgorithm.Aes256Gcm
);
File.WriteAllText("server.key.pem", keyPem);
</code>

==== Esportazione PFX/PKCS#12 ====

<code csharp>
// Creazione PFX con certificato, chiave e catena
byte[] pfxData = ctx.ExportToPfx(
    certificate: serverCert,
    privateKey: serverKey,
    chain: new[] { intermediateCert, rootCert },
    password: pfxPassword,
    friendlyName: "Server Certificate"
);

File.WriteAllBytes("server.pfx", pfxData);
</code>

==== Importazione PFX ====

<code csharp>
// Caricamento PFX
var (cert, key, chain) = ctx.ImportFromPfx(
    pfxPath: "server.pfx",
    password: pfxPassword
);

Console.WriteLine($"Certificate: {cert.Subject}");
Console.WriteLine($"Chain length: {chain.Length}");
</code>

==== Esportazione catena PKCS#7 ====

<code csharp>
// Catena di certificati come P7B
byte[] p7bData = ctx.ExportChainToPkcs7(
    certificates: new[] { serverCert, intermediateCert, rootCert }
);

File.WriteAllBytes("chain.p7b", p7bData);
</code>

----

===== Comandi OpenSSL =====

==== PEM → PFX ====

<code bash>
openssl pkcs12 -export \
  -in server.crt.pem \
  -inkey server.key.pem \
  -certfile chain.pem \
  -out server.pfx \
  -name "Server Certificate"
</code>

==== PFX → PEM ====

<code bash>
# Estrazione certificato
openssl pkcs12 -in server.pfx -clcerts -nokeys -out server.crt.pem

# Estrazione chiave privata
openssl pkcs12 -in server.pfx -nocerts -out server.key.pem

# Estrazione catena
openssl pkcs12 -in server.pfx -cacerts -nokeys -out chain.pem
</code>

==== DER → PEM ====

<code bash>
openssl x509 -in cert.der -inform DER -out cert.pem -outform PEM
</code>

----

===== Categorie correlate =====

^  Categoria  ^  Relazione  ^
| [[.:schluessel:start|11. Gestione chiavi]] | Esportazione chiavi |
| [[.:verwaltung:start|4. Gestione certificati]] | Backup/Restore |
| [[.:tls:start|10. TLS/mTLS]] | Distribuzione certificati |

----

<< [[it:int:pqcrypt:szenarien:schluessel:start|← 11. Gestione chiavi]] | [[it:int:pqcrypt:szenarien:start|↑ Scenari]] | [[it:int:pqcrypt:start|🏠 Pagina iniziale →]] >>

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

{{tag>categoria import export pem pfx pkcs12 pkcs7 interop}}