Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Convertir des certificats dans un format compatible

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**. info

Ce document explique comment convertir le certificat TLS et la clé privée associée aux formats PEM ou PFX (PKCS #12).

Apigee Edge n'accepte que les certificats au format PEM ou PFX dans les magasins de clés et les magasins de confiance. Les étapes utilisées pour convertir des certificats d'un format existant vers les formats PEM ou PFX reposent sur la OpenSSL et s'appliquent à tout environnement dans lequel OpenSSL est disponible.

Avant de commencer

Avant de suivre les étapes décrites dans ce document, assurez-vous de bien comprendre les sujets suivants :

Si vous n'êtes pas familiarisé avec le format PEM ou PFX, consultez À propos de TLS/SSL.
Si vous n'êtes pas familiarisé avec les formats de certificat, consultez Formats de certificat SSL.
Si vous n'êtes pas familiarisé avec la bibliothèque OpenSSL, consultez OpenSSL.
Si vous souhaitez utiliser les exemples de ligne de commande de ce guide, installez ou mettez à jour la dernière version du client OpenSSL.

Convertir un certificat du format DER au format PEM

Cette section explique comment convertir un certificat et la clé privée associée du format DER au format PEM.

Transférez le fichier contenant la chaîne de certificats complète (certificate.der) et la clé privée associée (private_key.der) que vous souhaitez convertir au format PEM sur une machine sur laquelle OpenSSL est installé à l'aide de scp, sftp ou tout autre utilitaire.
Par exemple, utilisez la commande scp pour transférer le fichier vers le répertoire /tmp sur le serveur contenant OpenSSL comme suit :
```
scp certificate.der servername:/tmp
scp private_key.der servername:/tmp
```
Où servername est le nom du serveur contenant OpenSSL.
Connectez-vous à la machine sur laquelle OpenSSL est installé.
À partir du répertoire dans lequel se trouvent les certificats, exécutez la commande suivante pour convertir le certificat et la clé privée associée du format DER au format 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
```
Vérifiez que le certificat est converti au format PEM.

Convertir un certificat du format P7B au format PEM

Cette section explique comment convertir des certificats du format P7B au format PEM.

Transférez le fichier contenant la chaîne de certificats complète (certificate.p7b) que vous souhaitez convertir au format PEM sur une machine sur laquelle OpenSSL est installé à l'aide de scp, sftp ou tout autre utilitaire.
Par exemple, utilisez la commande scp pour transférer le fichier vers le répertoire /tmp sur le serveur contenant OpenSSL comme suit :
```
scp certificate.p7b servername:/tmp
```
Où servername est le nom du serveur contenant OpenSSL.
Connectez-vous à la machine sur laquelle OpenSSL est installé.
À partir du répertoire dans lequel se trouvent les certificats, exécutez la commande suivante pour convertir le certificat du format P7B au format PEM :
```
openssl pkcs7 -print_certs -in certificate.p7b -out certificate.pem
```
Vérifiez que le certificat est converti au format PEM.

Convertir un certificat du format PFX au format PEM

Cette section explique comment convertir des certificats TLS du format PFX au format PEM.

Lors de la conversion d'un fichier PFX au format PEM, OpenSSL place tous les certificats et la clé privée dans un seul fichier. Vous devrez ouvrir le fichier dans un éditeur de texte et copier chaque certificat et clé privée (y compris les instructions BEGIN/END) dans des fichiers texte individuels, puis les enregistrer respectivement sous les noms certificate.pfx, Intermediate.pfx (le cas échéant), CACert.pfx et privateKey.key.

Apigee est compatible avec le format PFX/PKCS #12. Toutefois, le format PEM est pratique pour de nombreuses raisons, y compris la validation.

Transférez les certificats et la clé privée (certificate.pfx, Intermediate.pfx CACert.pfx, privateKey.key) que vous souhaitez convertir au format PEM sur une machine sur laquelle OpenSSL est installé à l'aide de scp, sftp ou tout autre utilitaire.
Par exemple, utilisez la commande scp pour transférer le fichier vers le répertoire /tmp sur le serveur contenant OpenSSL comme suit :
```
scp certificate.pfx servername:/tmp
```
Où servername est le nom du serveur contenant OpenSSL.
Connectez-vous à la machine sur laquelle OpenSSL est installé.
À partir du répertoire dans lequel se trouvent les certificats, exécutez la commande suivante pour convertir le certificat du format P7B au format PEM :
```
openssl pkcs12 -in certificate.pfx -out certificate.pem -nodes
```
Vérifiez que le certificat est converti au format PEM.

Convertir un certificat du format P7B au format PFX

Cette section explique comment convertir des certificats TLS du format P7B au format PFX.

Pour effectuer la conversion au format PFX, vous devez également obtenir la clé privée.

Transférez le certificat (certificate.p7b) que vous souhaitez convertir au format PFX sur une machine sur laquelle OpenSSL est installé à l'aide de scp, sftp ou tout autre utilitaire.
Par exemple, utilisez la commande scp pour transférer le fichier vers le répertoire /tmp sur le serveur contenant OpenSSL comme suit :
```
scp certificate.p7b servername:/tmp
scp private_key.key servername:/tmp
```
Où servername est le nom du serveur contenant OpenSSL.
Connectez-vous à la machine sur laquelle OpenSSL est installé.
À partir du répertoire dans lequel se trouvent les certificats, exécutez les commandes suivantes pour convertir le certificat du format P7B au format PFX et exporter les certificats d'entité et d'autorité de certification intermédiaire dans des fichiers distincts :
```
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
```

Vérifier que le certificat est au format PEM

Cette section explique comment vérifier que le certificat est au format PEM.

Pour afficher le certificat au format PEM, exécutez la commande suivante :
```
openssl x509 -in certificate.pem -text -noout
```
Si vous parvenez à afficher le contenu du certificat dans un format lisible par l'humain sans aucune erreur, vous pouvez confirmer que le certificat est au format PEM.

Si le certificat est dans un autre format, des erreurs semblables à celles-ci s'affichent :

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

Empaqueter des fichiers de clé et de certificat PEM au format PKCS12/PFX

Assurez-vous que le fichier de clé privée est au format PEM. Pour le certificat, si vous disposez de fichiers PEM distincts pour votre chaîne, ouvrez chaque fichier dans un éditeur de texte et concaténez-les dans un seul fichier, comme indiqué ci-dessous :
```
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
```
Transférez les fichiers vers une machine sur laquelle OpenSSL est installé à l'aide de scp, sftp ou tout autre utilitaire :
```
scp certificate.pem servername:/tmp
scp private.key servername:/tmp
```
Connectez-vous à la machine sur laquelle OpenSSL est installé.
À partir du répertoire dans lequel se trouvent les fichiers, exécutez la commande suivante pour empaqueter les fichiers dans un fichier PKCS12 avec l'alias myalias. Lorsque vous y êtes invité, saisissez un mot de passe approprié :
```
openssl pkcs12 -export -in certificate.pem -inkey private.key -out keystore.pfx -name myalias
```