Watson DiscoveryのBOXクロール方法

# 環境
Watson Discovery Premium on IBM Cloud（以下WD）
BOX

# 注意点
BOXの追加・更新された文書をWDに反映するには、BOXのアドミニストレータ権限でセットアップする必要がある
BOXのアカウントは2重認証を設定しておく必要がある
WDのBOXクロール設定では、クロール対象とするBOXのディレクトリを選択することができる
2021/05月時点、BOXにアップされたCSVの文書は、WDでは1行1文書としてクロールされるがCSVのヘッダーが認識されない（ContentMiningプロジェクトの場合WD側でファセットラベルを設定することはできる）

# マニュアル
Configuring IBM Cloud data sources
https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-sources#connectboxpublic

# BOXの作業
###1. BOXにログインしてDeveloper Consoleにアクセス
Developer Console
https://app.box.com/developers/console


###2. 「アプリの新規作成」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/51a5c5e1-27ab-8591-2050-94b9956cd235.png)

###3. 「カスタムアプリ」を選択
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/ee06539e-1d7d-6e99-700d-761bf2366368.png)

###4. 「サーバー認証(JWT使用)」を選択してアプリ名を入力し、「アプリの作成」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/b6679ba2-8120-cd92-e90c-0785459d2c4a.png)

###5. 「構成」タブの「アプリアクセスレベル」で「アプリ＋Enterpriseアクセス」を選択
BOXのアドミニストレータ権限がある場合にこの設定を選択

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/4c7cf261-28ad-c055-420f-51c6b60fd76d.png)

###6. 「構成」タブの「高度な機能」のオプションを選択
BOXのアドミニストレータ権限がある場合にこのオプションをふたつとも選択
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/e90911bd-96a8-42cc-fcc5-4e25d4f4b32c.png)

###6. 「構成」タブの「公開キーの追加と管理」の設定
「公開/秘密キーペアを生成」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/07a37cb0-6367-ad0a-fc79-93f1737b2f70.png)

2段階認証が求められるので、認証コードを入力
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/ac80d0d2-f602-4bae-d8e1-5247bb89a979.png)

JSONファイルをダウンロードする
これらの値をWDのBOXクローラー設定の時に使用する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/2819e1c1-6f66-c30e-6c9b-e4b71dade370.png)

###7. 「構成」タブの「変更を保存」をクリック

###8. 「承認」タブの「確認して送信」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/d3c8bcd8-d5b4-b4cb-6bc8-da9364ce21a3.png)

「アプリの説明」を入力して「送信」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/2f2c51ef-7c6e-f986-e6e3-de7bb673d853.png)

「承認ステータス」が表示される
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/df6216c9-b57c-2ddc-333c-6abea9283419.png)



###9. 承認リクエストのメールから承認処理を実施
以下のようなメールが届くので「アプリをレビュー」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/21e8b743-c917-66a0-770d-8f6051665a8a.png)
下記ページに遷移するので「承認」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/55f4e41e-e542-0498-ea8e-77ca11e041e4.png)

「承認」タブで「有効」になったこと確認できる
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/c20720cc-955b-cf23-c3d4-01b79c6257e8.png)


# WDの作業
###1. 管理画面からプロジェクトを作成

BOXを選択して「Next」をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/124b9dae-8a33-b7f9-dbf2-ce7eab486bd2.png)



###2. 接続先BOXの設定
BOXの作業手順　"6. 「構成」タブの「公開キーの追加と管理」の設定"　で入手した値を入力
「Privage Key」欄には"-----BEGIN ENCRYPTED PRIVATE KEY-----"から"-----END ENCRYPTED PRIVATE KEY-----\n"までの値を入力する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/915acb66-3466-8b15-f554-167670102e5a.png)

###3. 言語、クロール先ディレクトリを指定
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/248948/bfb4d987-b321-1976-5f9f-e2c02d3fedd9.png)

「Finish」をクリックするとクロールとインデクシング処理が開始する