サンプルプログラム

wolfSSL JNI サンプルプログラム

"examples"ディレクトリには、wolfSSL シン JNI ラッパーのサンプルプログラムが含まれています。 wolfSSL JSSE プロバイダーのサンプルプログラムは./examples/provider ディレクトリにあります。

サンプルプログラムは、パッケージのルートディレクトリから、提供されたラッパースクリプトを使用して実行する必要があります。ラッパースクリプトは、wolfssljni パッケージに含まれる wolfjni jar で使用するための正しい環境変数を設定します。

デバッグとログに間する注意事項

実行時に -Dwolfjsse.debug=true` を使用することで、wolfJSSE デバッグログ出力を有効にできます。

ネイティブ wolfSSL が "--enable-debug" でコンパイルされている場合、実行時に "-Dwolfssl.debug=true" を使用して wolfSSL ネイティブデバッグログ出力を有効にできます。

-Djavax.net.debug=all オプションを使用して、JDK デバッグログ出力を有効にできます。

wolfSSL JNI サンプルクライアントとサンプルサーバー

wolfSSL JNI を使用するクライアント/サーバーアプリケーションのサンプルプログラム:

Server.java - wolfSSL JNI サーバーサンプルプログラム
Client.java - wolfSSL JNI クライアントサンプルプログラム

これらのサンプルプログラムは、提供されている bash スクリプトを使って実行できます：

$ cd <wolfssljni_root>
$ ./examples/server.sh <options>
$ ./examples/client.sh <options>

サンプルプログラムの使用方法と使用可能なオプションを表示するには、"-?" を指定します:

$ ./examples/server.sh --help

wolfJSSE Provider サンプルプログラム

examples/provider ディレクトリには、wolfSSL JSSE プロバイダー (wolfJSSE) のサンプルプログラムが含まれています。

サンプルプログラムは、パッケージのルートディレクトリから、提供されたラッパースクリプトを使用して実行する必要があります。ラッパースクリプトは、wolfssljni パッケージに含まれる wolfJSSE プロバイダーで使用するための環境変数を正しく設定します。たとえば、サンプルの JSSE サーバーとクライアントを実行するには、wolfSSL と wolfssljni をコンパイルした後:

$ cd <wolfssljni_root>
$ ./examples/provider/ServerJSSE.sh
$ ./examples/provider/ClientJSSE.sh

デバッグとログ出力に間する注意事項

wolfJSSE デバッグログは、実行時に -Dwolfjsse.debug=true` を使用して有効にできます。

ネイティブ wolfSSL が --enable-debug でコンパイルされている場合、実行時に -Dwolfssl.debug=true` を使用して wolfSSL ネイティブデバッグロギングを有効にできます。

-Djavax.net.debug=all オプションを使用して、JDK デバッグロギングを有効にできます。

wolfJSSE Example Client and Server

SSLSocket API とともに wolfJSSE を使用するクライアント/サーバーアプリケーションのサンプルプログラムです。

ServerJSSE.java - wolfJSSE サーバーサンプルプログラム
\ ClientJSSE.java - wolfJSSE クライアントサンプルプログラム

これらのサンプルプログラムは、提供されている bash スクリプトで実行できます：

$ ./examples/provider/ServerJSSE.sh <options>
$ ./examples/provider/ClientJSSE.sh <options>

ClientSSLSocket.java

SSLSocket を使用した非常に最小限の JSSE クライアントのサンプルプログラムです。 ClientJSSE.java が行うすべてのオプションをサポートしているわけではありません。

使用例は次のとおりです：

$ ./examples/provider/ClientSSLSocket.sh [host] [port] [keystore] [truststore]

wolfSSL サンプルサーバーに接続するための使用例は次のとおりです:

$ ./examples/provider/ClientSSLSocket.sh 127.0.0.1 11111 \
  ./examples/provider/client.jks ./examples/provider/ca-server.jks

client.jksのパスワードは: "wolfSSL test"

MultiThreadedSSLClient.java

指定された数のクライアントスレッドをサーバーに接続するマルチスレッド SSLSocket のサンプルプログラムです。 wolfJSSE を使用したマルチスレッドのテストを目的としています。

このサンプルプログラムでは、127.0.0.1:11118 にあるサーバーに対して、指定された数のクライアントスレッドを作成します。このサンプルプログラムは、SSLSocket クラスを使用するように設定されています。 1 つの接続 (ハンドシェイク) を行い、データを送受信し、シャットダウンします。

次のハンドシェーク実行前に、ランダムな時間が各クライアントスレッドに挿入されます。

1) SSL/TLS ハンドシェイク 2) ハンドシェイク後に I/O 操作を行う

それぞれの最大スリープ時間は "maxSleep" で、デフォルトでは 3 秒です。これは、クライアントスレッド操作にランダム性を追加することを目的としています。

使用例:

$ ant examples
$ ./examples/provider/MultiThreadedSSLClient.sh -n <num_client_threads>

このサンプルプログラムは、MultiThreadedSSLServer のサンプルプログラムに接続するように設計されています。

$ ./examples/provider/MultiThreadedSSLServer.sh

このサンプルプログラムでは、平均 SSL/TLS ハンドシェイク時間も出力されます。これは、"startHandshake()" API 呼び出しでミリ秒単位で測定されます。

MultiThreadedSSLServer.java

クライアント接続ごとに新しいスレッドを作成する SSLServerSocket のサンプルプログラムです。

このサーバーはクライアント接続を無限ループで待機し、接続されると接続ごとに新しいスレッドを作成します。このサンプルプログラムは、パッケージルートで"ant examples" を実行するとコンパイルされます。

$ ant examples
$ ./examples/provider/MultiThreadedSSLServer.sh

マルチスレッドクライアントのテストでは、MultiThreadedSSLClient.sh に対してテストします。たとえば、10 個のクライアントスレッドを接続するには、次のようにします：

$ ./examples/provider/MultiThreadedSSLClient.sh -n 10

ProviderTest.java

このサンプルプログラムでは、wolfSSL プロバイダーのインストールをテストします。システムにインストールされているすべてのプロバイダーを一覧表示し、wolfSSL プロバイダーの検索を試み、見つかった場合は、wolfSSL プロバイダーに関する情報を出力します。最後に、Java に TLS を提供するために登録されているプロバイダーをテストします。

このアプリは、wolfJSSE がシステムレベルで正しくインストールされているかどうかをテストするのに役立ちます。

$ ./examples/provider/ProviderTest.sh

wolfJSSE が OS システムレベルでインストールされていない場合、このサンプルプログラムを実行しても wolfJSSE はインストールされたプロバイダーとして表示されないことに注意してください。

ThreadedSSLSocketClientServer.java

クライアントスレッドをサーバースレッドに接続する SSLSocket のサンプルプログラム。

このサンプルプログラムでは、1 つのサーバースレッドと 1 つのクライアントスレッドの 2 つのスレッドを作成します。サンプルプログラムは、SSLSocket および SSLServerSocket クラスを使用するように設定されています。両スレッドで互いに通信に１つの接続 (ハンドシェイク) とシャットダウンを実行します。

使用例:

$ ./examples/provider/ThreadedSSLSocketClientServer.sh