Edge for Private Cloud v. 4.17.05
Standardmäßig ist TLS zwischen dem Router und dem Message Processor deaktiviert.
Gehen Sie folgendermaßen vor, um die TLS-Verschlüsselung zwischen einem Router und dem Message Processor zu aktivieren:
- Achten Sie darauf, dass der Router auf Port 8082 des Message Processors zugreifen kann.
- 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.
- Kopieren Sie die JKS-Datei des Schlüsselspeichers in ein Verzeichnis auf dem Message Processor-Server, z. B. /opt/apigee/customer/application.
- Ändern Sie die Berechtigungen und die Inhaberschaft 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. - Bearbeiten Sie die Datei /opt/apigee/customer/application/message-processor.properties. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
- 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
# Geben Sie unten das verschleierte Keystore-Passwort ein.
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. Informationen zum Generieren eines verschleierten Passworts finden Sie unter TLS/SSL für Edge On-Premises konfigurieren. - Achten Sie darauf, dass die Datei message-processor.properties dem Nutzer „apigee“ gehört:
> chown apigee:apigee /opt/apigee/customer/application/message-processor.properties - 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 - Löschen Sie auf dem Router alle Dateien in /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - 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 - Wiederholen Sie den Vorgang für alle weiteren Message Processors.
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:
|
Properties |
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 hier „true“ fest, 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:xxxxxxxxxx |
|
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 in diesem Format: OBF:xxxxxxxxxx |
|
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. |