Conversione dei certificati nel formato supportato

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Questo documento spiega come convertire il certificato TLS e la chiave privata associata nei formati PEM o PFX (PKCS #12).

Apigee Edge supporta l'archiviazione solo di certificati in formato PEM o PFX in archivi chiavi e truststore. I passaggi utilizzati per convertire i certificati da qualsiasi formato esistente in formato PEM o PFX si basano sul toolkit OpenSSL e sono applicabili a qualsiasi ambiente in cui è disponibile OpenSSL.

Prima di iniziare

Prima di seguire la procedura descritta in questo documento, assicurati di comprendere i seguenti argomenti:

  • Se non hai dimestichezza con il formato PEM o PFX, leggi l'articolo Informazioni su TLS/SSL.
  • Se non hai familiarità con i formati dei certificati, leggi Formati dei certificati SSL.
  • Se non hai dimestichezza con la libreria OpenSSL, leggi OpenSSL.
  • Se vuoi utilizzare gli esempi di riga di comando di questa guida, installa o aggiorna il client OpenSSL all'ultima versione.

Conversione del certificato dal formato DER al formato PEM

Questa sezione descrive come convertire un certificato e la chiave privata associata dal formato DER al formato PEM.

  1. Trasferisci il file contenente la catena di certificati completa (certificate.der) e la chiave privata associata (private_key.der) che vuoi convertire in formato PEM su una macchina su cui è installato OpenSSL utilizzando scp, sftp o qualsiasi altra utilità.

    Ad esempio, utilizza il comando scp per trasferire il file nella directory /tmp sul server contenente OpenSSL nel seguente modo: 

    scp certificate.der servername:/tmp
scp private_key.der servername:/tmp

    Dove servername è il nome del server contenente OpenSSL.

  2. Accedi alla macchina su cui è installato OpenSSL.
  3. Dalla directory in cui si trovano i certificati, esegui questo comando per convertire il certificato e la chiave privata associata dal formato DER al formato PEM: 
    openssl x509 -inform DER -in certificate.der -outform PEM -out certificate.pem
openssl rsa -inform DER -in private_key.der -outform PEM -out private.key
  4. Verifica che il certificato sia convertito in formato PEM.

Conversione del certificato dal formato P7B a formato PEM

Questa sezione descrive come convertire i certificati dal formato P7B a quello PEM.

  1. Trasferisci il file contenente la catena di certificati completa (certificate.p7b) che vuoi convertire in formato PEM in una macchina su cui è installato OpenSSL utilizzando scp, sftp o qualsiasi altra utilità.

    Ad esempio, utilizza il comando scp per trasferire il file nella directory /tmp sul server contenente OpenSSL nel seguente modo: 

    scp certificate.p7b servername:/tmp

    Dove servername è il nome del server contenente OpenSSL.

  2. Accedi alla macchina su cui è installato OpenSSL.
  3. Dalla directory in cui si trovano i certificati, esegui questo comando per convertire il certificato dal formato P7B a quello PEM: 
    openssl pkcs7 -print_certs -in certificate.p7b -out certificate.pem
  4. Verifica che il certificato sia convertito in formato PEM.

Conversione del certificato dal formato PFX in formato PEM

Questa sezione descrive come convertire i certificati TLS dal formato PFX al formato PEM.

Quando converti un file PFX in formato PEM, OpenSSL inserisce tutti i certificati e la chiave privata in un unico file. Dovrai aprire il file in un editor di testo e copiare ogni certificato e ogni chiave privata (incluse le istruzioni BEGIN/END) in singoli file di testo e salvarli rispettivamente come certificate.pfx, Intermediate.pfx (se applicabile), CACert.pfx e privateKey.key.

Apigee supporta il formato PFX/PKCS #12, tuttavia, il formato PEM è pratico per molti motivi, tra cui la convalida.

  1. Trasferisci i certificati e la chiave privata (certificate.pfx, Intermediate.pfx CACert.pfx, privateKey.key) che vuoi convertire in formato PEM a una macchina su cui è installato OpenSSL utilizzando scp, sftp o qualsiasi altra utilità.

    Ad esempio, utilizza il comando scp per trasferire il file nella directory /tmp sul server contenente OpenSSL nel seguente modo: 

    scp certificate.pfx servername:/tmp

    Dove servername è il nome del server contenente OpenSSL.

  2. Accedi alla macchina su cui è installato OpenSSL.
  3. Dalla directory in cui si trovano i certificati, esegui questo comando per convertire il certificato dal formato P7B a quello PEM: 
    openssl pkcs12 -in certificate.pfx -out certificate.pem -nodes
  4. Verifica che il certificato sia convertito in formato PEM.

Conversione del certificato dal formato P7B a formato PFX

Questa sezione descrive come convertire i certificati TLS dal formato P7B al formato PFX.

Per convertirlo nel formato PFX, devi ottenere anche la chiave privata.

  1. Trasferisci il certificato (certificate.p7b) che vuoi convertire in PFX su una macchina in cui è installato OpenSSL utilizzando scp, sftp o qualsiasi altra utilità.

    Ad esempio, utilizza il comando scp per trasferire il file nella directory /tmp sul server contenente OpenSSL nel seguente modo: 

    scp certificate.p7b servername:/tmp
scp private_key.key servername:/tmp

    Dove servername è il nome del server contenente OpenSSL.

  2. Accedi alla macchina su cui è installato OpenSSL.
  3. Dalla directory in cui si trovano i certificati, esegui i comandi seguenti per convertire il certificato dal formato P7B a PFX ed esportare i certificati dell'entità e della CA intermedia in file separati: 
    openssl pkcs7 -print_certs -in certificate.p7b -out certificate.cer

openssl pkcs12 -export -in certificate.cer -inkey private_key.key -out certificate.pfx -certfile CACert.cer

Verifica del certificato in formato PEM

Questa sezione descrive come verificare che il certificato sia in formato PEM.

  1. Per visualizzare il certificato in formato PEM, esegui questo comando: 
    openssl x509 -in certificate.pem -text -noout
  2. Se riesci a visualizzare i contenuti del certificato in un formato leggibile senza errori, puoi confermare che il certificato è in formato PEM.
  3. Se il certificato è in un altro formato, verranno visualizzati errori come il seguente: 
    unable to load certificate
12626:error:0906D06C:PEM routines:PEM_read_bio:no start line:pem_lib.c:647:Expecting: TRUSTED CERTIFICATE View DER encoded Certificate