配置 OneDrive 与 SharePoint 集成
本教程演示如何让用户在 OPL 数据空间中直接从 Microsoft OneDrive / SharePoint 选择文件。
你可能会配置两套集成
- OneDrive for Business / SharePoint
- Personal OneDrive(可选)
它们通常需要两套不同的 Azure App Registration。
Business / SharePoint 大致流程
- 在 Entra ID 中创建 App Registration
- 把它配置成 SPA
- 添加 Microsoft Graph 的委托权限
- 授予 admin consent
- 记录:
ONEDRIVE_CLIENT_ID_BUSINESSONEDRIVE_SHAREPOINT_TENANT_ID
- 配置:
ENABLE_ONEDRIVE_INTEGRATION=true
ONEDRIVE_CLIENT_ID_BUSINESS=...
ONEDRIVE_SHAREPOINT_TENANT_ID=...
ONEDRIVE_SHAREPOINT_URL=https://your-tenant.sharepoint.com
Personal OneDrive
为支持个人微软账号,需要再建一个支持 personal account 的 App Registration,然后记录:
ONEDRIVE_CLIENT_ID_PERSONAL=...
最后一步
即使设置了环境变量,仍需在 OPL 数据空间的管理员面板里打开对应 OneDrive 集成开关,并刷新页面。
常见问题
- 附件菜单里没看到 OneDrive:检查 admin toggle 与容器重启
- 登录弹窗没出现:浏览器拦截了 pop-up
- 目录打不开:检查 Azure 权限与 admin consent