このページでは、Apigee Message Processor でサウスバウンド トラフィック用に TLS 1.3 を構成する方法について説明します。 (Message Processor とバックエンド サーバー間のトラフィック)。
Java での TLS 1.3 機能の詳細については、以下をご覧ください。 JDK 8u261 アップデート リリースノート
TLS 1.3 を有効にする手順は、使用している Java のバージョンによって異なります。詳しくは、 <ph type="x-smartling-placeholder"></ph> インストールされている Java のバージョンを確認するには、以下の Message Processor の Java のバージョンを確認します。 作成されます。
TLS v1.3 と Java のバージョン
TLS 1.3 機能は、Java の次のバージョンで導入されました。
- Oracle JDK 8u261
- OpenJDK 8u272
次の Java バージョンには TLS v1.3 機能がありますが、デフォルトでは有効になっていません。 使用する場合:
- Oracle JDK 8u261 以降、Oracle JDK 8u341 未満
- OpenJDK 8u272 以降かつ OpenJDK 8u352 未満
これらのバージョンのいずれかを使用している場合は、TLS v1.3 を有効にする必要があります。詳しくは デフォルトで有効になっていない場合に TLS v1.3 を有効にする方法をご覧ください。
次のいずれかのバージョンを使用している場合、TLS v1.3 はデフォルトで有効になっています (Message Processor はクライアントとして機能し、 下り(外向き)TLS 接続の場合)、特に何もする必要はありません。
- Oracle JDK 8u341 以降
- OpenJDK 8u352 以降
TLS v1.3 が機能するには、次の条件がすべて満たされる必要があります。
- Message Processor 上の基盤となる Java は、TLS v1.3 をサポートする必要があります。
- Message Processor 上の Java で TLS v1.3 を有効にする必要があります。
- Message Processor アプリケーションで TLS v1.3 を有効にする必要があります。
Java で TLS v1.3 がデフォルトで有効になっていない場合に有効にする方法。
このセクションでは、次のいずれかを使用している場合に TLS v1.3 を有効にする方法について説明します。 次のとおりです。
- Oracle JDK 8u261 以降、Oracle JDK 8u341 未満
- OpenJDK 8u272 以降かつ OpenJDK 8u352 未満
Message Processor で、Java プロパティ jdk.tls.client.protocols
を設定します。
値はカンマで区切られ、1 つ以上の
TLSv1
、TLSv1.1
、TLSv1.2
、TLSv1.3
、
SSLv3
。
たとえば、-Djdk.tls.client.protocols=TLSv1.2,TLSv1.3
を設定すると、クライアントが
プロトコル TLSv1.2
と TLSv1.3
。
その他の変更 JVM プロパティを Edge コンポーネントで JVM プロパティを設定する方法について説明します。
TLS v1、v1.1、v1.2、v1.3 プロトコルを有効にするには:
- 次のように構成します:
Message Processor 構成ファイルを
(
/opt/apigee/customer/application/message-processor.properties
):bin_setenv_ext_jvm_opts=-Djdk.tls.client.protocols=TLSv1,TLSv1.1,TLSv1.2,TLSv1.3
- Message Processor を再起動します。
TLS v1.3 がデフォルトで有効になっている場合に無効にする方法
Oracle JDK 8u341 以降または OpenJDK 8u352 以降を使用している場合、TLSv1.3 は、 デフォルトで使用されます。 このような場合に TLS v1.3 を無効にするには、次の 2 つの方法があります。
- ターゲット サーバーの SSLInfo を構成し、 プロトコル リスト。詳しくは、 <ph type="x-smartling-placeholder"></ph> TLS/SSL TargetEndpoint 構成要素。 注: ターゲット サーバーの構成でプロトコルが指定されていない場合は、 クライアント handshake でオプションとして送信されます。
- プロトコルを完全に無効にして、Message Processor で TLS v1.3 を無効にします。詳しくは、 <ph type="x-smartling-placeholder"></ph> Message Processor で TLS プロトコルを設定する。
Message Processor で Java のバージョンを確認する
Message Processor にインストールされている Java のバージョンを確認するには、Message Processor にログインします 次のコマンドを実行します。
java -version
以下のサンプル出力は、OpenJDK 8u312 がインストールされていることを示しています。
$ java -version openjdk version "1.8.0_312" OpenJDK Runtime Environment (build 1.8.0_312-b07) OpenJDK 64-Bit Server VM (build 25.312-b07, mixed mode)
サポートされている暗号
現在、Java 8 は 2 つの TLS v1.3 暗号をサポートしています。
- TLS_AES_256_GCM_SHA384
- TLS_AES_128_GCM_SHA256
openssl
を使用すると、ターゲット サーバーが TLS v1.3 と、少なくとも 1 つの
使用します。この例では、openssl11
ユーティリティを使用しています。このユーティリティには、
TLS v1.3 が有効になっている。
$ openssl11 s_client -ciphersuites "TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256" -connect target_host:target_port -tls1_3