HULFT-WebConnect 設定ガイド【Webブラウザ方式の設定ポイント】（4/6）

# Webブラウザ方式の設定ポイント
こんにちは、よろず相談担当 すぎもんです。本日は、HULFT-WebConnectの設定方法のポイントについてご紹介します。
今回は4回目で、Webブラウザ方式の設定について解説いたします。

## Webブラウザ方式の特長
Webブラウザ方式は、Webブラウザだけで簡易的なファイル授受転送する仕組みで、WebConnectサービスが標準で提供しているWebサイト（ **Data Transfer Site** ）へアクセスしてファイルをアップロード／ダウンロードすることができます。
大きな特長が、**HULFT未導入のシステム**からもHULFTとファイルを授受できることはCLIと共通していますが、**利用者側が特別なモジュールのインストールや設定が不要でWebブラウザさえあればOK**という手軽な仕組みです。
一方でCLIとの大きな違いが、**自動化が難しい**ということです。Webブラウザという人の操作で行う必要があるので、この点だけ意識しておいてください。
「RPAを使えば自動化できるのでは？」との突っ込みがありそうですが、RPAを活用すれば自動化はもちろん可能です。ただし、**RPAは人の操作をシミュレーションするという本質的には不安定な仕組み** なので、ちょっとした想定外の事象（Webサイトのデザイン変更、ポップアップ表示、など）で簡単に失敗することがあります。ですから、**自動化の仕組みを考えている場合はCLI方式** を採用した方が安心して運用できます。

## 設定の流れ
設定箇所は、次の４ポイントをおさえる必要があります。
1. WebConnectサービス側の設定（Management Console）
2. Agentの設定（agent.conf/connection.key.store）
3. HULFTの設定（各種管理情報）
4. **Webブラウザの設定**（Management Console）

2は[Agent方式](https://qiita.com/sugimon/items/071693e248014505c8f3![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/7a4d9272-5dc5-1ec4-6bc5-811820007748.png)
)と考え方が同じなので割愛します。
Webブラウザ方式では、4の**Webブラウザの設定**が中心となります。
![035_ブラウザ方式.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/a5f04d93-6521-8f14-d052-32d2dad8d8e8.png)


