身份认证运维

一、插件简介

独立身份认证插件：支持个人、企业、站长及自定义认证类型。用户提交材料后管理员审核，通过后可颁发关联勋章。站长认证需通过域名 TXT/文件验证权属。支持并发认证数量限制、有效期与到期自动失效。

二、核心能力

三、依赖与安装

1. 将插件置于 plugins/verify/。
2. 在应用中心安装「身份认证」。
3. 安装时创建 verify_application 表、复制静态资源、注册菜单，并初始化默认认证类型。
4. 可选依赖：badge（通过后颁发勋章）；community（会员中心入口）。

四、应用中心基础配置

字段来自 VerifyPlugin::configSchema()：

认证类型（名称、模板、动态字段、关联勋章）在后台「身份认证」页的类型配置中维护，存于插件 types_json 配置，不在应用中心基础表单中。

五、后台重点配置

认证类型配置

入口：身份认证页标题栏「类型配置」按钮 → /admin/verify/types

类型管理接口：

申请审核

六、前台用户流程

1. 登录后进入会员中心 →「身份认证」或访问 /verify。
2. 查看可申请的认证类型（受「开放用户申请」「同时认证数量」限制）。
3. 站长认证：先填写网站域名 → 调用 prepare 获取验证文件信息 → 上传验证文件到域名根目录 → 提交申请。
4. 其他类型：填写动态表单（文本、图片等）→ 提交申请。
5. 在页面下方查看申请进度：待审、已通过、已驳回、已撤销、已过期。
6. 被驳回或撤销后可查看原因；支持提交申诉（appeal）。
7. 通过后展示认证信息；若配置了勋章且安装了 badge 插件，自动获得勋章。

前台路由

七、后台审核与运维

申请状态

八、特殊说明

• 插槽：member_nav_extra — 渲染「身份认证」Tab。
• 静态资源：static/verify.css、static/verify.js（安装时复制到 /static/verify/）。
• 数据表：verify_application — 含 form_data（动态表单 JSON）、域名验证字段、勋章关联、申诉字段。
• Cron：GET /verify/cron?key={cron_key} — 处理到期认证并回收勋章。
• 域名验证：DomainProveService 生成验证文件名与 token，用户需将 token 写入域名根目录指定文件。
• 类型存储：TypeConfigService 管理 types_json，安装时 ensureDefaults() 写入个人/企业/站长默认类型。

九、推荐上线清单

• 在后台配置所需认证类型与动态字段
• 设置「同时认证数量」与「认证有效天数」
• 若需颁发勋章，安装 badge 插件并在类型中关联勋章 ID
• 配置 cron_key 并设置定时访问 /verify/cron
• 测试个人认证完整流程（申请 → 审核 → 通过）
• 测试站长认证域名验证流程
• 确认会员中心 Tab 与静态资源加载正常

十、常见问题

Q：用户无法新申请？ 检查「启用身份认证」「开放用户申请」是否开启；是否已达「同时认证数量」上限；是否已有同类型进行中申请。

Q：站长认证域名验证失败？ 确认验证文件已上传到域名根目录且内容正确；域名需可公网访问。

Q：通过后勋章未颁发？ 确认 badge 插件已安装；类型配置中勋章 ID 有效；勋章状态为启用。

Q：认证到期后怎样？ status 变为已过期，关联勋章被回收；可通过 cron 或后台「处理过期」批量执行。

Q：类型配置在哪里？ 后台「身份认证」页面标题栏按钮，非应用中心。历史独立「认证类型」菜单已移除。

Q：申诉如何处理？ 用户在前台提交申诉后，管理员在后台「处理申诉」中审核。