堡塔Microsoft OneDirve[已支持世纪互联OD] 备份插件使用向导
本帖最后由 Linxiao 于 2021-3-18 09:10 编辑本文导读：
[*]微软OneDrive备份插件简介
[*]微软OneDrive授权机制和插件权限说明
[*]授权向导
[*]使用微软OneDrive插件进行备份
[*]卸载和撤销授权
[*]使用反馈和解答
更新：
2021/3/18：v1.3 更新支持世纪互联运营的国内版:
切换账号在设置页的顶部复选框，不勾选默认是登录国际版OneDrive账号。如果你是国际版OneDrive用户可以不用管本次更新。
国内版OneDrive(世纪互联运营）版用户请注意看提示和授权链接的地址来判断账号切换状态，尤其多个账号的时候不要搞错了。
国内版OneDrive(世纪互联运营）简介：相对国际版OneDrive来说备份网络更加稳定、速度更快。
2020/9/16：更新支持Windows面板
一、微软OneDrive备份插件简介
微软OneDrive是微软Office办公套件中比较基础的一个产品，OneDrive为用户提供稳定可靠的文件云储存服务。堡塔OneDrive备份插件采用微软OneDrive官方API接口实现，致力为堡塔用户打通OneDrive这个可靠的备份工具，为您的数据再多一份保障。
堡塔现有云存储分类：
本插件支持OneDrive个人版/家庭版和商业版，所有堡塔面板用户都可以免费安装使用（暂时仅支持Linux面板，Windows面板后续更新）。
本插件的开发源自于堡塔用户对新增云存储的投票。
以下是Microsoft OneDrive备份插件功能支持情况：
支持情况(√/X) 支持情况(√/X)支持情况(√/X)
OneDrive版本 个人版/家庭版 √ 商业版 √世纪互联版 √
堡塔面板版本 Linux面板 √ Windows面板 √aaPanel X 计划中...
Python版本 Python3 √ Python2.7 √
商业版账号请确定在已在Microsoft 365admin center完成有关Microsoft 365应用的初始化向导，关于OneDrive点击这里了解更多
二、微软OneDrive授权机制和插件权限说明
微软OneDrive开放API使用OAuth2授权机制（授权码方式Authrization Code）对堡塔面板进行授权访问，此种授权方式需要用户在第一次使用插件的时候手动打开微软OneDrive的授权页，登录账号，并且点击同意授权后完成授权过程。整个授权过程是在微软官方站点操作，安全可靠。
在介绍授权过程之前，有必要先对授权权限进行说明，以免您对账户数据被删除或丢失感到担忧。
堡塔OneDrive插件需要的微软账号访问权限和说明如下：
权限 说明
Files.ReadWrite.All 对授权账号的所有文件进行读和写，备份必须
User.Read 读取当前授权用户名称，仅仅用于获取当前用户名
offline_access 保持对插件已授予的权限，也就是说第一次授权之后不需要再次授权
以上权限说明为了便于理解和微软官方在授权页的权限说明有所不同，实际以微软官方权限说明为准。如果您对OneDrive插件权限还有疑问欢迎留言。
三、授权向导
首先在堡塔面板的软件商店中搜索 OneDrive 关键词找到 微软OneDrive 备份插件，点击安装并打开。
点击 打开授权链接 按钮，在浏览器的新窗口打开授权页面。
在授权页完成Microsoft账号登录，如果没有账号请先申请。
阅读授权权限说明，确认无误后点击 是 代表同意堡塔OneDrive插件的访问授权。
个人/家庭版 权限说明：
商业版 权限说明（代表组织同意不是必选项）：
同意授权后，复制浏览器跳转的地址。
关于跳转404的说明：当同意授权后，微软官方会跳转到一个以 http://localhost/login/开头的本地链接地址上，链接后面的内容包含了单次授权的验证信息。为了去除安全疑虑本插件未对跳转做任何处理，您很可能看到的是一个404页面，请注意这并不是出现了错误。您只管复制跳转后的链接进行下一步操作即可。
复制地址参考：
http://localhost/login/authorized?code=M.R4_BAY.e57ba3d9-3c39-b820-3327-391a78e8d596&state=B3yKVnhiV41p0obLz8QXwpuV03h5pn
粘贴地址到验证的第三步文本框。
然后点击 获取授权 按钮，当你看到 设置 页显示您刚才登陆的用户名称代表授权已完成。
PS: 授权链接可以重复打开，同一个账号也可以重复授权多次。
文件列表：
四、使用微软OneDrive插件进行备份
点击堡塔面板 计划任务，新建 备份数据库 选择一个数据库，设置备份到 微软OneDrive，然后添加任务。
点击执行，并查看备份日志检查是否备份成功。
五、卸载和撤销授权
在插件被卸载后，已授权的授权文件会一并删除，至此插件也就失去了访问账号文件数据的条件。但是账号对插件的授权仍然保存在微软账号里面，想要彻底删除对插件的授权还需要登录到微软官方账号进行操作，并且个人/家庭版和商业版撤销方式有所不同。
个人/家庭账号访问以下网址：https://account.live.com/consent/Manage
点击编辑
个人/家庭版账户授权撤销完成。
商业版账号：待后续更新
六、使用反馈和解答
微软OneDrive插件使用说明就介绍到这里，此篇帖子同时也是插件使用反馈收集和解答的专用帖子，欢迎在下面留言，我会尽快做出解答。
宝塔用户_upmudy 发表于 2023-8-17 18:09
https://www.bt.cn/bbs/forum.php?mod=redirect&goto=findpost&ptid=118231&pid=495423
照這個應該可以 ...
感谢, 自己也找到办法了 因为宝塔面板，才下定决心支持office正版和买了OneDrive:victory: 新版1.4，授权失败 本帖最后由 Linxiao 于 2021-3-18 09:13 编辑
新版本1.3已支持世纪互联切换。旧版本可参考一下修改使用世纪互联版本备份，当然还是建议升级避免出错：
支持世纪互联 的 ,就是修改下配置文件就行了sharepoint都可以
替换插件目录下的credentials.json文件内容：
{
"client_id": "62e624a1-3ef5-4817-9b78-4553ce0c3c4c",
"client_secret": "-_wHwptT-dbDsON1R34uV.2TL22yvVOa5A",
"authority": "https://login.chinacloudapi.cn/common",
"token_endpoint": "/oauth2/v2.0/token",
"authorize_endpoint": "/oauth2/v2.0/authorize",
"scopes": "offline_access Files.ReadWrite.All User.Read",
"redirect_uri": "http://localhost/login/authorized",
"api_uri": "https://microsoftgraph.chinacloudapi.cn/v1.0"}
暮山 发表于 2020-9-12 20:52
为了去除安全疑虑本插件未对跳转做任何处理？这类多余的安全疑虑，完全没有必要，请开发人员正确设置回调地 ...
两个问题一一回答下：
1. 这里坚持的原则是宁可让用户看到最真实的空白页，也不让用户有半点不安全感。开始有设计过临时开启一个微型服务端来接收微软的回调跳转，但考虑到部分google云盘用户反馈的意见，所以没有这么做，后续会考虑加上来。
2. https://www.bt.cn/bbs/thread-51961-1-1.html 同时保留本地备份参考这篇帖子。 本帖最后由 暮山 于 2020-9-13 15:57 编辑
为了去除安全疑虑本插件未对跳转做任何处理？这类多余的安全疑虑，完全没有必要，请开发人员正确设置回调地址，提升插件的用户体验。
另外，用户设置不保留本地备份？？？谁设置的？？？我挺愿意同时保留本地备份的啊！
{:4_112:}爱了爱了，期待很久的插件了！！！这就去安装 zuantou 发表于 2020-9-10 12:29
爱了爱了，期待很久的插件了！！！这就去安装
感谢支持:lol 貌似上次投票你有参与{:2_31:} “为了去除安全疑虑本插件未对跳转做任何处理”？
那么可以允许用户在插件中配置由自己创建的Microsoft oAuth应用，而不是授权给“官方内置”的oAuth应用，设置错误的地址、不进行回调是完全没有必要的。 1499479666muky 发表于 2020-9-13 12:36
“为了去除安全疑虑本插件未对跳转做任何处理”？
那么可以允许用户在插件中配置由自己创建的Microsoft oAu ...
对，所谓的“为了安全”，不能成为插件不完善的借口。 请问后期是否有对世纪互联 国内版 onedrive支持的想法 ，目前主要使用国内版onedrive 虽然付费但是！速度很理想！希望支持！ 叼烟的声音 发表于 2020-9-13 14:55
请问后期是否有对世纪互联 国内版 onedrive支持的想法 ，目前主要使用国内版onedrive 虽然付费但是！速度很 ...
世纪互联国内版不是共用微软的一套账号吗？ 1499479666muky 发表于 2020-9-13 12:36
“为了去除安全疑虑本插件未对跳转做任何处理”？
那么可以允许用户在插件中配置由自己创建的Microsoft oAu ...
不是错误的地址，只是没有去主动接收授权成功后的跳转。目前相同授权机制的google插件就是没有做接收的。不过后续我会考虑加上的。:lol 阿里云服务器传这个还是不行，上传全部都是40KB 如何设置备份的时候保留本地备份（或者可以同时备份到多个渠道，不用单独手动每个都设置一次） 林 发表于 2020-9-17 02:04
如何设置备份的时候保留本地备份（或者可以同时备份到多个渠道，不用单独手动每个都设置一次） ...
https://www.bt.cn/bbs/thread-51961-1-1.html 同时保留本地备份参考这篇帖子，这个保留本地备份的设置是全局的。 暮山 发表于 2020-9-17 00:57
阿里云服务器传这个还是不行，上传全部都是40KB
具体日志提示什么？加一下我Q940950943 Linxiao 发表于 2020-9-17 16:51
https://www.bt.cn/bbs/thread-51961-1-1.html 同时保留本地备份参考这篇帖子，这个保留本地备份的设置是 ...
由于一天没找到原因，已经卸载了。建议你再测试一下，阿里云北京区域，上传到个人版 OneDrive。