下図は、前回も紹介したWebConnectのオンラインマニュアル（[ファーストステップガイド](https://www.hulft.com/help/ja-jp/WebConnect-V3/index.htm)）に記載のある設定の流れで、**赤枠**部分が今回の設定箇所です。
![036_設定の流れ（ブラウザ）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/eab53273-0340-7e6c-6165-c12b3bb32153.png)

さらにWebブラウザ方式に特化した詳細な流れは下図になります。（[ブラウザ転送管理者ガイド](https://www.hulft.com/help/ja-jp/WebConnect-V3/index.htm)抜粋）
下図のように、管理者が一通り設定が完了した後で案内メール（Management Consoleより送付）でパスワード設定を促して、準備完了となります。
![037_設定の流れ（ブラウザ詳細）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/013c89d1-ec93-348f-4434-760db5df05b2.png)



## 設定の手順
![038_Webブラウザ方式（接続設定の全体イメージ）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/f6c2632c-a55a-2e5b-e112-0c9e2ac336ca.png)

### Webブラウザ方式の設定の考え方
Webブラウザ方式は、他の方式と異なりクライアント側（Webブラウザ側）には全く設定が不要となります。クライアントは、WebConnectサービスが用意したファイル授受用のサイト（ **Data Transfer Site** ）へID/PWでログインすれば、予め設定されたファイルIDでアップロード／ダウンロードできる、という仕組みです。
設定手順の観点では、***クライアント側の設定をWebConnectサービス側（Monegement Console）で行う***、という点が大きく変わります。前回までの[Agent方式](https://qiita.com/sugimon/items/071693e248014505c8f3)、[CLI方式](https://qiita.com/sugimon/items/aed0713cf56dbd0de063)を読まれた方は理解していると思いますが、WebConnectは**コネクションID**＋**Agent ID**＋**HULFTホスト名**の3つの情報がセットで宛先識別をしています。このあたりの仕組みがWebブラウザ方式ではどのように設定されるかを意識すると設定方法がより理解しやすくなると思います。

### Management Consoleの設定
#### 1. アカウントの作成
Webブラウザ方式では、ファイル授受サイト（ **Data Transfer Site** ）へログインするアカウント（＝メールアドレス）の登録をまず行います。
![039_MC_アカウント登録（Webブラウザ）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/ec33f57c-d141-7432-a48f-6a96e56f7bba.png)
アカウントを登録したら、**パスワード設定依頼**ボタンを押すことでアカウント登録の通知メールをアカウント（＝メールアドレス）宛てに送付されます。
![040_MC_アカウント登録（Webブラウザ2）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/9da7767a-0183-0cb8-7ca7-e86ea08ba6fa.png)

:::note warn
**注意ポイント**
パスワード設定依頼メールは、**全ての設定が完了してから送付**することを強くお勧めします。利用者がログインできるようになっても設定が完了していないと何も行えないため、利用者をいたずらに混乱させてしまうことが無いようにしましょう。
:::

以下のような文面で利用者に案内が届きますので、利用者がリンクからパスワードを設定するこでファイル授受ができるようになります。
```From. HULFT-WebConnect　（案内メール サンプル）
件名：HULFT-WebConnect より：ログインパスワード設定のお願い/HULFT-WebConnect Notification: Set Up Your Login Password

(English follows Japanese)

HULFT-WebConnect サービスのご利用、ありがとうございます。

HULFT-WebConnect サービスのアカウント情報が登録されました。
次のリンクにアクセスし、パスワードを設定してください。
https://www.webconnect.hulft.com/#/password/setting/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
このリンクは、24時間後に無効になります。

本メールアドレスは送信専用です。返信は受け付けておりません。
お問い合わせする場合は、システム管理者にご連絡ください。

HULFT-WebConnect
https://www.webconnect.hulft.com/

--------------------------------------------------------------------------------

Thank you for using the HULFT-WebConnect service.

Your account information was registered in the HULFT-WebConnect service.
Please access to the below link to set up your login password.
https://www.webconnect.hulft.com/#/password/setting/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Note: This link will only be available for 24 hours.

This email has been sent from a send-only address.
Please do not reply to this email.

If you have any questions, please contact your system administrator.

HULFT-WebConnect
https://www.webconnect.hulft.com/

```

#### 2. コネクションIDの設定（接続設定）
[Agent方式](https://qiita.com/sugimon/items/071693e248014505c8f3)と基本的には同じです。
注意点は、クライアント種別に **Browser** と **HULFT** の両方にチェックすることです。
![041_MC_接続設定（Web）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/87449ca2-6b44-b2c5-4e4b-c94bb90900f7.png)

::: note warn
**設定の注意ポイント**
クライアント種別では、HULFTも忘れずにチェックする必要があります。
実は、HULFTにチェックを入れないとIPフィルタ（[6回目 その他設定上の考慮ポイント](https://qiita.com/sugimon/items/0ffa6838d24650e8461f)で記載）が有効に働かないというWebConnectの動作上の仕様が関係しています。
:::

#### 3. ルーティングの設定（接続許可）
[Agent方式](https://qiita.com/sugimon/items/071693e248014505c8f3)の手順を参照してください。

#### 4. Webブラウザ側の設定（ブラウザ転送設定）
ここからが、本来クライアント側に設定する項目になります。**ファイルID**や**コネクションID**＋**Agent ID**＋**HULFTホスト名**がどのようにWebブラウザ用に設定されているのか意識してみてください。
##### 4.1. ファイルID【ダウンロード】の設定（ブラウザ送信要求）
**ブラウザ送信要求**とは、ダウンロード（GET要求）になります。相手HULFTからみるとブラウザは送信要求（utlrecv）が行われたかのように振る舞うことになります。このような動作はWebConnectサービス側で変換で変換されます。
下図を見ながら、もう少し細かく設定見てみましょう。
![042_MC_ブラウザ送信要求.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/01167ec9-b12b-3cdb-0922-d67da10dab26.png)
まず、一番上の枠では、**転送設定ID**（Webブラウザに表示されるインターフェースID）と**ファイルID**（HULFTのインターフェースID）の紐付けが行われています。ここではわかりやすく、転送設定ID＝ファイルIDに設定してあります。

次に **ブラウザ定義** ですが、ブラウザ側の宛先をAgent方式のように**コネクションID**＋**Agent ID**＋**HULFTホスト名**の3点セットを設定しています。これが相手先（管理者側HULFT）から見たWebブラウザの宛先となります。ここで面白いのが、Webブラウザのホスト名が**HWC-BROWSER**に固定されていることです。Webブラウザ方式の場合、Agent IDより細かく識別する意味がないので実装上固定にしちゃったことがわかります。

最後に **Agent/HULFT定義** ですが、こちらは管理者側HULFTの宛先設定になります。これは、Agent方式だとHULFTの詳細ホスト情報に設定するに相当する情報になります。つまり、Webブラウザからみた宛先ですね。

##### 4.2. ファイルID【アップロード】の設定（ブラウザ配信要求）
**ブラウザ配信要求**とは、アップロード（PUT要求）になります。相手HULFTからみるとブラウザは配信要求（utlsend）が行われたかのように振る舞うことになります。このような動作はWebConnectサービス側で変換で変換されます。
下図を見ながら、もう少し細かく設定見てみましょう。
![043_MC_ブラウザ配信要求.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/be754381-ec51-b4c7-2417-2a8e1698344d.png)
もう一目瞭然ですね。ブラウザ送信要求とほぼ同じになります。
違いは、次の1点ですね。
　ブラウザ**送信**要求の場合、Agent/HULFT定義->HULFT**要求受付**ポートNo.
　ブラウザ**配信**要求の場合、Agent/HULFT定義->HULFT**集信**ポートNO.

##### 4.3. アカウントとファイルIDの紐付け（ブラウザ転送設定グループ）
**ブラウザ転送グループ**は、要するに **アカウントと扱えるファイルIDの紐付けをしているだけ** です。Webブラウザ方式では、利用者側にはI/F識別子として**転送設定ID**を見せるので、利用者に扱いやすいID体系を考えるよ良いでしょう。（HULFTのファイルIDは、どちらかというとシステム管理者にとって管理しやすいID体系を意識したものが多いかと思います。）
![044_MC_ブラウザ転送設定グループ.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/83b00305-2b86-32fa-fe4b-624b50013df2.png)

### HULFTの設定
Webブラウザ方式では、管理者側のみHULFTが導入されているので、片側のみの設定になります。
Webブラウザ側からみて、ダウンロードのとき、アップロードのときについてのHULFT設定ポイントを簡単に解説します。

#### HULFT設定のサマリ
##### 1. ダウンロード（配信）を行う場合
|管理情報|設定内容|
|:-|:-|
|配信管理情報|通常の配信設定|
|転送グループ情報|必要|
|詳細ホスト情報（ホスト名）|**ブラウザ転送設定->ブラウザ送信要求**のConID_AgID_Host(*1)|
|詳細ホスト情報（PROXYサーバ名）|**Agent**のホスト名|
|詳細ホスト情報（PROXYポートNo.|**Agent**のagent.sender.port（agent.confに定義）の値|

*1
 ConID:Monegement Console->ブラウザ転送設定->ブラウザ送信要求->ブラウザ定義のコネクションID
 AgID:ブラウザ転送設定->ブラウザ送信要求->ブラウザ定義のAgent ID
 Host:**HWC-BROWSER（固定値）**

##### 2. アップロード（集信）を行う場合
|管理情報|設定内容|
|:-|:-|
|集信管理情報|通常の集信設定|
|転送グループ情報|-|
|詳細ホスト情報（ホスト名）|**HWC-BROWSER（固定値）**|
|詳細ホスト情報（PROXYサーバ名）|-|
|詳細ホスト情報（PROXYポートNo.|-|

:::note info
**設定のポイント**
設定の考え方は、[Agent方式](https://qiita.com/sugimon/items/071693e248014505c8f3)とほとんど同じです。
押さえておくポイントとして、Management Console（ブラウザ転送設定）のブラウザ定義の**コネクションID**＋**Agent ID**＋**ホスト名（HWC-BROWSER）** を意識することです。

:::

## 疎通の確認

### 1. Data Transfer Site
Webブラウザ方式の場合、**Data Transfer Site**にアクセスしてファイルの授受を行います。（以下URL）
https://service-ap.tokyo.webconnect.hulft.com/site/
操作方法は、Web画面に従うと違和感なく操作できると思います。Management Consoleのブラウザ転送設定の設定内容を合わせて確認するとわかりやすいと思います。

地域の指定は、日本国内からだと東京を選択します。
![045_DTS（ロケーション）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/6b1e3575-eeb5-5a36-101f-91bcd9150397.png)

ログイン認証は、Monegement Consoleで設定したメールアドレス、パスワードはパスワード設定依頼メールのURLからパスワード設定サイトで設定したものになります。
![046_DTS（ログイン）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/25e7cb92-1e12-4031-cb6c-7f5b97fdb74e.png)

ログインが成功するとメニュー画面が表示されます。ファイルの送信＝アップロード、ファイルの受診＝ダウンロードとなります。
![047_DTS（メニュー）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/ba51da0b-04ef-f966-e9dc-14b53f4edbef.png)


### 2. ダウンロード
参照ボタンから**転送設定ID**を指定してファイルを受信します。
![048_DTS（ファイル受信1）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/58b13601-4122-4113-88fb-ec00a8d26c34.png)
![049_DTS（ファイル受信2）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/f2d0eb73-c6ce-c859-dd65-6a411eceb118.png)
![050_DTS（ファイル受信3）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/e6df65cb-39f2-cafe-f047-8a09c015b61b.png)
![051_HULFT配信履歴.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/cca1ccb2-3cff-1a48-83b7-92fbba4cde33.png)


### 3. アップロード
参照ボタンから**転送設定ID**と**送信するファイル**を指定してファイルを送信します。
![052_DTS（ファイル送信1）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/44b68cb7-f29d-91c4-6153-f2b98dd79b53.png)
![053_DTS（ファイル送信2）.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/7788e028-66ce-3953-04e8-d6a3790a564d.png)
![054_HULFT集信履歴.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/b008c31c-31bf-8d2b-6c81-dbb3c25d77e5.png)


---
以上、Webブラウザ方式の設定手順はご理解いただけたでしょうか？

***
**HULFT-WebConnect 設定ガイド** は、全6回のシリーズで順次公開予定です。

1. [４つの転送方式の違い](https://qiita.com/sugimon/items/1492714fb668e9a0c910)
2. [Agent方式の設定ポイント](https://qiita.com/sugimon/items/071693e248014505c8f3)
3. [CLI方式の設定ポイント](https://qiita.com/sugimon/items/aed0713cf56dbd0de063)
4. **Webブラウザ方式の設定ポイント**（本記事）
5. [D-Client方式の設定ポイント](https://qiita.com/sugimon/items/adbb055ae1208ed8143c)
6. [その他設定上の考慮ポイント](https://qiita.com/sugimon/items/0ffa6838d24650e8461f)

次回は、D-Client方式について解説いたします。
***
本記事は、[HULFT-WebConnect V3 マニュアル](https://www.hulft.com/help/ja-jp/WebConnect-V3/index.htm)を参考にしています。