暗号DLLは、Microsoft Visual C++ Ver 5.0で作成しています。サンプルは、Microsoft Visual Basic Ver 5.0 で作成しています。
※　本製品は日本語環境のみの対応となります。

バーションアップの情報は、弊社ホームページの新着情報で通知し、各商品のページの更新履歴で更新内容を掲示致します。

開発環境でのバージョンアップ

• WILLWARE Components（全製品）のバージョンアップ
  
  ダウンロードファイル名：「Willware.exe」
  
  「Willware.exe」は全ての製品の最新版をインストールするためのものです。そのため本製品以外の製品及びサンプル、マニュアルも同時にバージョンアップされます。
  
  
• 暗号DLL単体のバージョンアップ
  
  ダウンロードファイル名：「Cryptdll.exe」
  
  「Cryptdll.exe」は暗号DLLのdllファイル及び依存ファイルのみの最新版をインストールするためのものです。サンプル及びマニュアルはバージョンアップされませんのでご注意下さい。

実行環境でのバージョンアップ

• 暗号DLL単体のバージョンアップ
  
  ダウンロードファイル名：「Cryptdll.exe」
  
  暗号DLLのdllファイル及び、依存ファイルがバージョンアップされます。

各セットアップキットを利用してバーションアップをする前に、以下のことにご注意下さい。

• 「Willware.exe」を利用してバージョンアップする場合は、古いバージョンをアンインストールしてから、最新バージョンをインストールすることをお勧めいたします。
  
  ※アンインストールの方法は、スタートメニューから「設定」→「コントロールパネル」→「アプリケーションの追加と削除」の画面で、「WILLWARE Components」を選択し、画面の指示に従って行って下さい。
  
  
• 「Cryptdll.exe」を利用してバージョンアップする場合は、最新バージョンをそのままインストールして下さい。古いファイルは上書きされます。
  
  ※弊社製品を複数ご利用いただいている場合、いずれか１つをバーションアップしても他の製品に影響はありません。

暗号DLLは、データの暗号と復号、およびデータの要約値の計算を行うためのインプロセスActive X オートメーションサーバーです。VBやVC++はもとよりASPなどのスクリプト環境からも利用できます。

暗号DLLの暗号方式は米RSA社のRC4と呼ばれる暗号方式です。RC4はSSLでも採用されていて、高速であること、バイト単位のデータの暗号化ができること、40ビットから128ビットまでの暗号強度を選択できることなどが特徴です。RC4の鍵は秘密鍵（共通鍵）方式で、いわゆるパスワードを用いて暗号を行います。

暗号DLLは、Microsoft Cryptographic Providerを利用しています。

暗号DLLは暗号OCXと暗号データに互換性があります。暗号OCXで暗号化したデータを暗号DLLで復号化することやその逆を行うことができます。

要約値の計算は、MD5およびSHA-1の２つの方法から選択できます。要約値は、データに固有な値を表現しますので、データの同一性を保証するためやデータの改竄（かいざん）を検出するために利用されます。

その１

Dim Crypt1 As New WILLCRPT

その2

Dim Crypt1 As WILLCRPT
Set Crypt1 = New WILLCRPT

その3

Dim Crypt1 As WILLCRPT
Set Crypt1 = CreateObject("WILLCRPT")

その4

Dim Crypt1 As Object
Set Crypt1 = CreateObject("WILLCRPT")

暗号化する手順は

1. OpenRC4メソッド
2. Encryptメソッド（必要に応じて繰り返し呼び出す）
3. CloseRC4メソッド

です。
暗号結果はEncryptメソッドに渡した変数に戻されます。

OpenRC4メソッドでパスワード、パスワードのハッシュ方法、暗号強度、文字データを暗号化した場合の出力フォーマットを指定します。
パスワードは、Unicodeで指定してください。
このパスワードのハッシュ値（要約値またはダイジェスト値とも呼ぶ）を用いて暗号化します。

ハッシュ方法は、MD5とSHA-1のいづれかを選択できます。
MD5を利用するときは、0を、SHA-1を利用するときは、1をパスワードのハッシュ方法として指定してください。

暗号強度は、40から128までの値を指定できますが、利用できる暗号プロバイダ(Cryptographic Provider)によって指定できる値に制限があることがあります。

暗号プロバイダー名

利用できる強度(ビット数)

Microsoft Base Cryptographic Provider v1.0

40,128

Microsoft Base Cryptographic Provider v1.0

40-56,128

Microsoft Enhanced Cryptographic Provider

40-128

Microsoft Strong Cryptographic Provider

40-128

