借助 Microsoft® OneDrive® 连接器，您可以 使用链式命令 来管理 Microsoft OneDrive 或 SharePoint® 中的文件和文件夹。例如，使用此连接器，您可以：
- 复制、删除和搜索文件和文件夹
- 下载和上传文件
- 列出可用驱动器
注: 此连接器由 Workiva 构建，并连接到第三方系统。虽然我们的支持团队可以帮助您在工作区内配置此连接器，但我们无法对源自 Workiva 平台之外的任何问题进行故障排除或提供其他帮助。
先决条件
为了实现连接，连接器使用了 Microsoft Graph API。为了确保连接安全，连接器使用 OAuth 身份验证，通过在 Microsoft 应用程序注册门户 或 Azure® Active Directory® 注册的指定应用程序进行身份验证。
要设置连接器，您需要：
- 已在 Microsoft 应用程序注册门户或 Azure Active Directory 中注册的应用程序 。记录您的申请 ID
- Azure 应用程序的 OAuth 客户端 ID 和密钥
- Azure 应用程序的作用域，与连接器将执行的命令相适应。
- 要连接的驱动器的类型和 ID。
注：您可以使用微软的 Graph Explorer （外部链接）从 SharePoint 中检索这些信息。
- 项目重定向 URI：
Microsoft Azure for OneDrive 的示例设置
注册申请
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/zh-cn/account/ - 导航至 您的 Azure Active Directory服务
- 导航至 应用注册 在“管理”下，然后点击 新建注册
- 请输入所需 的应用程序名称 ，然后按 注册
配置应用程序身份验证
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/zh-cn/account/ - 导航至 您的 Azure Active Directory服务
- 导航至 应用注册 在管理 [] 下
- 导航至 身份验证 在更新后的管理面板
- 在“支持的帐户类型”下，选择“任何组织目录中的帐户（任何 Microsoft Entra ID 租户 - 多租户）” 。
- 在“添加平台”下选择 “ Web”。
- 在 重定向 URI 下方输入上方有效的回调 URL
- 请务必勾选 “支持的帐户类型”下的“多租户 ”复选框。
注意： 由于 OneDrive 连接器需要启用多租户选项，因此 Azure 管理员有责任确保应用程序已正确配置以符合安全合规性要求。如果正确使用 Azure 安全功能，此选项不会向所有人开放应用程序。以下是一些可以采取的额外步骤的建议。
- 查看 Microsoft 与 MultiTenant 设置相关的文档。
https://docs.microsoft.com/zh-cn/azure/active-directory/develop/single-and-multi-tenant-apps#best-practices-for-multi-tenant-apps - 在单个应用程序上启用安全性。
https://docs.microsoft.com/zh-cn/azure/active-directory/develop/howto-restrict-your-app-to-a-set-of-users#update-the-app-to-require-user-assignment - 分配/允许用户访问应用程序。
https://docs.microsoft.com/zh-cn/azure/active-directory/develop/howto-restrict-your-app-to-a-set-of-users#assign-the-app-to-users-and-groups
设置证书和密钥
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/zh-cn/account/ - 导航至 您的 Azure Active Directory服务
- 导航至 应用注册 在管理 [] 下
- 在更新后的“管理”面板下，导航至“证书”
- 在中间面板中点击 新建客户端密钥
- 在提供简要描述和到期日期后，将显示客户端密钥。需要妥善保管此文件，以便将其导入 Microsoft OneDrive 连接器。
设置 API 权限
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/zh-cn/account/ - 导航至 您的 Azure Active Directory服务
- 导航至 应用注册 在管理 [] 下
- 在更新后的“管理”面板下，导航至 “ API 权限 ”。
- 点击中间面板中的 添加权限
- 选择 Microsoft Graph 在 Microsoft APIs下
- 选择 委托权限 作为请求类型
- 您需要的权限列表如下：
User.Read、FILES 目录下的所有内容以及 OpenId.offline_access - 点击 授予管理员权限。
定义连接器所需的访问权限级别。Microsoft OneDrive 连接器支持 以下 作用域：
文件.读写.选定文件.读写.应用程序文件夹文件.读写.所有文件.读写文件.读取.选定文件.读取.所有文件.读取离线访问
至少需要 offline_access 作用域。
启用安全性
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/zh-cn/account/ - 导航至 您的 Azure Active Directory服务
- 点击 企业应用程序 在管理 [] 下
- 从列表中选择您的应用程序以开始编辑过程。如果您的应用默认未列出，请点击“管理”下的“所有应用”。
- 点击 属性 在管理 [] 下
- 在属性屏幕上，设置以下属性以允许使用上面创建的 API 访问权限：
-
是否允许用户登录？= 是
-
需要用户分配吗？= 是
-
（可选）用户可见？= 否
-
- 接下来，点击 “管理”下的“用户和组 ”。
- 通过标准的 Azure AD 流程，根据需要添加用户。这是获准使用 OneDrive 并拥有有效 Microsoft OneDrive 许可证的用户列表。
设置 Microsoft OneDrive 连接器
注： 要使连接器可在您组织的链中使用， 组织安全管理员首先需要在配置中启用它。
- 从 链构建器中，单击 连接，然后单击右上角的 创建 。
- 在 连接器连接下，选择 Microsoft OneDrive和默认的 CloudRunner。
- 在 基本信息下，输入唯一的名称和描述，以帮助识别连接器。
- 在 OAuth下，输入连接器的 Azure 应用程序的 OAuth 客户端 ID 和密钥。
- 要确定连接器的访问级别，请输入 Azure 应用程序的 身份验证范围。
- 至少需要
offline_access作用域。
- 至少需要
- 要授权连接和 OAuth 凭据，请单击 连接。
- 在 属性下，输入连接的详细信息：
摘要信息 详细信息 驱动类型 选择要连接的驱动器类型，例如驱动器、组、用户或站点。要连接到您自己的用户驱动器，请选择当前用户（我）。 驱动器类型 ID 输入要连接的驱动器的 ID，基于 驱动器类型。例如，如果 驱动器类型 为用户，则输入用户 ID；如果为站点，则输入站点 ID。 注：您可以使用微软的 Graph Explorer （外部链接）从 SharePoint 中检索这些信息。
- 选择要与连接一起使用的环境，然后单击 保存。
- 要测试连接， 创建并运行一个链 使用 连接器的 下载文件命令，并验证它是否返回有效输出。
疑难解答
如果连接到 Microsoft OneDrive 或 SharePoint 失败：
- 验证连接器的 Azure 应用程序 OAuth 凭据是否存在、是否正确、是否有效。OAuth 凭证有定义的过期日期，证书可能已经过期。如果是这种情况，您需要创建一个新证书，并在连接器中输入新的客户端密钥。有关创建新密钥的详细信息，请参阅 设置证书和密钥 。
- 检查连接器的驱动器类型和 ID 输入情况。您可以使用 Microsoft 的 Graph Explorer （外部链接）从 SharePoint 中检索这些信息。
- 验证项目的重定向 URI：