という感じになります。
まずはCLIをクライアントPCへにインストールしていきます。

〜CLIのインストール〜

「https://github.com/box/boxcli/releases」にアクセスしてEXEをダウンロードします。
ここでは64bit版のEXEをダウンロード・インストールしていきます。








これでインストールは完了です。
実際にPowershellを起動してコマンドが実行出来るかを確認してみます。


バージョン情報とコマンドヘルプが表示されましたので、正常にインストールされていることがわかります。
これだけだとAPI自体は使用出来ないので、次にAPIの設定を実施していきます。

〜Box API利用設定〜

「https://app.box.com/developers/console」にアクセスし、管理者としてログインします。
「アプリの新規作成」よりAPI設定を実施していきます。
※「JWTを使用した設定」というサイトを参考に実施しました。


「カスタムアプリ」で設定します。


「サーバー認証(JWT使用)」を選択します。




これでカスタムアプリが作成されました。
引き続き作成したカスタムアプリの設定を実施していきます。
「アプリアクセスレベル」より「アプリ+Enterpriseアクセス」を選択します。


「高度な機能」より「as-userヘッダーを使用してAPI呼び出しを行う」を選択します。


「公開キーの追加と管理」より「公開/秘密キーペアを生成」を実行します。
jsonファイルがダウンロードされます。
※キーの情報が記載されているので、このjsonファイルの取り扱いには注意が必要です。





ここまでで設定は完了です。
後は「承認」処理を実施していきます。






ここで管理者宛にメールが来ているので、そちらからアプリの承認画面へ遷移していきます。
※もしくは「管理者コンソール」にアクセスして確認も可能です。





以上でAPIの利用設定は完了です！
では実際にBox APIを使用してみましょう！！

〜Box CLIの使用例〜

コマンド例については以下のサイトを参考にしました。
https://github.com/box/boxcli

Powershellを起動します。
まずはAPI接続準備のコマンドを実行します。
> box configure:environments:add PATH_TO_CONFIG_FILE


コマンド例にもあるように、ルートフォルダーを取得してみます。
> box folders:get 0


ただしデフォルトの状態だと接続しているユーザーがアプリのユーザーなので、そもそもルートフォルダに何もないという結果に。。。。(^_^;)


そこで登場するのが「switch-user」オプションです。
このオプションを入れることで、該当ユーザーのルートフォルダの中身を確認していきたいと思います！
まずは該当ユーザーのユーザーIDを調べるためのコマンドを実行します。
> box users -a

この「TESTユーザー01」のルートフォルダを調べたいと思います。
> box configure:environments:switch-user <ユーザーID> --as-user=user



ちゃんとフォルダが表示されましたね！！
※合計3つと表示されてますが、画面は見切れていて1つしか詳細はわからないと思います(^_^;)


最後に終了する際、念の為使用していたコンフィギュレーションを削除しておきます。
※削除しなければ、引き続きこの設定でCLIが接続・使用可能です。
> box configure:environments:delete default



Box CLIを接続・利用出来ることが確認出来たので、今回はこんなところで終わりたいと思います(^o^)

スポンサードリンク