Zsens身份认证插件如何配置与使用说明？
一、插件简介
身份认证（verify）面向社区站点，支持用户按站点配置的认证类型提交资料，站长后台审核通过后可颁发勋章、设置有效期，并支持驳回申诉、撤销与到期失效。
适合个人实名、企业资质、站长域名权属等场景；认证类型与表单字段均可后台自定义，不必改代码。
前台入口：会员中心 → 身份认证（约 /verify）
后台入口：插件列表 → 身份认证
二、核心能力
| 能力 | 说明 |
|---|---|
| 可配置认证类型 | 名称、标识、模板、提示语、排序、启用/停用、通过后勋章 |
| 动态条件字段 | 单行文本、手机、网址、多行文本、上传图片、域名文件验证 |
| 申请与审核 | 用户提交 → 待审 → 通过/驳回；驳回可申诉 |
| 同时认证数量 | 限制用户同时持有的「待审 + 已通过」类型数（如设为 1 只能认证一种） |
| 站长域名验证 | 生成根目录 TXT 校验文件，系统拉取校验权属 |
| 勋章联动 | 依赖勋章插件；通过时颁发，撤销/过期时回收 |
| 有效期 | 可配置通过后 N 天过期；到期失效并通知 |
| 站内通知 | 通过、驳回、申诉结果、撤销、过期等会通知用户（消息插件） |
默认三种类型（可改可删可恢复）：
- 常规认证（个人模板）：姓名、身份证、手机、图片
- 企业认证：企业名称、营业执照、法人、手机
- 站长认证：网站名称、域名 + 根目录 TXT 文件验证
三、依赖与安装
建议环境：
- 已安装并启用 社区（community） 插件（前台布局、上传、会员入口）
- 需要发勋章时安装并启用 勋章（badge），并先建好勋章
- 需要站内通知时安装并启用 消息（message）
安装步骤：
- 应用中心安装并启用 身份认证
- 在插件配置中打开「启用身份认证」「开放用户申请」
- 进入 身份认证 管理页 → 右上角 认证类型，按需配置类型与勋章
- （可选）配置同时认证数量、有效天数、过期巡检密钥
四、应用中心基础配置
路径：应用中心 → 身份认证 → 配置
| 配置项 | 说明 | 建议 |
|---|---|---|
| 启用身份认证 | 总开关；关闭后前台不可用、入口隐藏 | 上线保持开启 |
| 开放用户申请 | 关闭后用户不能新申请，已有记录仍可看 | 临时停申时可关 |
| 同时认证数量 | 用户同时可有的「待审 + 已通过」类型数；1 = 只能一种；0 = 不限制 | 严格一证一户用 1 |
| 认证有效天数 | 通过后多少天过期；0 = 长期有效；到期回收勋章并通知 | 需定期复核时填天数 |
| Web 过期巡检密钥 | 访问 /verify/cron?key=密钥 批量处理到期；留空禁用该入口 | 与计划任务配合；也可后台点「处理过期」 |
认证类型不在应用中心表单里编辑，请到后台 身份认证 → 认证类型。
五、认证类型配置（重点）
路径：插件列表 → 身份认证 → 标题右侧 认证类型（旁有「返回上级」）
5.1 类型字段说明
| 项 | 说明 |
|---|---|
| 认证名称 | 前台展示名，如「常规认证」 |
| 认证标识 | 英文 key（如 normal）；保存后尽量勿改，以免历史数据对不上 |
| 认证模板 | 个人 / 企业 / 站长 / 自定义；切换可填充推荐字段，再自行增删改 |
| 排序 | 数字越小越靠前 |
| 启用 | 仅启用的类型会出现在前台申请 |
| 通过后勋章 | 下拉选勋章；「不颁发」则只改认证状态 |
| 申请提示 | 选中该类型时显示的说明文案 |
| 条件字段 | 用户需填写/上传的内容 |
5.2 条件字段类型
| 输入类型 | 用途 |
|---|---|
| 单行文本 | 姓名、企业名、身份证号等 |
| 手机号码 | 联系电话 |
| 网址 | 网站域名（站长认证常用） |
| 多行文本 | 补充说明 |
| 上传图片 | 证件照、营业执照等（走社区上传接口） |
| 域名文件验证 | 站长权属：生成 TXT → 传到网站根目录 → 提交时系统校验 |
每个字段可设：字段名、显示标签、是否必填。
5.3 操作建议
- 先在勋章插件建好「个人认证」「企业认证」等勋章
- 编辑对应类型，绑定勋章并启用
- 不需要的类型可停用，不必删除
- 「恢复默认三种」会重置为系统默认类型（自定义会被覆盖，慎用）
六、前台用户流程
- 登录后进入会员中心 → 身份认证
- 标题右侧切换认证类型（PC 在标题旁；小屏自适应换行）
- 按提示填写资料；含图片字段用「上传图片」按钮
- 站长类：先填域名 → 点「生成验证文件」→ 把 TXT 传到网站根目录 → 再提交
- 提交后在「我的申请」查看状态与时间
- 驳回后可申诉；申诉中不可重复申诉
- 同类型在「待审/已通过」时不可再申请；达到「同时认证数量」上限后也不能再申请其他类型
七、后台审核与运维
路径：插件列表 → 身份认证
| 操作 | 说明 |
|---|---|
| 搜索筛选 | 关键词、类型、状态、申诉状态 |
| 通过 | 写入通过状态；按类型颁发勋章；按「有效天数」写过期时间；通知用户 |
| 驳回 | 必须填写原因；用户可申诉 |
| 处理申诉 | 通过或驳回（驳回须填原因） |
| 撤销 | 仅已通过；须填原因；回收勋章并通知 |
| 处理过期 | 扫描到期记录，设为过期并回收勋章 |
| 删除 | 删除申请记录（慎用） |
含「域名文件验证」的类型：审核通过前会校验域名权属是否已通过。
八、站长域名验证说明
- 用户填写可访问的网站域名
- 系统生成类似
zs-site-verify-xxxxxxxx.txt的文件名与校验码 - 用户将文件放到 网站根目录（可访问
https://域名/文件名） - 提交时系统 HTTP 拉取文件，内容需包含校验码
- 验证通过后才允许提交/通过审核
注意：服务器需能访问用户域名；CDN/防火墙拦截、HTTPS 证书问题会导致校验失败。
九、过期与巡检
- 配置「认证有效天数」> 0
- 审核通过时写入
expire_time - 到期后可通过：
过期后状态变为已过期，关联勋章回收，并通知用户。
十、推荐上线清单
- 启用插件，开放申请
- 配置「同时认证数量」（要一证一户则填
1） - 配置有效天数与巡检密钥（需要过期机制时）
- 配置认证类型、字段、提示语，绑定勋章
- 用测试账号走通：申请 → 审核通过 → 看勋章 →（可选）驳回申诉 / 撤销 / 过期
- 站长类型务必实测 TXT 上传与校验
十一、常见问题
Q：前台看不到入口？
检查「启用身份认证」、社区会员导航插槽、用户是否已登录。
Q：只能申请一种还是多种？
由「同时认证数量」控制；设为 1 则同时只能有一种待审/已通过认证。
Q：通过了没有勋章？
检查勋章插件是否安装、类型是否绑定了启用中的勋章。
Q：域名验证一直失败？
确认文件在根目录可直链访问、内容为系统给出的校验码、本站服务器能出网访问该域名。
Q：申请时间显示不对？
当前版本已兼容时间戳与日期字符串；若仍异常，核对服务器时区与数据库 create_time 字段。
插件安装： https://www.zsens.cn/market/31.html 或登录后台应用中心安装
最新打赏
