Konfigurowanie protokołu TLS między routerem a podmiotem przetwarzającym wiadomości

Edge dla chmury prywatnej w wersji 4.16.09

Domyślnie protokół TLS między routerem a procesorem komunikatów jest wyłączony.

Aby włączyć szyfrowanie TLS między routerem a procesorem komunikatów, wykonaj te czynności:

  1. Upewnij się, że port 8082 procesora komunikatów jest dostępny dla routera.
  2. Wygeneruj plik JKS magazynu kluczy zawierający certyfikat TLS i klucz prywatny. Więcej informacji znajdziesz w artykule Konfigurowanie TLS/SSL dla Edge On-Premises.
  3. Skopiuj plik JKS magazynu kluczy do katalogu na serwerze procesora komunikatów, np. /opt/apigee/customer/application.
  4. Zmień uprawnienia i własność pliku JKS:
    > chown apigee:apigee /opt/apigee/customer/application/keystore.jks
    > chmod 600 /opt/apigee/customer/application/keystore.jks


    gdzie keystore.jks to nazwa pliku magazynu kluczy.
  5. Otwórz do edycji plik /opt/apigee/customer/application/message-processor.properties. Jeśli plik nie istnieje, utwórz go.
  6. W pliku message-processor.properties ustaw te właściwości:
    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


    gdzie keyStore.jks to plik magazynu kluczy, a obsPword to zaciemnione hasło magazynu kluczy i aliasu klucza. Informacje o generowaniu zaciemnionego hasła znajdziesz w artykule Konfigurowanie TLS/SSL dla Edge On-Premises.
  7. Upewnij się, że plik message-processor.properties należy do użytkownika „apigee”:
    > chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  8. Zatrzymaj procesory komunikatów i routery:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  9. Na routerze usuń wszystkie pliki w katalogu /opt/nginx/conf.d:
    > rm -f /opt/nginx/conf.d/*
  10. Uruchom procesory komunikatów i routery:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /opt/apigee/apigee-service/bin/apigee-service edge-router start
  11. Powtórz te czynności w przypadku dodatkowych procesorów komunikatów.

W tabeli poniżej znajdziesz wszystkie dostępne właściwości w pliku message-processor.properties:

Usługi

Opis

conf_message-processor-communication_local.http.host=<localhost lub adres IP>

Opcjonalnie: Nazwa hosta, na którym ma być nasłuchiwane połączenie z routerem. Spowoduje to zastąpienie nazwy hosta skonfigurowanej podczas rejestracji.

conf/message-processor-communication.properties+local.http.port=8998

Opcjonalnie: Port, na którym router ma nasłuchiwać połączeń. Wartość domyślna to 8998.

conf_message-processor-communication_local.http.ssl=<false | true>

Ustaw wartość „true”, aby włączyć TLS/SSL. Wartość domyślna to false (fałsz). Gdy protokół TLS/SSL jest włączony, musisz ustawić local.http.ssl.keystore.path i local.http.ssl.keyalias.

conf/message-processor-communication.properties+local.http.ssl.keystore.path=

Ścieżka lokalnego systemu plików do magazynu kluczy (JKS lub PKCS12). Wymagane, gdy local.http.ssl=true.

conf/message-processor-communication.properties+local.http.ssl.keyalias=

Alias klucza z magazynu kluczy, który ma być używany w połączeniach TLS/SSL. Wymagane, gdy local.http.ssl=true.

conf/message-processor-communication.properties+local.http.ssl.keyalias.password=

Hasło używane do szyfrowania klucza w magazynie kluczy. Użyj zaciemnionego hasła w tym formacie: OBF:xxxxxxxxxx

conf/message-processor-communication.properties+local.http.ssl.keystore.type=jks

Typ magazynu kluczy. Obecnie obsługiwane są tylko formaty JKS i PKCS12. Wartość domyślna to JKS.

conf/message-processor-communication.properties+local.http.ssl.keystore.password=

Opcjonalnie: Zamaskowane hasło do magazynu kluczy. Użyj zaciemnionego hasła w tym formacie: OBF:xxxxxxxxxx

conf_message-processor-communication_local.http.ssl.ciphers=<cipher1,cipher2>

Opcjonalnie: Po skonfigurowaniu dozwolone są tylko wymienione mechanizmy szyfrowania. Jeśli zostanie pominięty, używane są wszystkie mechanizmy szyfrowania obsługiwane przez JDK.