灯塔 CMS 开发文档

认证与安全

后台认证、员工权限、CSRF、上传和输出安全。

适用版本:1.3.4更新日期:2026-10-12

认证与权限

后台认证由 AuthManager 管理。权限以模块为粒度,管理员拥有全部权限,员工按授权访问。

开发后台功能时需要确认:

  • 路由是否需要登录。
  • 是否只允许管理员访问。
  • 是否需要模块权限,例如产品、内容、询盘、外观、设置。
  • 导航是否根据权限显示或隐藏。
  • 直接访问 URL 是否仍然会被拦截。

权限控制不能只做前端隐藏,控制器必须二次检查。

安全规范

系统包含多层安全措施:

层次说明
Web 服务器.htaccess 或 Nginx 规则阻止敏感目录访问。
入口文件设置安全响应头和基础错误处理。
后台认证Session、角色、权限检查。
表单提交CSRF Token。
文件上传MIME、扩展名和目录校验。
输出渲染h()、url()、asset_url()。
安全检查Dashboard 检查数据库权限和访问规则。

开发时禁止事项

  • 禁止直接输出未转义用户输入。
  • 禁止在主题里写删除文件、重置配置、写数据库等破坏性逻辑。
  • 禁止绕过 AuthManager 写后台入口。
  • 禁止让上传路径可执行 PHP。
  • 禁止在迁移中无提示删除用户数据。
  • 禁止把 API Key、密码、Token 写入主题或前台模板。