社交登录

社交登录让用户以已有的第三方账号（Google、Microsoft、Apple、微信）或电子邮件验证码登录 Weincloud，无需另外记住一组密码。除登录本身之外，社交身份还提供两项仅社交登录用户才有的能力：以同一组社交身份管理并切换多个 Weincloud 账号，以及配置 Webhook 与 HMI 订阅，把 HMI 的报警事件推送到外部系统。

本章说明社交身份的创建、与 Weincloud 账号的关联与解除、多账号切换、外部通知配置，以及会话与社交登录信息的管理。若要处理的是单个账号的社交关联状态（在〔账户设置〕页面关联或解除关联），详见账号设置－社交账号。

功能概述

社交登录解决三个问题：

• 免密码登录：以第三方账号完成身份验证，降低密码管理与泄露风险。
• 多账号集中管理：同一个人常同时拥有多个 Weincloud 账号（例如不同 Domain 的运维账号）。关联到同一组社交身份后，可在登录后直接切换，无需反复退出再登录。
• 报警外送：以社交身份创建 Webhook 并订阅 HMI，把 HMI 的事件通知转发到自有系统或通信软件。

支持的登录方式

可用的提供方由服务器区域决定：

服务器	可用提供方
全球服务器	Email、Google、Microsoft、Apple
中国服务器	Email、微信（WeChat）

选择 Email 时，系统以发送一次性验证码的方式完成验证，无需第三方平台账号。

社交身份与 Weincloud 账号的对应关系

理解这组对应关系，是理解本章所有操作的前提：

• 一组社交身份可以关联多个 Weincloud 账号。〔社交用户〕页面列出的就是这份清单。
• 一个 Weincloud 账号同时只能关联一组社交身份。需更换提供方时，须先解除关联再重新关联。
• 登录时先以社交身份完成验证，再从已关联的清单中选择要进入哪一个 Weincloud 账号。

因此「解除关联」与「删除社交登录」的影响范围不同：前者只影响单个 Weincloud 账号，后者影响该社交身份下的所有账号。详见常见问题。

适用对象与使用场景

使用场景	适用对象	对应章节
第一次使用 Weincloud，想直接用社交账号开通	新用户	首次登录与账号创建
已有 Weincloud 账号，想改用社交账号登录	已有用户	关联更多 Weincloud 账号
同时运维多个 Domain，需要频繁切换账号	系统集成商、多厂区运维人员	切换 Weincloud 账号
要把 HMI 报警送到自有系统、LINE 或 Telegram	系统集成商、IT 人员	外部通知
要检查自己的登录记录或强制退出其他设备	所有社交登录用户	会话管理

〔社交设置〕分组下的功能仅对社交登录用户开放。以普通账号密码登录时，菜单不会出现这些项目；若直接以网址进入，页面会显示「此页面仅适用于社交登录账号。」。

社交登录用户的操作权限，完全等同于当前登录的那个 Weincloud 账号的权限，社交身份本身不带任何额外权限。

功能位置

社交登录相关功能集中在左侧菜单的〔社交设置〕分组：

菜单项目	用途
〔社交用户〕	查看已关联的 Weincloud 账号清单，并执行关联与解除关联
〔报警通知〕	管理 Webhook 与 HMI 订阅，配置外部通知
〔社交账号设置〕	查看社交账号信息、管理会话、删除社交登录

账号切换与〔账户设置〕入口位于左侧菜单底部的用户区块。

首次登录与账号创建

在登录页面选择社交提供方并完成授权后，系统会根据该社交身份当前的关联状态，提供下列选项：

• 创建新的 Weincloud 账号：Weincloud 自动生成一组 Domain 名称供你使用。此名称可在事后修改一次，详见更改 Domain 名称。
• 关联已有的 Weincloud 账号：输入已有账号的 Domain、用户名与密码，完成关联后即可用社交账号登录该账号。
• 选择已关联的账号：若该社交身份已关联过 Weincloud 账号，直接从清单选择要进入的账号。

授权流程进行中请勿刷新页面或使用浏览器后退，否则须回到登录页重新执行。相关错误消息与处置见故障排除－社交登录问题。

关联更多 Weincloud 账号

把其他 Weincloud 账号关联到当前的社交身份，之后即可用同一组社交账号登录并切换。

前置条件：需知道目标账号的 Domain、用户名与密码；且该账号尚未关联其他社交身份。

操作步骤

1. 左侧菜单选择〔社交用户〕。
2. 点击右上角〔关联 Domain 用户〕。
3. 依次输入〔Domain〕、〔名称〕与〔密码〕，提交。

结果