「Microsoft Base Cryptographic Provider v1.0」は2種類あり、初期のもの(IE4.0以前に附属のもの)は40または128ビットしか指定できません。
強度と互換性を考えると、128ビットを選択するのが良いでしょう。暗号プロバイダを確認するには、GetCPSNameメソッドを呼び出してください。
GetCPSメソッドはいつでも呼び出すことができます。

暗号化するデータが文字列の場合、そのまま暗号化すると、暗号結果が文字列としては正しくなくなる場合があります。
暗号後も文字列として扱いたい場合は、出力フォーマットに0を指定することで、16進文字列として暗号結果を格納することができます。(デフォルト)
ただし、この場合、出力される文字列の長さは暗号前の長さの2倍になるので、格納するエリアの大きさに注意してください。

逆に、暗号結果をバイナリ文字列として扱いたい場合は1を指定してください。
この場合、暗号前の文字列の長さと暗号後の文字列の長さは同じになります。

データを暗号化するには、Encryptメソッドを呼び出します。
引数は、ユーザー定義型、オブジェクト型を除くすべての型とその一次元配列（ただしバリアントおよび文字列の配列は除く）を指定できます。
暗号化した結果はもとの変数に格納されます。
大きなファイルを暗号化する場合や、ネットワークで転送しながら暗号化する場合には、
データを小分けにして複数回Encryptメソッドを呼び出してください。分ける最小単位はバイトです。
効率を考えてある程度の大きさでわけると良いでしょう。

暗号化が終了したらCloseRC4メソッドを呼び出してください。
このメソッドを呼び出さないと再度OpenRC4メソッドを呼び出すことができません。

復号化する手順は

1. OpenRC4メソッド
2. Decryptメソッド（必要に応じて繰り返し呼び出す）
3. CloseRC4メソッド

です。

復号結果はDecryptメソッドに渡した変数に戻されます。

復号化では暗号化を行ったパラメータを使ってOpenRC4メソッドを呼び出してください。
ことなるパラメータを使うとエラーにならずに異なる結果を生み出します。

ただしく復号されたかどうかを知るには、暗号するデータにチェック用のデータを忍ばせておくのが良いでしょう。
正しく復号化できたときだけ正しいチェック用のデータが得られます。

要約値は、データに依存する16バイトまたは20バイトの値です。

要約値を計算する手順はOpenDigestメソッド

1. AddDigestメソッド（必要に応じて繰り返し呼び出す）
2. GetDigestValueメソッドまたはGetDigestHexStringメソッド
3. CloseDigestメソッド

です。

要約値の計算方法は2つあります。MD5とSHA-1です。
AddDigestで要約計算対象となるデータを渡します。
大きなファイルの要約値を計算する場合はデータを小分けにして複数回AddDigestメソッドを呼び出してください。
分ける最小単位はバイトです。効率を考えてある程度の大きさでわけると良いでしょう。

要約値を取り出すには、GetDigestValueメソッドまたはGetDigestHexStringメソッドを使います。
GetDigestValueメソッドはバイナリ文字列、GetDigestHexStringメソッドは16進文字列を返します。

Encrypt,Decryptをおこなう前にかならず実行します。暗号強度は、40から128までの間の数値を指定できますが、57から127までの値を設定する場合は、Windowsの暗号強度を128ビットにしておく必要があります。サポートしていない強度を選択するとエラーになります。CRYPTOCXと互換を取るには、40または128を指定してください。(40の時はCreateSaltをFalseに、128のときは、CreateSaltをTrueに設定したものに対応します。)変換フォーマットは、文字列の暗号化にのみ有効です。EncryptとDecryptは同じフォーマットを選択する必要があります。

Dataには、任意の変数（1次元配列も含む）を指定できます。（Object型、ユーザー指定型、文字列型の配列、VARIANT型の配列は除きます。）Dataに文字列を指定した場合、OpenRC4で指定したFormatに従った変換を行います。暗号結果は元の変数に格納します。

Dataには、任意の変数（1次元配列も含む）を指定できます。（Object型、ユーザー指定型、文字列型の配列、VARIANT型の配列は除く）Dataに文字列を指定した場合、OpenRC4で指定したFormatに従った変換を行います。復号結果は元の変数に格納します。

1. 暗号したい文を「平文」に入力して下さい。
2. パスワードを指定して下さい。
3. 128ビットを指定する場合は、チェックボックスにチェックをつけてください。
4. 「暗号化」ボタンを押すと。入力した文が暗号化されます。
5. 「複合化」ボタンを押すと暗号化された文が複合化されます。