TLS zwischen einem Router und einem Nachrichtenprozessor konfigurieren

Standardmäßig ist TLS zwischen Router und Message Processor deaktiviert.

So aktivieren Sie die TLS-Verschlüsselung zwischen einem Router und einem Message Processor :

  1. Prüfen Sie, ob der Router auf Port 8082 auf dem Message Processor zugreifen kann.
  2. Generieren Sie die JKS-Datei des Schlüsselspeichers mit Ihrem TLS-Zertifikat und dem privaten Schlüssel. Weitere Informationen finden Sie unter TLS/SSL für Edge für Private Cloud konfigurieren.
  3. Kopieren Sie die JKS-Datei des Schlüsselspeichers in ein Verzeichnis auf dem Message Processor-Server, z. B. /opt/apigee/customer/application.
  4. Ändern Sie die Berechtigungen und die Eigentümerschaft der JKS-Datei:
    chown apigee:apigee /opt/apigee/customer/application/keystore.jks
    chmod 600 /opt/apigee/customer/application/keystore.jks

    Dabei ist keystore.jks der Name Ihrer Schlüsselspeicherdatei.

  5. Bearbeiten Sie die Datei /opt/apigee/customer/application/message-processor.properties. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
  6. Legen Sie die folgenden Attribute in der Datei message-processor.properties fest:
    conf_message-processor-communication_local.http.ssl=true
    conf/message-processor-communication.properties+local.http.port=8443
    conf/message-processor-communication.properties+local.http.ssl.keystore.type=jks
    conf/message-processor-communication.properties+local.http.ssl.keystore.path=/opt/apigee/customer/application/keystore.jks
    conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
    # Enter the obfuscated keystore password below.
    conf/message-processor-communication.properties+local.http.ssl.keystore.password=OBF:obsPword

    Dabei ist keystore.jks Ihre Schlüsselspeicherdatei und obsPword ist Ihr verschleiertes Passwort für den Schlüsselspeicher und den Schlüsselalias.

    Hinweis: Der Wert von

    conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
    muss mit dem Wert übereinstimmen, der von der Option -alias für den Befehl keytool angegeben wird. Dieser wird am Ende des Abschnitts JKS-Datei erstellen beschrieben.

    Informationen zum Generieren eines verschleierten Passworts finden Sie unter TLS/SSL für Edge für Private Cloud konfigurieren für Informationen.

  7. Prüfen Sie, ob die Datei message-processor.properties dem Nutzer „apigee“ gehört:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  8. Beenden Sie die Message Processor und Router:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  9. Löschen Sie auf dem Router alle Dateien im Verzeichnis /opt/nginx/conf.d:
    rm -f /opt/nginx/conf.d/*
  10. Starten Sie die Message Processor und Router:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /opt/apigee/apigee-service/bin/apigee-service edge-router start
  11. Wiederholen Sie diesen Vorgang für jeden Message Processor.

Nachdem TLS zwischen Router und Message Processor aktiviert wurde, enthält die Message Processor-Protokolldatei die folgende INFO Meldung:

MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks

Diese INFO Anweisung bestätigt, dass TLS zwischen Router und Message Processor funktioniert.

In der folgenden Tabelle sind alle verfügbaren Attribute in message-processor.properties aufgeführt:

Attribute Beschreibung
conf_message-processor-communication_local.
  http.host=localhost_or_IP_address
Optional. Hostname, auf dem auf Routerverbindungen gewartet werden soll. Dadurch wird der bei der Registrierung konfigurierte Host name überschrieben.
conf/message-processor-communication.
  properties+local.http.port=8998
Optional. Port, auf dem auf Routerverbindungen gewartet werden soll. Der Standardwert ist 8998.
conf_message-processor-communication_local.
  http.ssl=[ false | true ]
Setzen Sie diesen Wert auf true, um TLS/SSL zu aktivieren. Der Standardwert ist false. Wenn TLS/SSL aktiviert ist, müssen Sie local.http.ssl.keystore.path und local.http.ssl.keyalias festlegen.
conf/message-processor-communication.
  properties+local.http.ssl.keystore.path=
Lokaler Dateisystempfad zum Schlüsselspeicher (JKS oder PKCS12). Erforderlich, wenn local.http.ssl=true.
conf/message-processor-communication.
  properties+local.http.ssl.keyalias=
Schlüsselalias aus dem Schlüsselspeicher, der für TLS/SSL-Verbindungen verwendet werden soll. Erforderlich, wenn local.http.ssl=true.
conf/message-processor-communication.
  properties+local.http.ssl.keyalias.password=
Passwort, das zum Verschlüsseln des Schlüssels im Schlüsselspeicher verwendet wird. Verwenden Sie ein verschleiertes Passwort im folgenden Format:
OBF:obsPword
conf/message-processor-communication.
  properties+local.http.ssl.keystore.type=jks
Schlüsselspeichertyp. Derzeit werden nur JKS und PKCS12 unterstützt. Der Standardwert ist JKS.
conf/message-processor-communication.
  properties+local.http.ssl.keystore.password=
Optional. Verschleiertes Passwort für den Schlüsselspeicher. Verwenden Sie ein verschleiertes Passwort im folgenden Format:
OBF:obsPword
conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2
Optional. Wenn konfiguriert, sind nur die aufgeführten Ciphers zulässig. Wenn nicht angegeben, werden alle vom JDK unterstützten Ciphers verwendet.