Box 身份验证

使用 OAuth 2.0 或其他支持的身份验证类型将 UiPath 连接到 Automation Suite 中的 Box，并在 Box 应用程序中配置所需的重定向 URI。

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

身份验证类型	描述	理想适用于
自带您自己的 OAuth 2.0 应用程序	将您自己的 OAuth 应用程序与 UiPath 的回调 URL 结合使用。	管理自己的 Box 应用程序和密钥的客户。
个人访问令牌 (PAT)	使用 Box JWT 私钥和企业/用户 ID。	企业级服务器到服务器集成，需要仅访问权限或企业范围内的访问权限，而无需用户交互。

身份验证类型详细信息

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

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

重要提示：

在您的 Box 应用程序中配置此重定向 URI： https://{yourDomain}/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
   • 结合 JWT 的 OAuth 2.0 → 用于 UiPath IS 中的 PAT

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

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

重要提示：

对于自带 OAuth 2.0 应用程序，请将 UiPath 的回调 URL 添加到您的 Box 应用程序： https://{yourDomain}/provisioning_/callback 。

了解 Box 作用域

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

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

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

如何准备 Box 私钥

步骤 1 — 下载私钥

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

步骤 2 — 使用密码解密

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

openssl pkcs8 -inform PEM -in private_key.pem -out decrypted_key.pem -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 身份验证文档。

添加 Box 连接

1. 从左侧栏中选择“Integration Service”。
2. 从“连接器”列表中，选择“Box”。您也可以使用搜索栏来缩小连接器的范围。
3. 选择“连接到 Box” 。
4. 您现在将定向到连接页面。
5. 输入所需的凭据。
6. Select Connect.

权限

应启用帐户以访问或连接到 Box。 否则，请联系您的管理员并请求必要的访问权限。

通过访问您的 Box 帐户，UiPath for Box 可以执行以下操作：

• 读取 Box 中存储的所有文件和文件夹
• 读取和写入 Box 中存储的所有文件和文件夹
• 管理组
• 管理企业属性
• 管理保留策略
• 启用集成
• 管理签名请求
• 管理应用程序用户
• 管理用户
• 生成可计费的 Box Sign 请求。

有关更多信息，请参阅Box 身份验证文档。