Configuration de TLS/SSL pour les installations périphériques

Edge pour Private Cloud version 4.17.01

TLS (Transport Layer Security, dont le prédécesseur est SSL) est la technologie de sécurité standard pour assurer une messagerie sécurisée et chiffrée dans votre environnement d'API, des applications à Apigee Périphérie de vos services backend

Quelle que soit la configuration de l'environnement pour votre API de gestion (par exemple, si vous utilisez un proxy, un routeur et/ou un équilibreur de charge devant votre API de gestion (ou non) : Edge vous permet d'activer et de configurer TLS, ce qui vous permet de contrôler le chiffrement des messages dans votre environnement de gestion des API sur site.

Pour une installation sur site du cloud privé Edge, vous pouvez configurer TLS:

  1. Entre un routeur et un processeur de messages
  2. Pour accéder à l'API de gestion Edge
  3. Pour accéder à l'interface de gestion Edge
  4. Pour accéder à vos API depuis une application
  5. Pour accéder à vos services de backend depuis Edge

La configuration du protocole TLS pour les trois premiers éléments est décrite ci-dessous. Toutes ces procédures supposent que vous avez créé un fichier JKS contenant votre certification TLS et votre clé privée.

Pour configurer l'accès TLS à vos API depuis une application (voir n° 4 ci-dessus), consultez la section Configuration de l'accès TLS à une API via le protocole TLS. pour le Private Cloud. Pour configurer TLS pour accéder à vos services de backend depuis Edge, 5 ci-dessus, consultez la section Configuration de TLS d'Edge au backend (cloud et cloud privé).

Pour obtenir une présentation complète de la configuration de TLS on Edge, consultez TLS/SSL.

Créer un fichier JKS

Vous représentez le keystore sous la forme d'un fichier JKS, où il contient votre certificat TLS et clé privée. Il existe plusieurs façons de créer un fichier JKS, mais l'une d'elles consiste à utiliser les fichiers OpenSSL et keytool.

Par exemple, vous disposez d'un fichier PEM nommé server.pem contenant votre certificat TLS. et un fichier PEM nommé private_key.pem contenant votre clé privée. Utilisez les commandes suivantes pour créez 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é, si elle en possède une, et un mot de passe d'exportation. Ce crée un fichier PKCS12 nommé keystore.pkcs12.

Utilisez la commande suivante pour le convertir en un 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. Veillez à utiliser le même mot de passe pour le fichier JKS que celui 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 message Processeur, y compris "-name" à la commande openssl:

>  openssl pkcs12 -export -clcerts -in server.pem -inkey private_key.pem -out keystore.pkcs12 -name devtest

Ajoutez ensuite -alias à 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 Edge TLS nécessitent que vous saisissiez un mot de passe obscurci dans un fichier de configuration. Un mot de passe obscurci offre 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 dans la gestion des périphériques Serveur:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Saisissez le nouveau mot de passe, puis confirmez-le lorsque vous y êtes invité. Pour des raisons de sécurité, le texte le mot de passe ne s'affiche pas. 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 cette pour en savoir plus.