Hitachi

JP1 Version 11 JP1/Automatic Job Management System 3 設計ガイド(業務設計編)


付録C.1 接続設定ファイル

接続設定ファイルには,Web APIを呼び出すために必要なHTTP接続に関する情報を設定します。

ファイルの内容にセキュリティ情報が含まれる場合は,ユーザー責任で管理するようにしてください。

接続設定ファイルの仕様を次の表に示します。

表C‒1 接続設定ファイルの仕様

項番

項目

説明

1

権限

ジョブ実行ユーザーにファイル読み取り権限が必要

2

文字コード

HTTP接続ジョブを実行するエージェントホストで使用している文字コードと同じ文字コードで記載

3

最大サイズ

1,024バイト

接続設定ファイルにはモデルファイルがあります。接続設定ファイルは,モデルファイルをコピーして編集するか,または記述形式に従って作成してください。

接続設定ファイルのモデルファイルの格納先を次に示します。

Windowsの場合

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストール先フォルダ\conf\ajshttpreq_network.conf.model

Linuxの場合

/etc/opt/jp1ajs2/conf/ajshttpreq_network.conf.model

なお,接続設定ファイルは,HTTP接続ジョブを実行するエージェントホスト上の任意の場所に格納してください。

〈この項の構成〉

(1) 記述形式

接続設定ファイルの記述形式を次に示します。

URL=接続先URL
HttpVer=HTTPバージョン
ConnectTimeout=接続タイムアウト時間
Timeout=HTTP接続ジョブ全体の処理時間の上限
MaximumReceivedDataSize=最大受信データサイズ
ClientBindAddrIP=クライアントバインドを行うIPアドレス
Header=追加ヘッダー
Authorization=WebサーバのBasic認証の有無
UserName=WebサーバのBasic認証に使用するユーザー名
UserPass=WebサーバのBasic認証に使用するパスワード
Proxy=プロキシサーバ名
ProxyAuthorization=プロキシサーバの認証の有無
ProxyUserName=プロキシサーバの認証に使用するユーザー名
ProxyUserPass=プロキシサーバの認証に使用するパスワード
CAFile=証明書ファイル名
CrlFile=証明書失効リストファイル名

コメントを記載する際は,行の先頭に「#」を記載してください。半角の空白文字やタブ文字で始まる行のうち,半角の空白文字やタブ文字の次の文字が「#」の行も,コメントとして扱われます。

(2) 記述項目

記述項目について説明します。接続設定ファイルは,各項目を改行文字で区切って記述してください。

(a) URL=接続先URL

接続先のURLを,2,083バイト以内の文字列で指定します。URLは,「http://」または「https://」で始まる必要があります。シングルバイト文字で指定する必要があります。

URLパラメーターの形式は指定できません。URLパラメーターを指定する場合は,送信情報ファイルで指定します。

規定のポート番号以外を使用する場合は,URLに含めた形式で記載が必要です。規定のポート番号を次に示します。

  • httpの場合:80

  • httpsの場合:443

この項目は必須です。

(b) HttpVer=HTTPバージョン

HTTPのバージョンを次のどちらかから指定します。

1.0

HTTP1.0を使用してリクエストします。

1.1

HTTP1.1を使用してリクエストします。

この項目は省略できます。省略した場合,「1.1」が仮定されます。

(c) ConnectTimeout=接続タイムアウト時間

接続先ホストへの接続タイムアウト時間を,1〜600(単位:秒)で指定します。

ここで指定した接続タイムアウト時間内に接続先ホストと通信できない場合,HTTP接続ジョブは異常終了します。

この項目は省略できます。省略した場合,「10」が仮定されます。

注意事項

HTTP接続ジョブが実行されるホストのOSの設定,およびシステムのネットワーク設定によって,この項目で指定した値より短い時間でタイムアウトし,HTTP接続ジョブが異常終了する場合があります。OSの設定については,OSのドキュメントを参照してください。

