连接到 Box

Box 是一个安全的基于云的文件共享与协作平台，支持团队随时随地、在任何设备上实时创建、编辑和管理文档。

要将 Box 与 IBM watsonx Orchestrate 集成，您需要建立一条安全的连接，以确保两个系统能够无缝通信。有关管理集成的通用指南，请参阅 “连接预构建代理的应用程序 ”。

重要说明：

默认情况下，您的应用已禁用单点登录（SSO）。要启用此功能，请参阅《配置应用程序的单点登录》。

连接步骤

请按照以下步骤将 Box 连接到 watsonx Orchestrate ：

Box 在 watsonx Orchestrate 中支持以下身份验证方法：

注：

对于 2025 年 9 月之后创建的代理， OAuth 2.0 是 Box 支持的唯一身份验证方式。

在“连接设置”页面查找您的Box连接时，请使用以下连接ID：要了解如何搜索连接 ID 并打开连接进行编辑，请参阅《连接预构建代理的应用程序》。


认证类型	连接标识
OAuth2 授权码	```box_oauth2_auth_code_ibm_184bdbd3```
键值对	```box_key_value_ibm_184bdbd3```

如果您的组织使用基于 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 开发人员控制台中的 Box 应用程序客户端 ID
`client_secret`	从 Box Developer Console 获取 Box 应用程序的客户端秘密

要获取这些值，请参阅 Box 授权 API 文档。

如果您的组织使用 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 授权 API 文档。