Boxへの接続

Box は、セキュアなクラウドベースのファイル共有・コラボレーションプラットフォームで、いつでも、どこでも、どんなデバイスでも、チームがリアルタイムでドキュメントを作成、編集、管理できるようにします。

Boxと IBM watsonx Orchestrate を統合するには、両システムがシームレスに通信できるセキュアな接続を確立する必要があります。 統合の管理に関する一般的なガイダンスについては、 「接続の管理」 を参照してください。

重要： デフォルトでは、シングルサインオン（SSO）はアプリで無効になっています。 有効にするには、 「アプリケーションのシングルサインオン設定」を参照してください。

ボックスへの接続 OAuth2

watsonx Orchestrate を Box に接続する：

  1. メインメニューから「 管理」 >「 接続 」と進みます。

  2. Boxを検索し、接続IDを見つける： box_oauth2_auth_code_ibm_184bdbd3

  3. 一致する接続IDの横にあるeditをクリックします。

  4. 接続を作成する環境を選択します：

    • 草案：テスト・開発用
    • ライブ：生産用

  5. 認証タイプとして 「 Oauth2 認証コード」 を選択してください。

  6. 以下の値を指定します。

    キー 説明
    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 Authorization API ドキュメントを参照してください。

  7. 適切な認証情報の種類を選択してください。

  8. Save をクリックして設定を完了します。

注記: アイコン は接続が正常に確立 A サポートが表示されます されたことを示します。

キー・バリュー・ペアを使用したボックスへの接続

watsonx Orchestrate を Box に接続する：

注： 2025年9月以前にデプロイされたエージェントについては、Box統合用に既存の接続タイプを引き続き使用してください。 2025年9月以降に作成されたエージェントについては、Boxの認証方法として OAuth2 サポートされるのはのみです。

  1. メインメニューから「 管理」 >「 接続 」と進みます。

  2. Boxを検索し、接続IDを見つける： box_key_value_ibm_184bdbd3

  3. 一致する接続IDの横にあるeditをクリックします。

  4. 接続を作成する環境を選択します：

    • 草案：テスト・開発用
    • ライブ：生産用

  5. Authentication Typeを Key Value Pairに設定する。

  6. 以下のキーとそれぞれの値を追加する。 Add new fieldをクリックして、それぞれのペアを入力する：

    キー 説明
    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 ドキュメントを参照してください。

  7. 認証情報の種類を選択してください。

    注： キーと値のペア認証タイプを使用してアプリを接続する場合、サポートされるのはチーム認証情報のみです。

  8. Save をクリックして設定を完了します。