(d) Timeout=HTTP接続ジョブ全体の処理時間の上限

HTTP接続ジョブ全体の処理時間の上限を,1〜86,400(単位:秒)で指定します。

ここで指定した処理時間内に処理が終了しない場合,HTTP接続ジョブは異常終了します。

この項目は省略できます。省略した場合,「600」が仮定されます。

(e) MaximumReceivedDataSize=最大受信データサイズ

Web APIから取得した受信データの最大受信データサイズを,1〜1,024(単位:メガバイト)で指定します。

指定した値は,受信したHTTPヘッダーの「Content-Length」の値と比較されます。HTTPヘッダーの「Content-Length」の方が大きい場合,データの受信を中断し,HTTP接続ジョブは異常終了します。

受信したHTTPヘッダーに「Content-Length」が指定されていない場合,データを受信しながらデータサイズをチェックします。HTTPボディのデータサイズが指定した値に達した時点でデータの受信を中断し,HTTP接続ジョブは異常終了します。

この項目は省略できます。省略した場合,「500」が仮定されます。

(f) ClientBindAddrIP=クライアントバインドを行うIPアドレス

クライアントバインドを行う場合,バインドするIPアドレスを39バイト以内の文字列で指定します。

IPアドレスは,IPv4アドレスまたはIPv6アドレスで指定できます。

この項目は省略できます。省略した場合,クライアントバインドを行いません。

注意事項

ファイアウォール通過用に送信時のIPアドレスを特定する場合,または特定のLANだけを利用する場合は,クライアントバインドを行ってください。

(g) Header=追加ヘッダー

リクエスト時のHTTPヘッダーに追加でヘッダーを設定する場合,追加するヘッダーを,1,024バイト以内の文字列で指定します。

追加ヘッダーは複数行指定できます。HTTP接続ジョブが設定する項目と同じ項目を設定した場合,「Header=追加ヘッダー」に指定された値が優先されます。

Header=追加ヘッダー」の指定形式を次に示します。

Header=ヘッダー名:ヘッダー値

値を持ったカスタムヘッダーを指定する場合,ヘッダー名とヘッダー値の間に「:(コロン)」を指定します。例えば,ヘッダー名が「ABC」,ヘッダー値が「DEF」というヘッダーを指定したい場合は,「Header=ABC:DEF」と設定します。

Header=ヘッダー名:

HTTP接続ジョブが設定するヘッダーを無効にしたい場合,ヘッダー名の終端に「:(コロン)」を指定します。例えば,「ABC」というヘッダーを無効にしたい場合は,「Header=ABC:」と設定します。

Header=ヘッダー名;

値を持たないカスタムヘッダーを設定する場合,ヘッダー名の終端に「;(セミコロン)」を指定します。例えば,「ABC」という値を持たないヘッダーを指定したい場合は,「Header=ABC;」と設定します。

この項目は省略できます。省略した場合,ヘッダーを追加しません。

注意事項

HTTP接続ジョブが設定するヘッダーを無効にすると,HTTP接続ジョブが正常に実行されなくなるおそれがあります。十分に検討してから実施してください。

(h) Authorization=WebサーバのBasic認証の有無

WebサーバでBasic認証を行うかどうかを,次のどちらかから指定します。

y

WebサーバでBasic認証を行います。

n

WebサーバでBasic認証を行いません。

y」を指定した場合,「UserName=WebサーバのBasic認証に使用するユーザー名」と「UserPass=WebサーバのBasic認証に使用するパスワード」に指定された値を基に,リクエスト時のHTTPヘッダーにAuthorizationヘッダーを付与します。なお,「Header=追加ヘッダー」でAuthorizationヘッダーを付与している場合,「Header=追加ヘッダー」に付与された値が有効になります。

Basic認証以外の認証方式を使用する場合は,「Header=追加ヘッダー」で指定する必要があります。

接続先がWebサーバでの認証を必要としない場合に,「y」を指定したときの動作は,接続先のWebサーバの仕様に依存します。

