データカタログにBoxへの接続を作成してみた。（2023年3月作成）


# Cloud Pak for Data as a Service ( CP4DaaS ) にBoxへの接続を作成してみた。
# 0.参考リンク
[こちらのリンク先](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn-box.html?context=wdp&audience=wdp)の内容を参考に、

SaaS版Cloud Pak for DataのデータカタログにBoxへの接続を登録してみました。

- 参考事項
    - [Cloud Pak for Data as a Service のサービス（無償のlite planで可）が利用可能](https://qiita.com/Shumpei_Kubo/items/993e0fabfaebf56fe547)な状態であること。
    - Boxにて二段階認証が設定済みであること。


# 1.Box 内での設定

- 前提事項
　 - Box環境の管理者権限を持っている必要があります。
　 - 筆者はBoxの認定SEとしてBox社から検証用環境を借用しており、以下内容では、その検証環境のBoxを使用しています。

## 1.1.開発者コンソール

## 1.1.1.カスタムアプリを作成

- Boxのホーム画面より、画面左下の「開発者コンソール」に移動します。
![スクリーンショット 2023-02-27 18.18.10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/2c80f252-1aea-13b9-bb74-7fdf8bce0c78.png)

---

- 「マイアプリ」タブから「アプリの新規作成」をクリックします。
![スクリーンショット 2023-02-27 18.20.58.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/2523da12-7cb0-9cc2-d005-a921bcaaa9c2.png)

---

- 「カスタムアプリ」をクリックします。
![スクリーンショット 2023-02-27 18.22.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/f746887e-f2c7-4085-a6cb-38260c9a20a1.png)

---

- 「サーバー認証（JWT使用）」を選択し、任意のアプリ名を入力して「アプリの作成」をクリックします。
- ここではアプリ名を、「Qiita-Box-WKC-DEMO」とします。

![スクリーンショット 2023-02-27 18.24.28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/0d731479-e7fd-5f46-a5b1-b141a967bbb0.png)

---

- 作成されました。
![スクリーンショット 2023-02-27 18.24.58.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/1ee72f83-f28a-986c-17bb-ec6170c78490.png)

## 1.1.2.カスタムアプリを設定

- 「構成」タブをクリックし、「アプリアクセスレベル」の項目では「アプリアクセスのみ」をクリックして選択します。
![スクリーンショット 2023-03-09 0.40.40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/ca44eb58-5754-d7ad-087b-b8b14ed72bd1.png)

---

- 画面を下方へスクロールし、「高度な機能」でのチェックボックスを2つともチェックします。
![スクリーンショット 2023-03-09 0.42.01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/208ef0e0-ed50-e62d-0bc2-09562b768bce.png)

## 1.1.3.公開/秘密キーペアを生成

- 「公開キーの追加と管理」の箇所で、「公開/秘密キーペアを生成」をクリックします。
![スクリーンショット 2023-03-09 0.43.18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/fbfd01d5-7896-9455-cca0-b502216d799e.png)

---
- 二段階認証画面に移行します。登録されている携帯電話にSMSで6桁のコードが表示されるので、それを画面に入力し、「送信」ボタンをクリックします。
![スクリーンショット 2023-03-09 0.47.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/a4034f1d-daac-848a-296a-7f1a4e69310c.png)

![スクリーンショット 2023-03-09 0.49.26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/477257fb-115b-9b1e-38cf-ee20c45fcd6a.png)


---
- 認証情報を保持したjsonファイルがダウンロードされます。
- （この画面ではFireFoxを使用していますが、ファイルが上手くダウンロードされない場合は、再度「公開/秘密キーペアを生成」をクリックするとダウンロードされます。
![スクリーンショット 2023-03-09 0.52.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/650c89dc-a525-ec30-6f33-9ad17a67d434.png)


---
- ダウンロードされたjsonファイルの内容を確認します。
- （検証したPCはMACですので、コマンドラインで確認しています）
![スクリーンショット 2023-03-09 0.53.57.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/4c793e10-6fc6-d90b-f697-900325aba1d9.png)

## 1.1.4.アプリの承認申請

- アプリの権限を管理者に対して申請します。
- 「承認」タブから「確認して送信」をクリックします。
![スクリーンショット 2023-03-09 0.57.09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/d5662466-5a8d-7a5c-ef9e-5d753646f1a9.png)



---
- アプリの説明を記載して「送信」をクリックします。
![スクリーンショット 2023-03-09 0.58.20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/2178bd97-3450-ba7a-09ed-450ec012fe0d.png)

![スクリーンショット 2023-03-09 0.58.48.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/bb77a625-c35a-d77c-9a17-4e4ee0437567.png)


---
- 画面左下の「マイアカウントへ戻る」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/d3ef8bec-4849-3d7c-3e26-d4ab11bb6271.png)


## 1.2.管理者コンソール

- マイアカウント右下から、管理者コンソールに入ります。
![スクリーンショット 2023-03-12 15.15.08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/a0bddfa4-266e-30d7-84e3-c17e050fa1b3.png)

![スクリーンショット 2023-03-12 15.15.35.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/7bc000bd-dea8-84d9-106f-5be7090bd76c.png)

