借助 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。
注：您可以使用 Microsoft 的 Graph Explorer 从 SharePoint 中检索这些信息。
- 项目重定向 URI：
Microsoft Azure for OneDrive 的示例设置
注册申请
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/en-us/account/ - 导航至您的 Azure Active Directory 服务。
- 导航至“管理”下的 “应用注册 ” ，然后点击 “新注册” 。
- 请提供所需的 应用程序名称 ，然后按 注册。
配置应用程序身份验证
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/en-us/account/ - 导航至您的 Azure Active Directory 服务。
- 导航至“管理”下的 “应用注册 ” 。
- 在更新后的管理面板下，导航至 身份验证 。
- 在“支持的帐户类型”下，选择 任何组织目录中的帐户（任何 Microsoft Entra ID 租户 - 多租户）。
- 在“添加平台”下选择 Web。
- 在 重定向 URI 下输入上面有效的回调 URL。
- 请确保选中 支持的帐户类型 [] 下的 多租户 复选框。
注意： 由于 OneDrive 连接器需要启用多租户选项，因此 Azure 管理员有责任确保应用程序已正确配置以符合安全合规性要求。如果正确使用 Azure 安全功能，此选项不会向所有人开放应用程序。以下是一些可以采取的额外步骤的建议。
- 请查看 微软 提供的与多租户设置相关的文档。
- 按照 Microsoft 的说明 ，在单个应用程序上启用安全性，以将应用程序限制为一组用户。
- 按照 Microsoft关于将应用程序分配给用户和组的说明，分配/允许用户访问该应用程序。
设置证书和密钥
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/en-us/account/ - 导航至您的 Azure Active Directory 服务。
- 导航至 管理 [ 下的 ] 应用注册。
- 导航至更新后的 管理 面板下的 证书 。
- 点击中间面板中的 新建客户端密钥 。
- 在提供简短的 描述 和 到期日期后，将显示客户端密钥。需要妥善保存此文件，以便将其导入 Microsoft OneDrive 连接器。
设置 API 权限
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/en-us/account/ - 导航至您的 Azure Active Directory 服务。
- 导航至 管理 [ 下的 ] 应用注册。
- 导航至更新后的 管理 面板下的 API 权限 。
- 点击中间面板中的 添加权限。
- 在 Microsoft API 下选择 Microsoft Graph。
- 选择 委托权限 作为 请求类型。
- 您需要的权限列表中有：
User.Read、FILES 下的所有内容以及OpenId.offline_access。 - 点击 授予管理员同意。
- 定义连接器所需的访问权限级别。Microsoft OneDrive 连
接 器支持以下 作用域：文件.读写.已选择文件.读写.应用程序文件夹文件.读写.全部文件.读写文件.读取.已选文件读取全部文件读取离线访问
至少需要 offline_access 范围。
为什么需要 Files.Read.All 和 Files.ReadWrite.All
Workiva OneDrive 连接器通过 Microsoft Graph API 使用 OAuth 委托权限与您的 Microsoft 环境通信——这意味着连接器会进行身份验证并代表已验证的用户执行操作。
为什么 Sites.Selected 不能使用
Sites.Selected 是 SharePoint 特有的权限，专为应用程序级（仅限应用程序）访问流而设计；它与 Workiva 连接器使用的委派权限模型不兼容。它还限制了对仅预先批准的 SharePoint 站点的访问，这阻止了连接器执行动态的、基于路径的操作，例如搜索、复制项目和删除项目。
启用安全性
- 登录您的 Microsoft Azure 门户：
https://azure.microsoft.com/en-us/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。 注： 您可以使用 Microsoft 的 Graph Explorer 从 SharePoint 中检索这些信息。
- 选择要与连接一起使用的环境，然后单击 保存。
- 要测试连接， 创建并运行一个链 使用 连接器的 下载文件命令，并验证它是否返回有效输出。
故障排除
如果连接到 Microsoft OneDrive 或 SharePoint 失败：
- 验证连接器的 Azure 应用程序 OAuth 凭据是否存在、是否正确、是否有效。OAuth 凭证有定义的过期日期，证书可能已经过期。如果是这种情况，您需要创建一个新证书，并在连接器中输入新的客户端密钥。有关创
建新密钥的详细信息，请参阅设置证书和密钥 。 - 检查连接器的驱动器类型和 ID 输入情况。您可以使用 Microsoft 的 Graph Explorer 从 SharePoint 中检索这些信息。
- 验证项目的重定向 URI：