• 系统验证通过且无需额外确认时，该账号立即出现在清单中。
• 系统要求电子邮件确认时，页面显示「验证邮件已发送」。请到该账号注册的电子邮件邮箱点击确认链接；确认页面显示「电子邮件已确认」即代表关联完成。确认链接有有效期限，过期会显示「链接已过期」，此时请重新执行关联流程。
• 若该账号已启用多因素验证（MFA），系统会另外发送确认邮件要求二次确认。

清单中每一行显示该账号的〔Domain〕、〔名称〕与〔关联时间〕，并支持搜索、排序与分页。

切换 Weincloud 账号

前置条件：当前的社交身份已关联两个以上的 Weincloud 账号。仅关联一个账号时，切换入口不会显示。

操作步骤

1. 点击左侧菜单底部的用户区块。
2. 点击用户信息右侧的切换账号图标。
3. 从清单中选择要进入的 Weincloud 账号并确认。

切换完成后会停留在原本的页面，以新账号的权限重新加载。

此对话框只列出已关联的账号，不提供创建新账号或关联新账号的入口。要新增关联请改用关联更多 Weincloud 账号。

解除关联

解除关联是把单个 Weincloud 账号与社交身份之间的关联移除。社交身份本身与其他账号的关联都不受影响。

有两个入口，效果相同：

从〔社交用户〕页面解除

1. 左侧菜单选择〔社交用户〕。
2. 在要解除的账号那一行点击〔解除关联〕。当前登录中的账号那一行不会显示此按钮。
3. 对话框要求以同一个社交提供方重新登录验证身份。验证账号与关联账号不符时会显示错误，须重新验证。
4. 验证成功后确认警示消息，点击〔删除〕完成。

从〔账户设置〕页面解除

点击左侧菜单底部的用户区块，选择〔账户设置〕，在〔社交账号〕区块点击〔解除关联〕。详细步骤见账号设置－解除社交账号关联。

解除关联无法恢复。解除后该 Weincloud 账号回复为以账号密码登录，可再重新关联同一组或另一组社交身份。

更改 Domain 名称

适用于首次以社交登录创建 Weincloud 账号的用户。这类账号的 Domain 名称由系统自动生成，可修改一次。

1. 左侧菜单选择〔Domain〕，进入〔设置〕。

   

2. 找到〔名称〕项目，点击右侧〔编辑〕。

   

3. 输入新名称后提交即生效。

外部通知

外部通知让社交登录用户把 HMI 的事件报警推送到自定义的 HTTP 端点，用于对接自有系统、LINE 官方账号、Telegram Bot 或企业通知平台。

功能位于〔报警通知〕页面，分为两个选项卡：〔Webhooks〕定义推送到哪里，〔HMI 设备〕定义推送哪些设备的事件。两者需互相绑定才会实际发出通知。

Webhook 的请求格式、事件类型代码与 AWS Lambda／Cloudflare Workers 对接示例，详见通过 Webhook 接收推送通知。

Webhooks

创建 Webhook

1. 在〔报警通知〕页面切换到〔Webhooks〕选项卡，点击〔新增 Webhook〕。
2. 填写字段后点击〔创建〕。

字段／功能	说明
〔Webhook 名称〕	用于识别的名称，必填。
〔网址〕	接收通知的端点地址。以下拉菜单选择 HTTPS 或 HTTP，再填入其余网址；建议使用 HTTPS。必填。
〔API 密钥〕	选填但建议配置。Weincloud 发出请求时会带入此密钥，供接收端验证来源。
〔启用〕	控制此 Webhook 是否推送。列表以 On / Off 标示当前状态。

查看与维护

在列表中选择一条 Webhook，右侧详情面板提供两个选项卡：

• 〔Webhook 设置〕：点击〔编辑〕可修改名称、Endpoint URL、API 密钥与启用开关，修改后须点击〔保存〕。另提供〔测试〕按钮，立即向该端点发出一条测试通知以确认端点可连通；结果以「测试通知已成功发送」或「测试通知失败」提示。页面底部的危险区域提供删除。
• 〔已订阅的 HMI〕：显示此 Webhook 当前推送哪些 HMI 的事件，可点击〔新增 HMI〕从 Domain 的文件夹树中挑选，或以〔✕〕移除单条。

列表支持以名称或 Endpoint URL 搜索、按名称／Endpoint URL／创建时间排序，以及每页 10／20／50 条的分页。

订阅 HMI

〔HMI 设备〕选项卡列出当前已订阅通知的 HMI，字段包含〔HMI 名称〕、〔硬件密钥〕、创建时间与启用状态。

两种添加方式

