Box 身份验证

使用受支持的 OAuth 2.0 身份验证方法将 UiPath 连接到 Box，并在 Box 应用程序中配置所需的回调 URI。

UiPath 支持 Box 的以下身份验证类型。有关更多信息，请参阅Box 身份验证文档。

身份验证类型	描述	理想适用于
OAuth 2.0 授权代码	用户通过 Box 登录并授予 API 访问权限。	个人用户访问权限（Attended 或个人自动化）。
OAuth 2.0 客户端凭据	非交互式服务到服务身份验证。	用户工作区中的服务到服务访问。
自带您自己的 OAuth 2.0 应用程序	将您自己的 OAuth 应用程序与 UiPath 的回调 URL 结合使用。	管理自己的 Box 应用程序和密钥的客户。
个人访问令牌 (PAT)	使用 Box JWT 私钥和企业/用户 ID。	企业级服务器到服务器集成，需要仅访问权限或企业范围内的访问权限，而无需用户交互。

身份验证类型详细信息

OAuth 2.0 授权代码

字段	描述
OAuth API 密钥	Box客户端 ID 。
OAuth API 密码	Box客户端密码。
范围	选择 Box 应用程序中配置的作用域。

OAuth 2.0 客户端凭据

字段	描述
OAuth API 密钥	Box 客户端 ID。
OAuth API 密码	Box 客户端密码。
主题类型	"Enterprise" 或者 "User"
企业 ID/用户 ID	Box 企业 ID 或 Box 用户 ID。
范围	必须匹配 Box 中配置的作用域。

自带您自己的 OAuth 2.0 应用程序

字段	描述
OAuth API 密钥	Box 客户端 ID。
OAuth API 密码	Box 客户端密码。
范围	预定义或自定义 Box 作用域。

重要提示：

在您的 Box 应用程序中配置此重定向 URI： https://{baseURL}/provisioning_/callback （例如https://cloud.uipath.com/provisioning_/callback ）。

个人访问令牌 (PAT)

字段	描述
OAuth API 密钥	Box客户端 ID （来自 Box 开发者控制台）。
OAuth API 密码	Box客户端密码。
范围	在 Box 中选择的自动化所需的作用域。
JWT 受众	示例： https://api.box.com/oauth2/token
JWT Base64 编码密钥	JWT 应用程序配置中的 Box 应用程序Base64 编码私钥。
JWT 颁发者	用作 JWT iss声明的 Box 应用程序客户端 ID 。
JWT 子类型	根据所需的模拟目标，必须是企业或用户。
JWT 主题	企业 ID （如果子类型=企业）或用户 ID （如果子类型=用户）。

创建 Box 应用程序

在将 UiPath 连接到 Box 之前，您必须在Box 开发者控制台中创建一个应用程序。有关更多信息，请参阅 《 Box 开发者文档》 。

1. 打开开发者控制台
2. 选择“创建新应用程序”
3. 根据您想要的身份验证类型，选择以下选项之一：
   • OAuth 2.0（用户身份验证） → 用于授权代码和 BYO OAuth
   • 具有客户端凭据的 OAuth 2.0 → 用于客户端凭据流程
   • 结合 JWT 的 OAuth 2.0 → 用于 UiPath IS 中的 PAT

创建 Box 应用程序后，收集：

• 客户端 ID
• 客户端密码
• 应用程序作用域
• 私钥（仅限 JWT 应用程序）
• 企业/用户 ID

重要提示：

对于自带您自己的 OAuth 2.0 应用程序，请将 UiPath 回调 URL 添加到您的 Box 应用程序： https://{baseURL}/provisioning_/callback （例如https://cloud.uipath.com/provisioning_/callback ）。

了解 Box 作用域

Box 需要显式权限选择，称为“作用域”。下表列出了 Box 应用程序的常见预定义作用域。

范围	描述
根_只读	对用户/帐户可以访问的所有内容的只读访问权限。
根_读写	对文件和文件夹的完全读取/写入访问权限。
管理_组	“管理 Box”组。
管理_企业_属性	管理企业元数据和属性。
管理_数据_保留	配置保留策略和合法保留。
Sign_requests.readwrite	创建和管理 Box Sign 请求。
管理_应用_用户	管理应用程序用户。
管理_托管_用户	管理企业版托管用户。

Box 开发者控制台必须反映您在创建连接时选择的相同作用域。有关作用域的更多详细信息，请参阅 Box 文档中的作用域。

如何准备 Box 私钥

步骤 1 — 下载私钥

下载包含“encrypted_private_key”和“密码短语”的 Box 应用程序 JSON 文件。

步骤 2 — 使用密码解密

如果密钥已加密，则将其解密：

openssl pkcs8 -topk8 -inform PEM -outform DER -in private_key.pem -out private_key_pkcs8.der -nocrypt -passin pass:YOUR_PASSPHRASE

这将产生以下内容：

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

步骤 3 — 删除 PEM 页眉/页脚

完全删除以下两行：

-----BEGIN PRIVATE KEY-----
-----END PRIVATE KEY-----

步骤 4 — 删除所有新行和空格

使密钥为单个连续行，没有空格或换行符。

结果示例： MIIG/wIBADANBgkqhkiG9w0BAQEFAASCBK...

步骤 5 — 对清理的密钥进行 Base64 编码

对单行密钥进行编码：

Linux/macOS： echo -n "CLEANED_KEY" | base64

PowerShell: [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("CLEANED_KEY"))

将生成的 Base64 输出粘贴至： JWT Base64 编码密钥。有关更多信息，请参阅Box 身份验证文档。