Le protocole TLS (Transport Layer Security, dont le prédécesseur est SSL) est la technologie de sécurité standard qui permet d'assurer la sécurité et le chiffrement des messages dans votre environnement d'API, des applications à Apigee Edge en passant par vos services de backend.
Quelle que soit la configuration de l'environnement de votre API de gestion (par exemple, que vous utilisiez ou non un proxy, un routeur et/ou un équilibreur de charge devant votre API de gestion), Edge vous permet d'activer et de configurer TLS, ce qui vous donne le contrôle sur le chiffrement des messages dans votre environnement de gestion des API sur site.
Pour une installation sur site d'Edge Private Cloud, vous pouvez configurer TLS à plusieurs endroits :
- Entre un routeur et un processeur de messages
- Pour accéder à l'API de gestion Edge
- Pour accéder à la nouvelle interface utilisateur Edge
- Pour accéder à vos API depuis une application
- Pour accéder à vos services de backend depuis Edge
Pour obtenir une vue d'ensemble complète de la configuration de TLS sur Edge, consultez TLS/SSL.
Créer un fichier JKS
Pour de nombreuses configurations TLS, vous représentez le keystore sous la forme d'un fichier JKS, où le keystore contient votre certificat TLS et votre clé privée. Il existe plusieurs façons de créer un fichier JKS, mais l'une d'elles consiste à utiliser les utilitaires openssl et keytool.
Par exemple, vous disposez d'un fichier PEM nommé server.pem contenant votre certificat TLS
et d'un fichier PEM nommé private_key.pem contenant votre clé privée. Utilisez les commandes suivantes pour
créer le fichier PKCS12 :
openssl pkcs12 -export -clcerts -in server.pem -inkey private_key.pem -out keystore.pkcs12
Vous devez saisir la phrase secrète de la clé, le cas échéant, et un mot de passe d'exportation. Cette
commande crée un fichier PKCS12 nommé keystore.pkcs12.
Utilisez la commande suivante pour le convertir en fichier JKS nommé keystore.jks :
keytool -importkeystore -srckeystore keystore.pkcs12 -srcstoretype pkcs12 -destkeystore keystore.jks -deststoretype jks
Vous êtes invité à saisir le nouveau mot de passe pour le fichier JKS et le mot de passe existant pour le fichier PKCS12. Assurez-vous d'utiliser le même mot de passe pour le fichier JKS que celui que vous avez utilisé pour le fichier PKCS12.
Si vous devez spécifier un alias de clé, par exemple lors de la configuration de TLS entre un routeur et un processeur de messages, incluez l'option -name dans la commande openssl :
openssl pkcs12 -export -clcerts -in server.pem -inkey private_key.pem -out keystore.pkcs12 -name devtest
Incluez ensuite l'option -alias dans la commande keytool :
keytool -importkeystore -srckeystore keystore.pkcs12 -srcstoretype pkcs12 -destkeystore keystore.jks -deststoretype jks -alias devtest
Générer un mot de passe obscurci
Certaines parties de la procédure de configuration de TLS Edge vous obligent à saisir un mot de passe obscurci dans un fichier de configuration. Un mot de passe obscurci est une alternative plus sécurisée à la saisie de votre mot de passe en texte brut.
Vous pouvez générer un mot de passe obscurci à l'aide de la commande suivante sur le serveur de gestion Edge :
/opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password
Saisissez le nouveau mot de passe, puis confirmez-le à l'invite. Pour des raisons de sécurité, le texte de le mot de passe n'est pas affiché. Cette commande renvoie le mot de passe au format suivant :
OBF:58fh40h61svy156789gk1saj MD5:902fobg9d80e6043b394cb2314e9c6
Utilisez le mot de passe obscurci spécifié par OBF lors de la configuration de TLS.
Pour en savoir plus, consultez cet article.