接続ライセンスの仕組み

ここでは、接続ライセンスの技術的な仕組みと利用方法について説明します。

接続ライセンスの概要

接続ライセンスには、接続できるWebサーバの情報が登録されています。Biz/Browserは、登録されたWebサーバへの通信のみを許可します。

接続ライセンスは接続するサーバ単位で必要です。サーバAへの接続ライセンスはサーバBでは利用できません。また、有効期限が明示されている場合は、示された期日以降はその接続ライセンスは無効となります。

接続ライセンスの有無で制限される機能

Biz/Browserには多くの通信機能が搭載されていますが、そのうちNetObjectクラスのGetメソッドを利用したhttpまたはhttps通信だけが、接続ライセンスの有無により制限されます。

RootクラスのLoginメソッド、HttpSessionクラスのGet、Postメソッド、import命令などは、接続ライセンスの有無に関わらず通信を行います。

接続ライセンスがない場合

接続ライセンスの登録

接続ライセンスは、Biz/Browserに接続ライセンス証明書をインポートすることで登録されます。

接続ライセンス証明書（XMLファイル）は、Webサーバに配置して各クライアントPCのBiz/Browserに配布します。CRSプログラム上からimportConnectionLicense関数で接続ライセンス証明書をダウンロードします。記載内容に問題がなければ接続ライセンスが登録されます。

登録された接続ライセンス証明書は、Biz/BrowserがインストールされているクライアントPCに保存され、次回以降のBiz/Browserの起動時には自動的に読み込まれます。

Biz/Browser V以降では、接続ライセンス証明書にセキュリティレベルが記載されます。そのWebサーバへの接続時は証明書のセキュリティレベルが適用されます。接続ライセンス証明書を利用することで、各クライアントPCのセキュリティレベルをサーバ側で一括管理できます。

接続ライセンスの確認

登録された接続ライセンスは、Biz/Browserのメニュー「表示」→「接続ライセンスの確認」から確認できます。

また、CRSプログラム上ではhasConnectionLicense関数で確認できます。

一般的なライセンス登録の流れ

Biz/Browserを利用したシステムは、Loginメソッドの呼び出しから始まります。（ログイン画面のURL選択でもLoginメソッドが呼ばれます）

//.Login("http://server/start.crs");

Loginメソッドによる通信は接続ライセンスによる制限がありません。つまり、このメソッドに指定するCRSファイルは制限を受けずに実行できます。通常、このCRSファイル内で接続ライセンスを登録するプログラムを記述します。

start.crs

/* 接続ライセンスの確認とインポート */

if (!hasConnectionLicense("http://server")) {

    try {

        importConnectionLicense("http://server/license.xml");

    } catch (exp) {

        MessageBox(exp);

        Login();

Get("appmain.crs");

システムのメインとなるCRSファイルは、接続ライセンスの確認、登録のあとでNetObjectクラスのGetメソッドで呼び出します。

接続先Webサーバの情報について

接続ライセンスには、Webサーバ情報として「プロトコル（http、httpsなど）」、「ホスト名」、「ポート番号」が登録されています。（例：http://example.com:8080）

Biz/Browserは、これらの情報と完全に一致する場合のみ、通信を許可します。

例えば、「ホスト名」はドメインの有無、IPアドレスの直接表記、ホスト名の別名など、同一の接続先を示すさまざまな表記方法がありますが、接続ライセンスに登録されたホスト名と一致する表記だけが有効になります。

接続ライセンスはWebサーバ単位で登録されるため、それ以降のURLにより制限されることはありません。例えば、/app1/sample1.crsと/app2/sample2.crsのようなURLで、app1とapp2が別システムの場合でも、個別に制限を受けることはありません。

接続ライセンスによる接続先のチェックは、GetメソッドによりアクセスするURLに対して行われます。実際に配置されたCRSファイルの場所が異なる場合（別のサーバによる中継、ロードバランサなど）でも、最初にアクセスするURLが対象になります。

接続ライセンス証明書の保存先

接続ライセンス証明書（XMLファイル）のクライアントPCへの保存先は、証明書に記載された利用目的（public、private）、OS、Biz/Broserのバージョンによって異なります。

利用目的がpublicの場合

Biz/Browserのインストールフォルダに保存されます。証明書はログインユーザに関係なく共有されます。

Biz/Browser	保存先
Biz/Browser XE	(インストールフォルダ)\settings.v41\license
Biz/Browser V	(インストールフォルダ)\settings.v50\license
Biz/Browser Mobile V2	(インストールフォルダ)\settings.v2\license
Biz/Browser Mobile V3	(インストールフォルダ)\settings.v3\license
Biz/Browser Mobile V4	(インストールフォルダ)\settings.v4\license
Biz/Browser AI	/data/data/jp.co.axissoft.biz/files/license

Windows Vista以降のOSでは、VirtualStore機能により"Program Files"以下のフォルダへのアクセスが別の場所に転送されます。Biz/Browserを"Program Files"にインストールした場合は、ライセンスファイルの保存先が以下に変わる場合があるので注意してください。

Biz/Browser	保存先
Biz/Browser XE	C:\Users\(ユーザ名)\AppData\Local\VirtualStore\Program Files\AXIS SOFT\BizBrowser41\settings.v41\license
Biz/Browser V	C:\Users\(ユーザ名)\AppData\Local\VirtualStore\Program Files\AXISSOFT\BizBrowserV\settings.v50\license

利用目的がprivateの場合

ユーザ別のフォルダに保存されます。証明書はログインユーザごとに管理されます。

（Windows 98/Meのユーザ共通設定の場合は、ユーザ別に保存先が異なることは無いため、public、 privateは意味を持ちません。）

Biz/Browser XE以前

OS	保存先
Windows Vista以降	C:\Users\(ユーザ名)\AppData\Roaming\AXIS Soft\BizBrowser\license
Windows XP Windows 2000	C:\Documents and Settings\(ユーザ名)\Application Data\AXIS Soft\BizBrowser\license
Windows NT	C:\WINNT\Profiles\(ユーザ名)\Application Data\AXIS Soft\BizBrowser\license
Windows Me Windows 98	ユーザ個別設定のとき C:\Windows\Profiles\(ユーザ名)\Application Data\AXIS Soft\BizBrowser\license ユーザ共通設定のとき C:\Windows\Application Data\AXIS Soft\BizBrowser\license

Biz/Browser V以降

OS	保存先
Windows Vista以降	C:\Users\(ユーザ名)\AppData\Roaming\AXISSOFT\BizBrowser\license
Windows XP Windows 2000	C:\Documents and Settings\(ユーザ名)\Application Data\AXISSOFT\BizBrowser\license
Windows NT	C:\WINNT\Profiles\(ユーザ名)\Application Data\AXISSOFT\BizBrowser\license

Biz/Browser AI

保存先

/data/data/jp.co.axissoft.biz/files/filesystem/private_root/license