- 「アプリ」→「カスタムアプリマネージャー」より、先程開発者コンソールにて申請したカスタムアプリを承認します。
![スクリーンショット 2023-03-12 15.16.50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/62e67173-5a5c-4dbd-0521-adda89b1c05e.png)

- 右端の「表示」をクリックします。
![スクリーンショット 2023-03-12 15.18.05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/aaf659b6-7841-89ef-fe6a-35e073b8ebb1.png)

- 画面右上の「承認」をクリックします。
![スクリーンショット 2023-03-12 15.19.31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/39451b6f-3e96-6021-b3bd-76b77daf65d6.png)


- 「承認」をクリックします。
![スクリーンショット 2023-03-12 15.19.54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/42011f36-61fc-1bce-cfde-5d731bd10f63.png)

- アプリが承認されました。
![スクリーンショット 2023-03-12 15.21.30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/8ea391fc-52e2-6ef2-1e33-fbe21d864aae.png)

- Box側での設定はこれで終わりです。続いて、CP4D側の設定に入ります。

# 1.3.登録用エクセルファイルを確認

- Box内のこのフォルダには、このようなエクセルファイルが格納されています。
![スクリーンショット 2023-03-12 17.06.42.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/f2f85fea-f308-ee29-ae96-8f107e6ebd59.png)

１シート目には「Customer Data EU_Shaped」というダミーの個人情報が記載されています。
![スクリーンショット 2023-03-12 17.08.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/01691d6b-4c16-5a1f-6af3-7e446401e6d6.png)

２シート目には「Customer Data US_Shaped」というダミーの個人情報が記載されています。
![スクリーンショット 2023-03-12 17.09.05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/e1359add-5d47-2ed8-c4fd-145b3dc49f6c.png)


# 2.CP4DaaS 内での設定

## 2.1.プラットフォームコネクションでBoxへの接続を作成

- 新規接続をクリックします。
![スクリーンショット 2023-03-12 15.30.06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/d7a50ab7-5c50-eb27-1ae4-acbe63862076.png)

- Boxを選択します。
![スクリーンショット 2023-03-12 15.31.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/c8ed0cec-845b-f513-681b-6cd213543d5a.png)


- 接続名称や説明を入力します。
![スクリーンショット 2023-03-12 15.31.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/bc2cd56c-754d-91f0-da27-2cd0d1898b35.png)

- jsonまたはBox側の管理画面から、クライアントIDをコピーします。
![スクリーンショット 2023-03-12 15.34.45.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/dadcd554-b4de-f667-600a-f8b2c5138997.png)


- 「資格情報」の「クライアントID」に貼り付けます。
- 
![スクリーンショット 2023-03-12 15.35.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/6a10ce0f-59d2-e010-a92b-428f40bd0121.png)


- 「企業ID」には、EnterpriseIDを入力します。
- 「秘密鍵」には、PrivateKeyを入力します。
    - （その際、元の文字列では改行コードが[バックスラッシュ][小文字のn]なので、その２文字が連なる箇所は改行します。）
- 「秘密鍵パスワード」には、Passphreseを入力します。
- 「公開鍵」にはpublicKeyIDを入力します。
![スクリーンショット 2023-03-12 15.57.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/39c70529-308e-3a9f-5d01-bb1b3456a106.png)


- 位置と主権、について、現時点（２０２３年３月）では正式リリースされていませんし、今回の接続についてはデータロケーションルールも使用しませんが、ひとまず操作だけしておきます。
- ロケーションの選択、をクリックします。
![スクリーンショット 2023-03-12 16.38.35.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/412ba4d7-c9a7-74bd-727f-3ef9d9e10f75.png)


- データセンターの位置として、ひとまず東京を選択します。
![スクリーンショット 2023-03-12 16.39.02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/45ae0cdd-7051-9730-5404-16699866c210.png)

- データの主権が「Japan」と表記されているので、「確認」をクリックします。
![スクリーンショット 2023-03-12 16.40.45.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/070a7b05-dde5-b5fe-b4d2-a78b967a17ad.png)

- 確認済みになりました。
![スクリーンショット 2023-03-12 16.40.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/829e53a8-fb39-e89b-5577-a23f5cd0cd3b.png)


- すべての情報が入力できた為、画面右上のボタンをクリックして接続を試します。
![スクリーンショット 2023-03-12 16.42.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/f9c09175-7cfa-f5b9-dabc-75760cb52efe.png)


- 接続に成功しました。
![スクリーンショット 2023-03-12 16.42.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/3d19f8c2-fd17-5b20-0e9a-dfdca58e8276.png)


- 画面右下の「作成」をクリックして接続を作成します。
![スクリーンショット 2023-03-12 16.48.25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/f7a1181f-17f1-c219-b7e1-5f501305b29d.png)

- Boxへの接続が作成されました。
![スクリーンショット 2023-03-12 16.53.41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/295123/31b2f2c0-ca9a-d942-8036-49a66b22c231.png)

# 2.後続作業
- 以下リンク先ご参照
    - https://qiita.com/Shumpei_Kubo/items/1eed67365ed70afd9320