# 账号

> 修改或重置密码，配置两步验证和恢复码，并为 MCP 与自动化工具管理 API Key。

来源: https://www.widewired.com.cn/page/docs/account-security

## 修改密码

在控制台「账户 → 账号」输入当前密码和新密码。新密码长度为 8-72 个 UTF-8 字节。

保存后，下次登录使用新密码。更换身份验证器或手机前，先确认恢复码已妥善保存。

## 重置密码

在登录页打开找回入口：

1. 输入用户名和该账号绑定的手机号，请求 6 位重置码。
2. 输入重置码和新密码，完成重置。

重置码有效期为 30 分钟。提交请求后，页面始终显示相同结果；未收到短信时先核对用户名和手机号是否属于同一账号。

密码重置成功后，所有浏览器会话立即失效，需要重新登录。已注册设备使用独立的设备身份，不受影响。

## 两步验证

在「账户 → 账号」开启 TOTP 两步验证：

1. 启动绑定并使用身份验证器应用扫描二维码。
2. 输入应用生成的 6 位动态码。
3. 保存页面一次性显示的 10 个恢复码。

每个恢复码只能使用一次。建议将恢复码保存到与身份验证器所在设备分离的安全位置。

### 关闭两步验证

关闭两步验证要求在最近 5 分钟内完成当前身份验证器的动态码验证。超过时限后，控制台会要求重新验证。

### 重新生成恢复码

可以在账号安全设置中重新生成恢复码，旧恢复码随即作废；无需重新绑定两步验证。身份验证器应用和恢复码均不可用时，通过[联系我们](https://www.widewired.com.cn/page/contact)中的公开渠道联系支持。

## API Key

在「账户 → 账号 → API Key」为 MCP 或自动化工具创建独立密钥。指定名称、只读或管理权限，以及永不过期或 30、90、180、365 天有效期；每账号最多同时有 10 个有效密钥。创建和撤销时要求近期密码验证；已开启两步验证时必须使用当前动态码。代客登录不能读取或管理密钥。

完整密钥只在创建时显示一次，之后只能看到末 4 位提示。将它保存在可信应用的私密配置中，不要发送到对话里。列表可查看权限、到期时间、最近使用和撤销状态，所有有效密钥始终可见；较早历史被截断时会提示，过期或撤销记录在 90 天后清理；未撤销的永不过期密钥持续保留并计入有效密钥上限。

撤销后，使用该密钥的工具下次请求就会失去权限。修改或重置密码、封禁或删除账号、停用品牌或改绑客户品牌也会撤销有效密钥，解封或重新启用品牌不恢复旧密钥。已过期记录保留原结束状态。需要更换时先创建新密钥并更新工具配置，再撤销旧密钥。密钥只在当前站点有效。具体权限边界和配置示例见 [AI Agent 接入](https://www.widewired.com.cn/page/docs/agent)。

## 修改账号安全设置后

终端软件不保存账号密码。修改账号安全设置后：

- 修改密码或两步验证设置不会中断已加入网络的设备。
- 阻断或删除设备不会影响账号登录。

设备报告身份验证错误时，先检查审批状态、网络和错误码，再按对应说明处理。

## 故障速查

| 现象 | 检查与处理 |
| --- | --- |
| 未收到密码重置码 | 核对用户名及其绑定手机号；请求成功不代表账号一定存在 |
| TOTP 动态码持续失败 | 检查身份验证器所在设备的时间是否自动同步，再使用当前 6 位码 |
| 恢复码不可用 | 确认该码未使用且输入完整；每个恢复码只生效一次 |
| 无法关闭两步验证 | 重新完成密码或两步验证，确保认证时间在 5 分钟内 |
| 设备报鉴权错误 | 在控制台确认账号、网络和设备状态，按错误码处理，见[故障排查](https://www.widewired.com.cn/page/docs/troubleshooting) |
