TLS zwischen einem Router und einem Nachrichtenprozessor konfigurieren

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

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

  1. Achten Sie darauf, dass der Router auf Port 8082 des Message Processors zugreifen kann.
  2. Generieren Sie die JKS-Datei des Schlüsselspeichers, die Ihr TLS-Zertifikat und Ihren privaten Schlüssel enthält. Weitere Informationen finden Sie unter TLS/SSL für Edge On-Premises 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 in der Datei message-processor.properties die folgenden Attribute 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 Ihr verschleiertes Schlüsselspeicher- und Schlüsselalias-Passwort.

    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 bereitgestellt wird, wie am Ende des Abschnitts JKS-Datei erstellen beschrieben.

    Informationen zum Generieren eines verschleierten Passworts finden Sie unter TLS/SSL für Edge On-Premises konfigurieren.

  7. Achten Sie darauf, dass 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 Processors 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 Processors 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 dem Router und dem Message Processor aktiviert wurde, enthält die Logdatei des Message Processors die folgende INFO-Meldung:

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

Diese INFO-Anweisung bestätigt, dass TLS zwischen dem Router und dem 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 Hostname überschrieben.
conf/message-processor-communication.
  properties+local.http.port=8998
Optional. Port, der auf Routerverbindungen überwacht werden soll. Der Standardwert ist 8998.
conf_message-processor-communication_local.
  http.ssl=[ false | true ]
Legen Sie dafür true fest, wenn TLS/SSL aktiviert werden soll. 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). Obligatorisch, 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. Obligatorisch, 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 Chiffren zulässig. Wenn keine Angabe erfolgt, werden alle vom JDK unterstützten Chiffren verwendet.