このページは Cloud Translation API によって翻訳されました。

サウスバウンドトラフィック用の TLS 1.3 の構成

このページでは、Apigee Message Processor でサウスバウンドトラフィック（Message Processor とバックエンドサーバー間のトラフィック）に TLS 1.3 を構成する方法について説明します。

Java の TLS 1.3 機能の詳細については、JDK 8u261 アップデートリリースノートをご覧ください。

TLS 1.3 を有効にする手順は、使用している Java のバージョンによって異なります。Message Processor にインストールされている Java のバージョンを確認するには、以下の Message Processor 内の Java のバージョンを確認するをご覧ください。

TLS v1.3 と Java のバージョン

TLS 1.3 機能は、次のバージョンの Java で導入されました。

次の Java バージョンでは、TLS v1.3 機能は存在しますが、クライアントロールではデフォルトで有効になっていません。

これらのバージョンのいずれかを使用している場合は、TLS v1.3 がデフォルトで有効になっていない場合に有効にする方法で説明されているように、TLS v1.3 を有効にする必要があります。

次のいずれかのバージョンを使用している場合は、クライアントロールで TLS v1.3 がデフォルトで有効になっているはずです（Message Processor はサウスバウンド TLS 接続のクライアントとして機能します）。そのため、何もする必要はありません。

TLS v1.3 が機能するためには、次のすべてが成り立っている必要があります。

このセクションでは、次のいずれかのバージョンの Java を使用している場合に TLS v1.3 を有効にする方法について説明します。

Message Processor で、Java プロパティ jdk.tls.client.protocols を設定します。値はカンマ区切りで、TLSv1、TLSv1.1、TLSv1.2、TLSv1.3、SSLv3 のうち 1 つ以上を含めることができます。

たとえば、-Djdk.tls.client.protocols=TLSv1.2,TLSv1.3 を設定すると、クライアントプロトコル TLSv1.2 と TLSv1.3 が有効になります。

Edge コンポーネントで JVM プロパティを設定する方法については、他の 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 を再起動します。

Oracle JDK 8u341 以降または OpenJDK 8u352 以降を使用している場合は、クライアントに対して TLSv1.3 がデフォルトで有効になっています。このような場合に TLS v1.3 を無効にするには、次の 2 つの方法があります。

ターゲットサーバーの SSLInfo を構成し、プロトコルのリストに TLSv1.3 が含まれていないことを確認します。 TLS/SSL TargetEndpoint 構成要素をご覧ください。注: ターゲットサーバー構成でプロトコルが指定されていない場合、Java でサポートされているプロトコルはすべて、Client handshake でオプションとして送信されます。
プロトコルを完全に無効にして、Message Processor で TLS v1.3 を無効にします。 Message Processor の TLS プロトコルを設定するをご覧ください。

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 暗号をサポートしています。

openssl を使用して、ターゲットサーバーが TLS v1.3 と、以下の暗号の少なくとも 1 つをサポートしているかどうかを確認できます。この例では、TLS v1.3 が有効になっている openssl11 ユーティリティを使用しています。

$ openssl11 s_client -ciphersuites "TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256" -connect target_host:target_port -tls1_3