• 〔新增 HMI〕：从当前 Domain 的文件夹树中勾选 HMI。已订阅的 HMI 会显示为已勾选且不可选取。一次最多选取 10 台，超过时会提示「一次最多可选择 10 台 HMI。」。此方式需要用户对该 HMI 具备 EasyAccess 2.0 管理权限。
• 〔扫描〕：以设备摄像头扫描 HMI 的二维码添加，可用于添加不同 Domain 的 HMI。扫描需授予浏览器摄像头访问权限；二维码内容无效时会提示错误并继续扫描。

绑定 Webhook 与移除

在列表中选择一台 HMI，右侧详情面板提供两个选项卡：

• 〔推送设置〕：显示〔HMI 名称〕与〔硬件密钥〕，并提供〔移除 HMI〕将此 HMI 从推送通知中移除。移除无法恢复。
• 〔Webhooks〕：显示此 HMI 当前绑定的 Webhook。点击〔选择 Webhooks〕从尚未绑定的清单中勾选，单次最多 10 条；以〔✕〕解除单条绑定。

每台 HMI 的通知开关与事件类型选项（Event Trigger、Event Recover、Event Online/Offline）的定义，见通过 Webhook 接收推送通知。

会话管理

用于查看当前社交身份的所有有效登录，并在必要时强制退出。

1. 左侧菜单选择〔社交账号设置〕。
2. 在〔安全性〕区块的〔会话管理〕点击〔管理〕。

对话框以表格列出每一个有效会话：

字段	说明
〔最后活动时间〕	该会话最后一次活动的时间。
〔IP〕	来源 IP 地址。点击旁边的定位图标可查询对应的地理位置。
〔操作系统〕	该会话所在设备的操作系统。
〔客户端〕	使用的浏览器或客户端程序。

当前使用中的会话以〔你〕标示，且不提供退出按钮；其余会话可单独点击电源图标退出。

点击〔退出全部〕会退出所有会话，包括当前这一个；执行后系统立即将你退出并跳转回登录页面，须重新登录。仅存在一个会话时此按钮不可用。

删除社交登录

删除社交登录会永久移除你在 Weincloud 上的社交登录信息，影响该社交身份下所有已关联的 Weincloud 账号。

1. 左侧菜单选择〔社交账号设置〕。
2. 在〔危险区域〕区块的〔删除社交登录〕点击〔删除〕。
3. 对话框要求以同一个社交提供方重新登录验证身份。
4. 验证成功后阅读警示消息，再次确认删除。

删除完成后系统立即将你退出并跳转回登录页面。此操作无法恢复。删除后各 Weincloud 账号仍可以原本的账号密码登录，也可重新关联社交账号。

限制与注意事项

• 一个 Weincloud 账号同时只能关联一组社交身份；要更换提供方须先解除关联。
• Domain 名称仅限首次以社交登录创建账号的用户修改，且仅能修改一次。
• 解除关联与删除社交登录都必须以原本使用的同一个社交提供方重新验证，且都无法恢复。
• 〔新增 HMI〕一次最多选取 10 台 HMI；每台 HMI 单次最多绑定 10 个 Webhook。
• 二维码扫描需要浏览器的摄像头访问权限，未授权时会显示「摄像头不可用」。
• 〔退出全部〕会连当前的会话一并退出。
• 社交登录用户的权限完全来自所登录的 Weincloud 账号，无法单独为社交身份配置权限。

常见问题

删除社交登录与解除关联有什么不同？

项目	解除关联	删除社交登录
影响范围	单个 Weincloud 账号	该社交身份下所有已关联的 Weincloud 账号
社交登录信息	保留，仍可用于其他已关联的账号	完全删除
执行后	该账号回复为账号密码登录	立即退出并跳转回登录页面

两者对后续使用 Weincloud 没有差异：受影响的账号仍可以账号密码登录，也可重新以 Email 或其他社交提供方关联。

为什么无法更改 Domain 名称？

只有首次以社交登录创建 Weincloud 账号的用户可以修改自动生成的 Domain 名称，且仅限一次。若已修改过而仍需变更，请联系 Weincloud 客户服务人员协助处理。

社交登录用户的权限如何决定？

权限完全由当前登录的那个 Weincloud 账号决定。调整该 Weincloud 账号的权限后，以社交身份登录时的权限也随之改变；社交身份本身不带任何独立权限配置。

为什么看不到〔社交设置〕菜单？

〔社交设置〕分组仅对社交登录用户显示。若你是以账号密码登录，请先在〔账户设置〕页面关联社交账号，之后改以社交账号登录即可看到；关联方式见账号设置－关联社交账号。