堡塔Microsoft OneDirve[已支持世纪互联OD] 备份插件使用向导

本文导读：

• 微软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 365  admin 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页面，请注意这并不是出现了错误。您只管复制跳转后的链接进行下一步操作即可。

复制地址参考：

1. 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

新版1.4，授权失败

新版本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 同时保留本地备份参考这篇帖子。

为了去除安全疑虑本插件未对跳转做任何处理？这类多余的安全疑虑，完全没有必要，请开发人员正确设置回调地址，提升插件的用户体验。
另外，用户设置不保留本地备份？？？谁设置的？？？我挺愿意同时保留本地备份的啊！

文件上传出现错误：
HTTPSConnectionPool(host=＇xxxx-my.sharepoint.com＇, port=443): Max retries exceeded with url: …… (Caused by ProtocolError(＇Connection aborted.＇, ConnectionResetError(104, ＇Connection reset by peer＇)))

Linxiao 发表于 2022-3-7 14:27
最近更新一下支持这种情况。

我现在最新版也有这种情况

purek 发表于 2022-2-27 01:19
您好，新买了美国服务器一直报错，同一个账户香港服务器正常，能麻烦看一下吗？
文件上传出现错误：
HTTPSC ...

我也有这种情况，弄了好久都搞不定

文件较大时会无法上传，目测大概大于15mb就会无法上传，建议降低拆分大小的门槛，将拆分门槛设置为拆分后单个文件大小

备份目录时，先将目录备份到系统盘，然后再打包上传？

已经尝试了N次了，都是同样的错误：获取授权失败

1. backup_database() got an unexpected keyword argument 'echo_id'

复制代码

一个很奇葩的问题求助，同一环境，同一账号，阿里云轻量服务器可以正常授权，腾讯云轻量服务器授权失败！

授权不了了

大家更新最新版本就可以用了

无法获取Onedrive1.8版本更新，面板版本为8.0.1

ImYrS 发表于 2023-8-17 17:42
请问如何处理的?

https://www.bt.cn/bbs/forum.php? ... 8231&pid=495423

照這個應該可以修好

宝塔用户_upmudy 发表于 2023-8-17 12:19
18c452c4-1946-4181-8ed0-2d81e9de5823預設的密鑰過期了，自己再建一個正常使用中

请问如何处理的?

软件崩了？？？？