本帖最后由 荣誉会员 于 2022-7-9 22:13 编辑
主要功能
- 支持开机自启动后台调用:使用简单方便,无需购买服务器部署,本地应用程序即开即用
- 两种可选的调用权限:用户未登录作为守护程序调用(需要客户端密码)、程序以登录用户身份直接调用(需要账户密码)
- 自动配置API权限:登录调用的API权限支持由程序自动配置
- API种类齐全:43个可选的Microsoft Graph REST API Beta中的API(未来可能会继续添加)
- 完全随机的API选用模式:从已选定的API序列中随机抽取一个或几个进行调用(个数和API随机)
- 完全随机的API调用顺序:每轮API的调用先后顺序随机
- 完全随机的API内容(仅部分API支持):POST写类型的API的上传内容随机
- 完全随机的API调用时间间隔:随机区段500s-86400s自定义
- 每日工作时间自定义:在日常工作时间进行调用,适用于从不关机重启的服务器设备
- 每周工作日自定义:在每周的工作日进行调用,适用于从不关机重启的服务器设备
- 运行智能暂停:防止因持续在错误配置下运行而导致的账户封禁
- 运行配置自动保存:可保存运行配置,无需反复设置
- 无限制账号个数:理论上允许无限制个数账号后台自动调用
- 支持自定义客户端密钥:允许非登录调用使用自定义密钥
- 自定义美化界面:支持自定义背景图片(半透明度以及毛玻璃效果)、亚克力背景
使用教程(请勿开启账号的双重验证功能)1 注册Azure应用程序
1.1 应用注册
1、点击登录 Azure或点击直接进入Azure应用注册,登录账号使用申请到的Microsoft 365 E5的管理员账户(账户名类似[email protected]格式)。
2、登录完成后点击右上角的“门户”按钮进入Azure管理中心,在搜索栏内输入“应用注册”,点击进入(若应用注册搜索不到请点击此处直接进入)。
3.单击“新注册”按钮
4.配置应用 应用名称随意写、注意可访问性选项选择最后一项、重定向URL暂时不填 、完成后点击注册
1.2 配置应用重定向URL(身份验证)1.先点击“概述”,然后点击“添加重定向URL”,进入重定向URL配置界面,下图中的应用程序(客户端)ID即为"客户端ID"。 2.点击“添加平台”,再点击“移动和桌面应用程序”, 3.继续勾选中第一个URL,最后点击底部的“配置”,该URL为“https://login.microsoftonline.com/common/oauth2/nativeclient”也可手动添加。 4.配置默认客户端类型将应用程序视为公共客户端 点击切换按钮为“是” ,最后点击“保存”按钮保存。
2 配置应用程序的API权限(重要)
小白提示:建议选择“委托的权限(用户登录)”该权限类型,调用API较多,操作步骤较少简单粗暴,调用成功几率高
注册的应用程序API权限类型有两种,其主要区别如下表所示: 权限类型 | | | 官方释义 | 应用程序必须以登录用户身份访问API | 应用程序在用户未登录的情况下作为后台服务或守护程序运行 | 需要的信息 | 账户名称+账户密码+应用程序(客户端)ID | 账户名称+客户端机密+应用程序(客户端)ID | 功能影响 | 程序中所有API均可调用 | 部分API权限受限无法调用(官方限制) | API权限配置 | 可由程序自动配置添加API权限 | 必须手动配置API权限 | 程序颜色标识 | 蓝色 | 深青色 |
根据所选的API权限类型在:2.1 选择“委托的权限(用户登录)”类型的API或者2.2 选择“应用程序权限(非用户登录)”类型的API中选择性阅读。
2.1 选择“委托的权限(用户登录)”类型的API
2.1.1 使用程序自动请求配置API权限
1.点击“添加账号”,API调用方式选择“登陆调用”,正确填写“MS365 E5账号”和“应用程序(客户端)ID”后点击“启动自动授权”。
2.在弹出的登陆页面中输入你的管理员账户名和密码登录(该账户必须为全局管理员账户且拥有该客户端ID的控制权限),登录成功时弹出“请求征得许可界面”,滚动到页面最底部勾选“代表组织同意”,最后点击“接受”。
3.判断是否添加API权限成功:首先程序提示授权成功,其次用管理员账户登录Azure查看应用的API权限,发现所有需求的权限全部添加或可以成功调用均视为已添加成功。
2.1.2 手动配置API权限
1.点击“API权限”-“添加权限”-“Microsoft Graph”
2.选择“委托的权限” 3.根据下方列出的API权限需求表来勾选所对应的API权限,全部选择完成后点击"添加权限"。 BookingsAppointment.ReadWrite.All
Calendars.Read
Contacts.Read
Directory.Read.All
Files.Read.All
Files.ReadWrite.All
Group.Read.All
Mail.Read
Mail.Send
MailboxSettings.Read
Notes.Read.All
People.Read.All
Presence.Read.All
Sites.Read.All
Tasks.ReadWrite
User.Read.All - BookingsAppointment.ReadWrite.All
- Calendars.Read
- Contacts.Read
- Directory.Read.All
- Files.Read.All
- Files.ReadWrite.All
- Group.Read.All
- Mail.Read
- Mail.Send
- MailboxSettings.Read
- Notes.Read.All
- People.Read.All
- Presence.Read.All
- Sites.Read.All
- Tasks.ReadWrite
- User.Read.All
复制代码
添加完成的效果如图
如果没有“代表XXX授予管理员同意”按钮 说明该账号不是管理员账号 换登管理员账号创建应用
4.最后点击代表XXX授予管理员同意,对话框选择“是”(该图包含了当前程序“委托的权限(用户登录)”全部API所需要的权限)。
2.2 选择“应用程序权限(非用户登录)”类型的API
2.2.1 手动配置API权限
1.点击“API权限”-“添加权限”-“Microsoft Graph”
2.选择“应用程序权限”
3.根据程序中列出的API权限需求表来勾选所对应的API权限,全部选择完成后点击"添加权限"。 Calendars.Read
Contacts.Read
Directory.Read.All
Files.Read.All
Files.ReadWrite.All
Mail.Read
Mail.Send
MailboxSettings.Read
Notes.Read.All
Sites.Read.All
User.Read.All - Calendars.Read
- Contacts.Read
- Directory.Read.All
- Files.Read.All
- Files.ReadWrite.All
- Mail.Read
- Mail.Send
- MailboxSettings.Read
- Notes.Read.All
- Sites.Read.All
- User.Read.All
复制代码
添加完成的效果如图
如果没有“代表XXX授予管理员同意”按钮 说明该账号不是管理员账号 换登管理员账号创建应用
4.最后点击代表XXX授予管理员同意,对话框选择“是”(该图包含了当前程序“应用程序权限(非用户登录)”全部API所需要的权限)。
2.2.2 创建客户端密码
1.点击“证书密码”-“新客户端密码”-“24个月”-“添加”
2.点击“值”该列中的“复制”(不要复制"ID"列中的值),并立即将该密码保存至电脑,保存的值即为“客户端密码”, 注:该值必须立即保存,退出该页面后将永远无法查看。
3 使用程序进行API调用创建一个新的E5子账户(可选步骤)
登入E5管理员账户进入管理员界面,创建一个新的子账户,使用这个子账户登录程序调用API。 为什么建议这样做:Microsoft 365 E5 Renew Plus中的部分API包含了写操作,例如Onedrive的API,这些API在随机模式下会生成大量垃圾邮件和文件(虽然单独为此设立了一个文件夹),部分人可能会对此行为非常介意,而且程序频繁的读写可能会对您正常使用账户造成影响,因此不建议使用管理员账户登录。
3.1 添加一个账户
点击“开始运行”-“添加账号”
这里可以切换API调用方式但也需要更改对应的填写内容
登录调用方式填写
非登录调用方式填写
最后点击确定
3.2 开始运行
点击“开始运行”
|