グローバルリソースのプロパティ

接続設定

グローバルリソースの接続設定は、各アダプタのプロパティ設定ダイアログ、コントロールパネルの「グローバルリソースの設定」から行うことができます。

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	接続先の設定の名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明	備考
URL	必須	環境変数のみ使用可	REST APIにアクセスするためのURLを入力します。	「http://」または「https://」から始まるURLを指定してください。 URLのパスの部分は、[エンコード]で選択または入力したエンコードでURLエンコーディングされます。

プロパティアクション

項目名	説明	備考
接続テスト	[URL]で入力したURLのホストとポート番号に接続します。	タイムアウトは[接続タイムアウト]で指定した値のみ有効です。

タイムアウト設定

項目名	必須/省略可	変数の使用	説明	備考
接続タイムアウト	省略可	環境変数のみ使用可	接続のタイムアウト時間をミリ秒単位で入力します。	省略した場合、「0」を入力した場合、または不正な値を入力した場合、タイムアウトしません。
応答タイムアウト	省略可	環境変数のみ使用可	HTTPサーバ接続後、リクエストを送信してからレスポンスを受信するまでの応答のタイムアウト時間をミリ秒単位で入力します。	省略した場合、「0」を入力した場合、または不正な値を入力した場合、タイムアウトしません。

クライアント証明書設定

項目名

必須/省略可

変数の使用

説明

備考

クライアント証明書を使用する

省略可

使用不可

クライアント証明書を使用するかどうかを選択します。

[チェックあり]:
クライアント証明書を使用します。
[チェックなし]:(デフォルト)
クライアント証明書を使用しません。

[URL]に「http://」から始まるURLを指定した場合、チェックを入れてもクライアント証明書は使用されません。

証明書ストアファイル

必須

環境変数のみ使用可

クライアント証明書ストアファイルのファイルパスを入力します。

[参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。

[クライアント証明書を使用する]にチェックを入れた場合、有効になります。
DataSpider Cloudサーバローカルファイルシステム上の絶対パスを指定します。
例:エクスプローラの/data/sample.pfxを指定する場合
/usr/local/dataspider/server/data/sample.pfx

証明書ストアパスワード

省略可

環境変数のみ使用可

クライアント証明書ストアファイルのパスワードを入力します。

[クライアント証明書を使用する]にチェックを入れた場合、有効になります。

証明書ストア形式

必須

使用不可

クライアント証明書ストアファイルのストア形式を選択します。

[PKCS #12]:(デフォルト)
PKCS #12形式でクライアント証明書ストアファイルを扱います。
[JKS]:
JKS形式でクライアント証明書ストアファイルを扱います。

[クライアント証明書を使用する]にチェックを入れた場合、有効になります。
鍵ファイルと証明書ファイルが別の場合、opensslコマンド等を利用してストアファイルを作成してください。
例:opensslコマンドの場合

openssl pkcs12 -export -inkey <鍵ファイル> -in <証明書ファイル> -out <ストアファイル>

プロパティアクション

項目名	説明	備考
証明書の表示	[証明書ストアファイル]で入力した証明書の内容を表示します。

コンポーネントプールの設定

コンポーネントプールはサポートしていません。

セキュリティ

セキュリティの設定は、コントロールパネルの「グローバルリソースの設定」から行うことができます。

仕様制限

[URL]にクエリパラメータまたはURLフラグメントを指定した場合、無視されます。

接続テストではプロキシサーバの設定は参照されません。

主な例外

例外名	原因	対策
InvalidPropertyConfigurationException <プロパティ名>が指定されていません。	[<プロパティ名>]が指定されていません。	[<プロパティ名>]を指定してください。
java.net.ConnectException Connection refused: connect	接続先から接続が拒否されました。	[URL]に指定したホスト名、ポート番号を確認してください。
java.net.ConnectException connect timed out	接続のタイムアウトが発生しました。	[接続タイムアウト]の設定を確認してください。
java.net.MalformedURLException	不正な形式のURLです。	[URL]の設定を確認してください。
java.net.java.net.UnknownHostException <ホスト名>	不正なホスト名です。	[URL]に指定したホスト名を確認してください。