Box への接続

Boxは、安全でクラウドベースのファイル共有・コラボレーションプラットフォームであり、チームがいつでも、どこでも、どのデバイスからでも、リアルタイムでドキュメントの作成、編集、管理を行うことができます。

Boxを IBM watsonx Orchestrate と統合するには、両システムがシームレスに通信できる安全な接続を確立する必要があります。

注:

シングルサインオン（SSO）の切り替え機能は、サポートされている OAuth 2.0 の認証タイプおよびアプリケーションでのみ有効です。アプリケーションがSSO対応の認証タイプをサポートしていない場合、このトグルは無効のままとなります。サポートされている構成については、「アプリケーションのシングルサインオンの設定」を参照してください。

接続手順

Boxを watsonx Orchestrate に接続するには、以下の手順に従ってください：

メインメニューから、「管理」＞「 セキュリティ」の順に選択します。

重要:
オンプレミス環境では、 「管理」＞「接続 」のナビゲーションパスを使用して、接続にアクセスします。
[接続] タブをクリックし、アプリ名または Box 接続 ID を検索します。
該当する接続IDの横にある「編集」をクリックします。
組織で使用している認証方法を選択してください。
以下の「接続の詳細」の各セクションに記載されている、Box固有の接続詳細を入力してください。
ドラフトとライブ設定の手順を完了してください。
接続を保存し、Boxが正常に接続されていることを確認するためにテストしてください。

認証方式

Boxは、 watsonx Orchestrate において以下の認証方式をサポートしています：

OAuth2 認証コード ：本番環境での接続に推奨されます
キー値ペア（KVP） ：APIキーベースおよびレガシーシナリオでサポート

注:

2025年9月以降に作成されたエージェントについては、Boxでは OAuth2 認証コードのみがサポートされます。

接続 ID

接続設定ページでBox接続を検索する際は、以下の接続IDを使用してください。


認証タイプ	接続 ID
OAuth2 認証コード	`box_ibm_184bdbd3`
キーと値のペア (Key Value Pair)	`box_key_value_ibm_184bdbd3` (非推奨)

OAuth2 認証コード

組織で OAuth ベースの認証を使用している場合、 認証タイプを「 OAuth2 認証コード」 に設定し、以下のフィールドに入力してください：


フィールド	説明
`server_url`	Box APIサーバーの基本 URL
`authorization_url`	ユーザーがアクセス許可を承認するためにリダイレクトされる URL 例: `https://account.box.com/api/oauth2/authorize`
`token_url`	アクセストークンと認証コードを交換するために使用されるエンドポイント。例: `https://api.box.com/oauth2/token`
`client_id`	Box Developer ConsoleのBoxアプリのクライアントID
`client_secret`	Box Developer ConsoleからのBoxアプリのクライアントシークレット

これらの値を取得するには、 Boxの認証APIのドキュメントを参照してください。

キーと値のペア (Key Value Pair)

組織でAPIキーまたはレガシー設定を使用している場合、 認証タイプを 「 キーと値のペア」に設定し、「新しいフィールドを追加 」を使用して以下の各フィールドを追加してください：


キー	説明
`base_url`	Box API エンドポイントのベース URL
`token_url`	URL OAuth トークンを取得するために使用される。例: `https://api.box.com/oauth2/token`
`client_id`	BoxアプリケーションのクライアントID
`client_secret`	Boxアプリケーションのクライアント・シークレット
`subject_id`	アプリが代行するBoxユーザーまたは企業ID
`subject_type`	対象者のタイプ（ユーザーや企業など）

注：キー値ペアを使用する場合、チーム認証情報のみがサポートされます。

これらの値を取得するには、 Box Authorization API のドキュメントを参照してください。

次のタスク

アプリの接続が完了しましたので、 watsonx Orchestrate でご利用いただけます。

Orchestrate Chatでエージェントを実行し、自然言語を使用してタスクを完了させます。詳細については、「Orchestrate Chat の使用方法」をご覧ください。
適切なエージェントやツールを使用して、アプリ固有のアクションを実行します。詳細については、「事前構築済みエージェント」および「事前構築済みツール」を参照してください。