これは、NTTテクノクロス Advent Calendar 2020 の9日目の記事です。
#1.はじめに
こんにちは、NTTテクノクロスの酒井です。
普段はDataSpider Cloudを利用するプロジェクトへの技術支援等を行っています。
今回はDataSpider Cloud環境とそれに付随するThunderbusを利用する機会があったので、これを使ってオンプレミス上のローカルPCに立てたHTTPサーバへGETリクエストを投げるまでの手順を書いてみようかと思います。
Thunderbusとは？
ThunderBusは、セゾン情報システムズ社の販売するソリューションの一つです。
Thunderbusの機能は、クラウド上からオンプレのファイル/webサーバに対してのセキュアなアクセス方法を提供するというものです。これを使う利点は、VPNの構築無しでオンプレとセキュアな通信ができるという所です。
クラウド上で動作する「Thunderbus Server」と、オンプレ側で動かす「Thunderbus Agent」から構成されており、
Thunderbus Agentは、Thunderbus Serverに対してHTTPS/WebSocket通信で接続を保持します。
この接続を通じてクラウド側からオンプレ側に対するアクセスを可能にします。
・DataSpider Cloudとの関係は？
そもそもDataSpider Cloudとは？という場合はこちら
DataSpider CloudのAdvanceライセンスを利用することで
DSC上からThunderbusを利用することができるようになります。
これを使用することでDSCで可能になるのは以下の３つです。
① DSC上のエクスプローラ上にオンプレPCのフォルダをマウントする。
② オンプレ側のサーバにHTTPリクエストを送信する。
③オンプレ側のデータベースサーバに SQL文(SELECT文）を発行し、検索結果をDSCで受け取る。
以下に概要図を示します。
#2.構築手順
##2.1 Thunderbus Serverのログイン・設定手順
###2.1.1 フロント画面からのThunderbus Server 設定作成手順
さて、まずはDataSpider Cloudにログインしましょう。
DataSpider Cloudログインページ
Thunderbusを利用するには、まずDSCのフロント画面上でThunderbusの設定を作成する必要があります。
フロント画面ログイン後、「連携サーバ管理」をクリックし、設定していくサーバを指定しましょう。
サーバの詳細情報画面が表示されます。
右側のリストから「Thunderbus」をクリックしてください。
Basic認証ID、Basic認証パスワード欄に任意の文字列を入力した後、「保存」ボタンをクリックします。
Thunderbusの設定が作成できました。
「BASIC認証ID」、「BASIC認証パスワード」「エンドポイント」の値はのちほど使うので、メモ帳などにメモしておきましょう。
###2.1.2.Thunderbus Server へのログイン・設定手順
Thunderbus Serverへのログインは、サーバ管理画面から行います。
前手順で作成したThunderbusの設定画面から、「管理画面」ボタンをクリックしましょう。
Thunderbus Serverの管理画面が表示されます。ログインID/パスワードを入力してログインしましょう。
ログインが成功すると、エージェント設定画面に遷移します。
ここで作成するのは、「Thunderbus Server」に接続してくる「Thunderbus Agent」の設定です。
画面中央に「＋新規作成」ボタンがありますので、これをクリックしましょう。
エージェント設定編集画面が開きます。
表示名、IDに任意の文字列を入力しましょう。
使用エージェント欄は、このエージェントに対して何が実行できるかを指定するものです。
今回はローカルPC上のwebサーバにHTTPリクエストを送信するので、「HTTPエージェント」にチェックをいれてください。
エージェントが一覧に表示されていれば成功です。
DSCからThunderbus Serverに接続するためのユーザを作成していきます。
画面上部の「ユーザ設定」をクリックした後、「＋新規作成」ボタンをクリックします。
ユーザ新規作成画面に遷移します。
ユーザ情報を入力し、前手順で作成したエージェントにチェックを入れたら「登録」ボタンをクリックしましょう。
##2.2.Thunderbus Agentのインストール・設定手順
###2.2.1.Thunderbus Agentのダウンロードとインストール
Thunderbus AgentのダウンロードはDSCのフロント画面から行います。
「連携サーバ管理」内のサーバ詳細画面から「Thunderbus」をクリックし、「インストール」ボタンをクリックします。
インストーラダウンロード画面が表示されます。
実行するPCのOSに合ったインストーラをダウンロードします。（今回は64bit版をダウンロードします。）
ダウンロードしたファイルをダブルクリックするとインストーラが立ち上がります。
「次へ」をクリックしていき、インストールを完了させてください。
###2.2.2.Thunderbus Agentの起動と設定
Thunderbus Agentをインストールすると、スタートメニューに登録されます。
「Thunderbus Agent for DataSpider」配下の「Thunderbus Agent」をクリックして起動しましょう。
Thunderbus Agentを起動すると、タスクバーにアイコンが表示されます。
アイコンを右クリックして、「管理画面」をクリックしましょう。
Thunderbus Agentの管理画面が開きます。
接続のための基本設定として、エンドポイント／エージェントID／BASIC認証ID／BASIC認証パスワードが必要になります。
DataSpider Cloudのフロント画面およびThunderbus Serverの設定画面から情報を取得し、設定しましょう。
【省略可】プロキシサーバを利用する場合は、「プロキシサーバーを使用する」にチェックを入れ、
「プロキシサーバ設定」リンクをクリックします。
利用しているプロキシサーバの設定を入力し、「保存」を押しましょう。
**【該当する場合のみ】**DataSpider Cloud上でIPアドレス許可設定を入れている場合は、
接続に使用するIPアドレスに対してThunderbusでの接続許可を入れる必要があります。
DSCのフロント画面から「IPアドレス許可設定」をクリックし、内容を確認しましょう。
Thunderbus Serverに接続します。
下図のカミナリ型のボタンをクリックすると接続が試行されます。
（成功した場合、カミナリが黄色に変化します。）
Thunderbus Agentからの接続が成功した場合、Server側の接続状態が「接続中」に変化します。
##2.3.（windows 10）webサービス（IIS）の有効化・初期設定
ThunderbusのHTTPエージェントの動作を確認するためには、
とにもかくにもローカル側にHTTPリクエストを受け付けるサーバが立っていなくては話になりません。
というわけで、windows上で動作するwebサービスであるIIS (Internet Information Service)を有効化していきます。
（ローカル側にアクセスできるHTTPサーバやDataSpiderServistaが構築してある場合、この手順は飛ばしていただいてかまいません。）
###2.3.1 IISの有効化
IISの有効化は、コントロールパネルから実行します。
コントロールパネルから「プログラムと機能」＞ 「windowsの機能の有効化または無効化」を選択します。
windowsの機能ページが表示されますので、下にスクロールしていくと「インターネットインフォメーションサービス」という項目があります。
これにチェックを入れて「OK」ボタンをクリックします。
これでIISの有効化ができました。
###2.3.2 IISの初期設定
IISの設定を確認していきましょう。
スタートメニューを右クリックして、「コンピューターの管理」をクリックしてください。
コンピューターの管理画面が開いたら、左のペインから「インターネット インフォメーション サービス（IIS）マネージャー」を選択し、詳細を開きます。
画面中央の「サイト」を選択すると現在の設定が表示されます。
ここの「パス」タブに書いてあるのが公開用のフォルダです。（デフォルトでは%SystemDrive%\inetpub\wwwrootが設定されています。）
公開用のフォルダ（上記「パス」で指定されたフォルダ）にHTMLファイルを配置します。
index.htmlという名前で保存しましょう。今回は動作確認なので、ファイルの中身は下図のようなもので構いません。
動作確認をしましょう。
ブラウザのアドレスバーに「http://localhost/」と打ち込んで以下のような画面が表示されればOKです。
##2.4. Thunderbus Server / Agent（HTTPエージェント）の設定追加
###2.4.1 Thunderbus Serverの設定追加
Thunderbus ServerにHTTPエージェントに接続設定を追加します。
DSCのフロント画面からThunderbus Server Consoleに移動してください。
エージェント設定画面が表示されるので、作成してあるエージェントの表示名をクリックします。
エージェント詳細画面が表示されます。
エージェント情報欄から「編集」をクリックしましょう。
エージェント情報編集画面が表示されます。
使用エージェントの「HTTPエージェント」にチェックを入れて「保存」ボタンをクリックしてください。
（注意：利用可能なHTTPエージェントのライセンスが無い場合、エージェント欄にチェックボックスが表示されません。）
###2.4.2 Thunderbus Agentの設定追加
Thunderbus Agentに設定を追加していきます。
オンプレ側のマシンにインストールされているThunderbus Agentを起動し、管理画面を立ち上げます。
「HTTPエージェント設定」タブから「＋」ボタンをクリックしましょう。
HTTPエージェント設定画面が開きます。
設定名（任意の文字列）とURL(2.3.2で作成したHTMLページのアドレス)を入力しましょう。
設定を入れたら「保存」ボタンをクリックします。
HTTPエージェント設定一覧画面に戻ります。
HTTPエージェント設定が追加されたことを確認しましょう。
##2.5. DSC上でのHTTPリクエスト実行
###2.5.1 HTTPリクエストのエンドポイント確認
DSCからThunderbusを通じてオンプレ側のHTTPサーバにリクエストを投げていきます。
これに必要となるエンドポイント(DSCからのHTTPリクエストの送信先)を確認していきましょう。
ThuderBus Agentを接続中にした状態でServer側の設定画面を表示させます。
エージェントの詳細画面が表示されます。
「エージェント設定 ＞ HTTPエージェント設定」欄にURLが記載されていますので、こちらをコピーしましょう。
###2.5.2 DSCでのグローバルリソース作成
DSCからThunderbusを通じてローカル側にHTTPリクエストを送るには、
2.5.1で確認したURLを通信先に指定したグローバルリソースを作成する必要があります。
DSCのWebstudioを起動して、「コントロールパネル」から「ファイル ＞ 新規グローバルリソースの作成」を選択しましょう。
新しいグローバルリソースの作成画面が表示されます。
「ネットワーク ＞ REST ＞ REST接続設定」を選択し「次へ」をクリックするとREST接続設定作成画面に遷移します。
「URL」欄に2.5.1で確認したThunderbus ServerのHTTPエージェントのURLを入力し、「完了」ボタンをクリックしましょう。
###2.5.3 DSCでのHTTPリクエスト送信スクリプト作成
GETリクエストを送信するスクリプトを作成していきます。
webstudioのデザイナから新規スクリプトを作成し、ツールパレットから「ネットワーク」選択してください。
カテゴリ内の「REST」フォルダから「GET実行」をドラッグしてスクリプト上に配置しましょう。
GET実行アイコンの設定は以下のようになります。
「必須設定」タブの「接続先」に作成したグローバルリソースを指定します。
「レスポンス設定」タブの「データ取得先」を「ファイル」にし、ファイルパスにDSCエクスプローラ上の任意のパスを指定します。
「認証設定」タブの「認証」欄を「ベーシック認証」とし、ユーザ/パスワードはThunderbus Serverのユーザ名を指定します。
設定が完了しましたので、スクリプトを実行していきます。
画面上のデバッグ実行ボタンをクリックするとスクリプトが実行されます。
実行後、「スクリプトの実行に成功しました。」というメッセージが表示されることを確認してください。
ローカル側のHTTPサーバから正常にレスポンスを取得できているかを確認しましょう。
スクリプトの出力対象に設定したファイルの中身を確認します。
下図のようにHTMLの内容が書き出されていれば、Thunderbusを通じてローカル側のHTTPサーバにアクセスできています。
※注意
DataSpider Cloudのバージョンアップなどにより、画面の一部が変更となっている場合があります。