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:
- 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 Eigentümerschaft der JKS-Datei:
chown apigee:apigee /opt/apigee/customer/application/keystore.jks
chmod 600 /opt/apigee/customer/application/keystore.jksDabei ist
keystore.jksder 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 in der Datei
message-processor.propertiesdie 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.jksIhre Schlüsselspeicherdatei und obsPword Ihr verschleiertes Schlüsselspeicher- und Schlüsselalias-Passwort.Hinweis: Der Wert von
muss mit dem Wert übereinstimmen, der von der Optionconf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
-aliasfür den Befehlkeytoolbereitgestellt 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.
- Achten Sie darauf, dass die Datei
message-processor.propertiesdem 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 im Verzeichnis
/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 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. |