うるふブログ

wolfSSLライブラリを使って目的の組込みアプリケーションを開発する際、ビルドが終わってターゲッットにダウンロードしたアプリケーションのTLS通信をテストするのに対向テスト用のTLSクライアントないしサーバが必要になります。wolfSSLではそのような時のために、PCやLinuxなどの通常の開発環境の上で動作するTLSサーバとクライアントが含まれています。

wolfSSLライブラリを通常のセルフ環境でビルドすると、ライブラリとともに、examplesディレクトリの下にclient/client(TLSクライアント）とserver/server（TLSサーバ）がビルドされます。これらは、１往復の暗号化されたメッセージのやりとりをするだけの簡単なTLSクライアントとサーバですが、さまざまなコマンドオプションを持っているので開発環境の上で動作させて、色々な条件で目的の組込みアプリケーションとの対向テストをすることができます。

wolfSSLのビルドが終わったら、まず二つのコマンドウィンドウを開いて、一つ目のウィンドウから

$ ./examples/server/server

とコマンドを発行してみます。ビルドが正常に終了しているなら、開発環境の上で、テスト用のサーバがTLSアクセプト状態となります。次に、二つ目のウィンドウから

$ ./examples/client/client

とコマンドを発行すると、デフォルトの接続先であるlocalhost(127.0.0.1)、つまり先ほど立ち上げたテスト用サーバにTLS接続に行きます。デフォルトのポートは”11111″です。通信が成功すると次のように、使用されたTLSのバージョン、暗号スイート、楕円曲線の種類や、送られたメッセージなどが表示されるはずです。

===
SSL version is TLSv1.2
SSL cipher suite is TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
SSL curve name is SECP521R1
Client message: hello wolfssl!
===

テスト用サーバとクライアントが正常に動作していることを確認したら、コマンドオプションを指定して目的のテストをしてみてください。

使用例：

クライアント側で一番最初に必要になるのは、次のような接続先、ポート指定でしょう。-h オプションで接続先のホスト、ドメイン名やIPアドレスを、-pオプションでポート番号を指定することができます。

$ ./examples/client/client -h <ホスト名> -p <ポート番号>

また、さらに

-g: 簡単なHTTP GETリクエストの送信

-v: TLSバージョンの指定（0:SSLv3, 1:TLS1.0, 2: TLS1.1: 3:TLS1.2, 4: TLS1.3）

などが可能です。

このコマンドでは証明書、鍵ファイルはデフォルトでは./certsディレクトリの下にあるclient-cert.pem(クライアント証明書)、client-key.pem（クライアント鍵）、ca-cert.pem（CA証明書）が使用されます。これらをテスト用に独自のものに変更したい場合は、
-c <file>  証明書ファイル, -k <file>   鍵ファイル,   -A <file>   CA証明書ファイルの各オプションで指定することができます。

また、-eオプションを指定するとこのビルドで組み込まれている暗号スイートの一覧を得ることができるので、その一覧の中から適当なスイートを選択して -lオプションで指定することで、下記の例のように特定のスイートを指定したTLS接続をテストすることができます。

$ ./examples/client/client -l ECDHE-ECDSA-AES128-GCM-SHA256

テストサーバ側を起動する際は、通常は外部からの接続を可能にするためにポートをバインドする必要があります。これには-bオプションを指定します。デフォルトのアクセプトポートは”11111″です。その他のポートを使用する場合は-pオプションで指定します。また、テストサーバはデフォルトではクライアント認証を行います。このため、クライアント側が認証に対応していない場合は、-dオプションを指定します。

./examples/server/server -b -d -p <ポート番号>

クライアント、サーバとも使用できるオプションについては -? でヘルプメッセージを表示できるので、さらに詳しい使い方についてはそちらを参照してください。

wolfSSLは、お使いの開発環境によって２つのビルドオプションの指定方法があります。
●　configureコマンドでの指定
Linuxなどで主に使われているconfigureコマンドでMakefileを生成する場合は、–enable-xxxxオプションを指定します。
例：
# ./configure –enable-opensslextra –enable-debug
これによって、wolfSSLのライブラリー、サンプルプログラムなどをビルドするMakefileとconfigureコマンドで指定したビルドオプションをC言語のヘッダーファイルに変換したwolfssl/options.hファイルが生成され、makeコマンド実行時に参照されます。自分のアプリケーションのためのコンパイルの際は、コンパイラのincludeオプションやソースコードの先頭の#includeでこのwolfssl/options.hをインクルードしてください。
個々のオプションなど詳細については、ユーザマニュアル2.5　ビルドオプションを参照ください。
https://www.wolfssl.jp/wolfsite/wp-content/uploads/2016/08/wolfSSL_UserManual-jp-3_9_0.pdf
●　user_settings.hによる指定
Windows上でIDEなどconfigureコマンドを使わない環境で開発を行う場合は、user_settings.hというファイル名のヘッダーファイルを作成し、ビルドオプションを設定します。その場合、開発ツールの設定でWOLFSSL_USER_SETTINGSマクロをdefineするよう設定してください。また、user_settings.hのパスをインクルードパスに追加してください。
個々のオプションなど詳細については、ユーザマニュアル　2.4 非標準環境でのビルドを参照ください。
https://www.wolfssl.jp/wolfsite/wp-content/uploads/2016/08/wolfSSL_UserManual-jp-3_9_0.pdf
user_settings.hの各開発プラットフォームの例が、以下のファイルにありますので併せてご参照ください。
Windows: IDE/WIN/user_settings.h
GCC_ARM: IDE/GCC-ARM/Header/user_settings.h
Xcode: IDE/XCODE/user_settings.h
Renesas cs+: IDE/Renesas/cs+/Projects/common/user_settings.h
さらに詳しい情報は弊社問い合わせ窓口info@wolfssl.jpまでお問い合わせください。
wolfSSLホーム：www.wolfssl.jp (English：www.wolfssl.com)