結合ライセンス

結合ライセンスは、単一のライセンスの情報を持っているクライアントとサーバー製品を同時に使用できるように提供されるライセンスである。

結合ライセンスはDEXTSolution販売サイトの1つの認証キーの発給を受け、クライアント製品とサーバー製品にも同様に適用して使用する。

DEXTUploadNJは2.1.0バージョンから結合ライセンスをサポートする。

正式ライセンスを使用する。

正式ライセンスを購入すると、PID（製品番号）とSN（シリアル番号）が与えられる。 PIDは結合されている製品の構成に応じて異なりDEXTUploadNJ結合ライセンスのPIDは「D？CJ」（疑問符を除いて）で開始します。

まず、インデックスアップデートソリューションサイト(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");

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

# スプリング環境でEnvironment空を設定した場合
<bean id="idName" class="devpia.dextuploadnj.support.spring.DEXTUploadNJMultipartResolver">
  ...
  <property name="environment">
    <bean class="devpia.dextuploadnj.Environment">
      <property name="licenseAuthKey" value="cfHzOu ... 認証キーの文字列 ... rPTl1P"/>
    </bean>
  </property>
  ...
</bean>

大容量ファイルのアップロード（2GB以上）の場合には、ExtensionFileUploadFilterオブジェクトがファイルのアップロードを担当する。 ExtensionFileUploadFilterオブジェクトはEnvironmentオブジェクトを使用せずにlicenseAuthKeyパラメータに直接認証キー文字列を指定すればよい。

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

クライアントとサーバー製品二ところ、同じ認証キーを設定しなければならない認証エラーなしで使用することができる。クライアント製品で同じ認証キーを持ってライセンスの設定をする方法は、製品のマニュアルを参照している。

サーバーを移管するか、サーバーの情報が変更された場合

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

もしサービス情報が変更とすれば、インデックスアップデートソリューションサイト(http://www.dextsolution.com)ログイン後、「MYPAGE」 < 「インストール情報の変更」ページで、サービスの情報を変更して、認証キーを再再発行受け取るされる。そして再発行された認証キーを製品に再度設定し、Webアプリケーション、またはWASを再起動すればよい。

ライセンス注意事項

（株）デブピアはライセンスを購入時点の購入/使用先の顧客情報とPID（製品番号）、SN（シリアル番号）、ライセンスの種類のみ管理をする。
ライセンスのインストール情報の変更（ホスト名、IPの変更）の操作と、認証キーを再発行される過程は、顧客が直接管理しなければならない事項である。