この項目は省略できます。省略した場合,「n」が仮定されます。

(i) UserName=WebサーバのBasic認証に使用するユーザー名

WebサーバでBasic認証を行う場合,認証に使用するユーザー名を256バイト以内の文字列で指定します。ユーザー名に「:(コロン)」は使用できません。

WebサーバでBasic認証を行う場合,この項目は必須です。

(j) UserPass=WebサーバのBasic認証に使用するパスワード

WebサーバでBasic認証を行う場合,認証に使用するパスワードを256バイト以内の文字列で指定します。

WebサーバでBasic認証を行う場合,この項目は必須です。

(k) Proxy=プロキシサーバ名

プロキシサーバを利用する場合,プロキシサーバ名を2,083バイト以内の文字列で指定します。

プロキシサーバでBasic認証を行う場合,この項目は必須です。

(l) ProxyAuthorization=プロキシサーバのBasic認証の有無

プロキシサーバを利用する場合,プロキシサーバでBasic認証を行うかどうかを,次のどちらかから指定します。

y

プロキシサーバでBasic認証を行います。

n

プロキシサーバでBasic認証を行いません。

y」を指定した場合,「ProxyUserName=プロキシサーバのBasic認証に使用するユーザー名」と「ProxyUserPass=プロキシサーバのBasic認証に使用するパスワード」に指定された値を基に,リクエスト時のHTTPヘッダーにProxyAuthorizationヘッダーを付与します。なお,「Header=追加ヘッダー」でProxyAuthorizationヘッダーを付与している場合,「Header=追加ヘッダー」に付与された値が有効になります。

Basic認証以外の認証方式を使用する場合は,「Header=追加ヘッダー」で指定する必要があります。

接続先がプロキシサーバでの認証を必要としない場合に,「y」を指定したときの動作は,接続先のプロキシサーバの仕様に依存します。

この項目は省略できます。省略した場合,「n」が仮定されます。

(m) ProxyUserName=プロキシサーバのBasic認証に使用するユーザー名

プロキシサーバでBasic認証を行う場合,認証に使用するユーザー名を256バイト以内の文字列で指定します。ユーザー名に「:(コロン)」は使用できません。

プロキシサーバでBasic認証を行う場合,この項目は必須です。

(n) ProxyUserPass=プロキシサーバのBasic認証に使用するパスワード

プロキシサーバでBasic認証を行う場合,認証に使用するパスワードを256バイト以内の文字列で指定します。

プロキシサーバでBasic認証を行う場合,この項目は必須です。

(o) CAFile=証明書ファイル名

サーバ証明書を検証する場合,証明書のファイル名を511バイト以内の文字列で指定します。証明書はPEM形式である必要があります。DER形式を指定した場合,メッセージKAVS8062-Eが出力され,HTTP接続ジョブは異常終了します。

この項目は省略できます。

(p) CrlFile=証明書失効リストファイル名

サーバ証明書を検証する場合,証明書失効リストファイル名を511バイト以内の文字列で指定します。証明書失効リストファイルはPEM形式である必要があります。DER形式を指定した場合,メッセージKAVS8062-Eが出力され,HTTP接続ジョブは異常終了します。

この項目は省略できます。省略した場合,証明書の失効リストのチェックは行われません。

(3) モデルファイルの形式

接続設定ファイルのモデルファイルの形式を次に示します。

URL=
#HttpVer=1.1
#ConnectTimeout=10
#Timeout=600
#MaximumReceivedDataSize=500
#ClientBindAddrIP=
#Header=
#Authorization=n
#UserName=
#UserPass=
#Proxy=
#ProxyAuthorization=n
#ProxyUserName=
#ProxyUserPass=
#CAFile=
#CrlFile=

省略できる項目はコメント行になっています。任意の値を指定する場合は,指定する項目の「#」を削除してから,任意の値を指定してください。

(4) 注意事項