在 Box 中创建定制应用程序

在创建与 Box 的连接之前，请在 Box Developer Console 中创建定制应用程序。 可以针对用户可用于共享文件的应用程序级别访问权创建应用程序，也可以针对对所有用户帐户的企业范围访问权创建应用程序。 通过企业范围的访问权，用户无需使用应用程序共享文件和文件夹。

1. 转至 Box Developer Console，并遵循向导以创建定制应用程序。 对于认证方法,选择 OAuth 2.0 with JWT (Server Authentication)。
2. 在配置页面中做出以下选择。 否则，保留缺省设置。
   1. 选择应用程序访问级别的两个选项之一：
      • 保留缺省 仅应用程序访问权 选项，以允许用户在其中共享文件的访问权。
        
      • 选择 应用程序 + 企业访问权 以创建具有对所有用户帐户的企业范围访问权的应用程序。
        
   2. 在添加和管理公用密钥下，单击生成公用/专用密钥对。 此选择需要在 Box 帐户上启用双因子认证，但之后您可以将其禁用。 生成的密钥对会生成一个配置文件 (*_config.json) 供您下载。 您将需要此文件中的信息以在项目中创建连接。
3. 如果您选择了应用程序 + 企业访问，请选中高级功能下的这两个复选框：
   • 使用 as-user 头进行 API 调用
   • 生成用户访问令牌
4. 向 Box 企业管理员提供应用程序客户机标识以获取授权：转至 Box Developer Console 中您的应用程序，然后从应用程序中的左侧侧边栏中选择常规链接。 向下滚动到应用程序授权部分。

解密私人密钥

要使用相关密码解密私人密钥，请运行以下命令。 此过程使用 "openssl pkcs8命令生成未加密版本的私钥。

openssl pkcs8 -in private_key.pem -passin file:pass.txt -out private_key_unencrypted.pem

使用的参数是

private_key.pem

由 Box 生成并提供给您的加密私人密钥。

pass.txt

该文件包含与私人密钥相关的密码，私人密钥由 Box 生成并提供给您。

private_key_unencrypted.pem

运行该命令后，输出文件将包含未加密的私钥。

根据您在平台中的位置选择创建连接的方法

在项目中

单击 资产> 新资产> 连接到数据源。 请参阅将连接添加到项目。

在目录中

单击 添加到目录> 连接。 请参阅将连接资产添加到目录中。

在部署空间中

单击 导入资产> 数据访问> 连接。 请参阅 向部署空间添加数据资产。

在平台资产目录中

单击新建连接。 请参阅添加平台连接。

创建 Box 连接

针对以下设置，输入所下载配置文件中的相应值：

• 客户机标识
• 客户机密钥
• 企业标识
• 专用密钥 (将每个 \n 替换为换行符)
• 专用密钥密码 (配置文件中的 passphrase 值)
• 公用密钥 (配置文件中的 publicKeyID 值)

企业范围的应用程序

如果您配置了企业级访问应用程序，请在用户名字段中输入 Box 用户帐户的用户名。

应用程序级别应用程序

用户必须显式地与应用程序的电子邮件地址共享其文件，以便应用程序能够访问这些文件。

1. 向连接发出 REST 调用以确定应用程序电子邮件地址。 例如：

   PUT https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}

   请求主体：

   {}
   

   返回：

   {
    "login_name": "[email protected]"
   }
   

2. 使用 REST 调用返回的登录名，共享您希望从watsonx.aiStudio 访问的 Box 中的文件和文件夹。

下一步：从连接添加数据资产

• 请参阅通过项目中的连接添加数据。

• 请参阅从目录中的连接添加数据。