結合ライセンス

結合ライセンスは、1つのライセンス情報を持ち、クライアントとサーバー製品を同時に使用できるようにするライセンスです。

結合ライセンスは、DEXTSolution販売サイトで1つの認証キーを発行し、クライアント製品とサーバー製品に同じように適用して使用する。

正式ライセンスを使用してください。

正式ライセンスを購入すると、PID(製品番号)と SN(シリアル番号)が与えられます。 PIDは結合される製品の構成によって異なり、DEXTUploadJK結合ライセンスのPIDは 'D?CK'(疑問符を除く)で始まります。

まず、デキストソリューションサイト(http://www.dextsolution.com)にログインし、与えられたPIDとSNで正規登録をする。

認証キーの発行を受けるために 'MYPAGE' > 'インストール情報変更' ページに移動する。

結合ライセンス項目で本物で登録されたライセンスを見つけて、サービス情報(ドメインまたはIP)を変更します。

サービス情報を登録した後、「認証キー発行」ボタンを使用して認証キー文字列を発行し、その文字列を製品を使用したプロジェクトに設定して使用する。

サービス情報（ドメインまたはIP）情報の理解

サービス情報とは、アップロードまたはダウンロードするアドレス(URL)のホスト(host)部分を意味し、スキーマ(http/https)およびポート番号を除く。

アップロードするアドレスが「http://host1.abc.com:8080/service/path?query=string」の場合、host1.abc.comがサービス情報です。

（指定されたドメインがなくても、たとえば「https://123.45.67.122:443/service/path?query=string」）必要に応じてホスト名ではなくIP（123.45.67.122）文字列をサービス情報として入力する必要がある場合もある。

www.abc.comとabc.comが同じサービスであっても、製品では異なるサービスとして認識する。

localhost、127.0.0.1は入力しなくてもサービスが可能です。

入力するサービス情報がない場合は、127.0.0.1を入力できます。

サービス情報が変更された場合は、認証キーを再発行する必要があります。

プロジェクト(ソース)で認証キー文字列を設定する方法

ソースで認証キー文字列を指定する方法は次のとおりです。

通常、サーブレット環境ではFileUploadオブジェクトを使用してアップロードを処理し、オブジェクトの作成時に認証を試みますが、FileUploadオブジェクトの作成時にEnvironmentオブジェクトをパラメータとして受け取ります。

Environmentオブジェクトはライセンスファイルのパスを指すlicenseAuthKey属性を持っているので、setLicenseAuthKeyメソッドを使用して認証キー文字列を設定するだけです。

# ソースコードで環境設定オブジェクトを作成してすぐに適用する場合
Environment env = new Environment(); 
...
env.setLicenseAuthKey("cfHzOu ...... rPTl1P");

Spring環境では、JKMultipartResolverオブジェクトを使用してアップロードを処理します。 JKMultipartResolverオブジェクトはenvironment属性を持っているので、この属性を使用してライセンスファイルパス情報を持つEnvironmentオブジェクトを指定すればよい

# Spring環境でEnvironment Beanを設定する場合
<bean id="idName" class="dextuploadjk.support.spring.JKMultipartResolver">
  ...
  <property name="environment">
    <bean class="dextuploadjk.engine.Environment">
      <property name="licenseAuthKey" value="cfHzOu ...... rPTl1P"/>
    </bean>
  </property>
  ...
</bean>

大容量ファイルアップロード(2GB以上)の場合は、JKExtensionUploadFilterまたはJKSpringExtensionUploadFilterオブジェクトがファイルアップロードを担当します。そのフィルタのlicenseAuthKeyパラメータに直接認証キー文字列を指定するだけです。

# 大容量アップロード環境でフィルタオブジェクトのパラメータとして渡す場合
<filter>
  <filter-name>extensionUploadFilter</filter-name>
  <filter-class>dextuploadjk.support.common.JKExtensionUploadFilter</filter-class>
  ...
  <init-param>
    <param-name>licenseAuthKey</param-name>
    <param-value>cfHzOu ...... rPTl1P</param-value>
  </init-param>
</filter>

クライアントとサーバーの両方の製品に同じ認証キーを設定しなければ、認証エラーなしで使用できます。クライアント製品で同じ認証キーを使用してライセンスを設定する方法については、その製品のマニュアルを参照してください。

サーバーをエスカレーションまたはサーバー情報が変更された場合

DEXTUploadJKは認証検査を行う際にサービス情報が基準となる。したがって、ファイルをアップロードするアドレスのホスト（=サービス情報）が変更されない場合は、認証キーを再発行する必要はありません。

もしサービス情報が変更された場合、デキストソリューションサイト(http://www.dextsolution.com)ログイン後、'MYPAGE' > 'インストール情報変更'ページでサービス情報を修正して認証キーを再発行してもらえます。そして再発行された認証キーを製品にリセットし、WebアプリケーションまたはWASを再起動すればよい。

ライセンス注意事項

(株)デキストソリューションはライセンス購入時点の購入/使用先顧客情報とPID(製品番号)、SN(シリアル番号)、ライセンス種類についてのみ管理を行う。
ライセンスインストール情報の変更(ホスト名、IP修正)作業と認証キーの再発行過程は顧客が直接管理しなければならない事項だ。