经管之家App
让优质教育人人可得
立即打开
VerifyGuard 是一套专为适配企业微信（WeCom）环境而开发的二次身份验证与安全登录解决方案。该系统通过统一认证网关机制，为企业内部各类应用提供高效、安全且易于管理的用户登录支持，全面强化身份核验流程的安全性与可控性。
建议选用配置为2核CPU、2GB或4GB内存的基础云服务器即可满足运行需求。部署初期需先安装宝塔面板以简化后续管理操作。
使用以下命令一键安装宝塔面板：
全部版块
我的主页
收藏
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ssl251104安装完成后，系统将输出默认的登录地址、用户名及密码信息，请妥善记录并用于首次登录访问。
由于 VerifyGuard 基于 PHP 构建，您可在宝塔面板中进入网站管理模块，添加站点并绑定所需域名，随后将程序文件部署至对应根目录即可。
确保服务器具备以下基础环境配置：
- PHP 版本: 7.4 或更高
- Web 服务器: Nginx 或 Apache
- 数据库: MySQL 5.7+ 或 MariaDB 10.2+
- 操作系统: Linux/Windows Server了解标准目录布局有助于正确部署和维护系统：
verifyguard/
├── admin/ # 管理后台
│ ├── logs/ # 日志目录（需写入权限）
│ └── ...
├── api/ # API接口
│ ├── callback.php # 企业微信回调接口
│ └── ...
├── data/ # 数据存储目录（需写入权限）
├── config.php # 配置文件模板
├── index.php # 主入口文件
└── README.md # 说明文档进入项目主目录后，执行如下命令完成权限配置：
# 切换到项目路径
cd /path/to/verifyguard
# 设置数据存储目录读写权限
chmod -R 755 data/
chmod -R 755 admin/logs/
根据所使用的Web服务器类型，赋予对应运行用户写入权限：
# 若使用 Apache（常见用户为 www-data 或 apache）
chown -R www-data:www-data data/
chown -R www-data:www-data admin/logs/
# 若使用 Nginx（常见用户为 nginx）
chown -R nginx:nginx data/
chown -R nginx:nginx admin/logs/
data/ 移出Web根目录，防止直接访问data/首先复制示例配置文件为正式配置：
cp config.example.php config.php然后编辑 config.php 文件，填写实际参数：
// 企业微信相关配置
class WeChatWorkConfig {
const CORP_ID = '您的企业ID'; // 企业微信 CorpID
const AGENT_ID = '您的应用AgentId'; // 应用唯一标识
const SECRET = '您的应用Secret'; // 应用密钥
const REDIRECT_URI = 'https://您的域名/auth/callback';
// 系统基本信息
const SYSTEM_NAME = 'VerifyGuard 安全登录系统';
const COPYRIGHT = '? 2024 您的公司名称';
// 安全策略设置
const ENABLE_2FA = true; // 是否开启二次验证
const SESSION_TIMEOUT = 7200; // 会话有效时长（秒）
// 邮件发送配置（用于验证码服务）
const SMTP_HOST = 'smtp.your-domain.com';
const SMTP_PORT = 587;
const SMTP_USER = 'noreply@your-domain.com';
const SMTP_PASS = 'your-smtp-password';
}
在配置类中设置数据库连接参数：
class DatabaseConfig {
const HOST = 'localhost'; // 数据库主机地址
const PORT = '3306'; // 数据库服务端口
const NAME = 'verifyguard_db'; // 目标数据库名
}
const USER = 'db_username'; // 数据库用户名
const PASS = 'db_password'; // 数据库密码
const CHARSET = 'utf8mb4'; // 字符集
- 填写以下信息：
- 应用名称：VerifyGuard 安全登录
- 应用Logo：上传系统标识图像
- 应用介绍：简要描述其核心功能与用途
https://your-domain.comhttps://xxx/api/callback.php
- 选择允许使用此系统的部门或指定成员
- 提交更改完成授权分配
适用场景：已在企业微信环境中登录的用户
操作流程：
手机号登录流程：
邮箱登录流程：
https://xxx/admin/config.php强制下线操作：
启用/禁用账号：
# 手动导出数据库
mysqldump -u username -p verifyguard_db > backup_$(date +%Y%m%d).sql
# 备份当前配置文件
cp config.php config_backup_$(date +%Y%m%d).php
# 删除30天前的所有日志文件
find admin/logs/ -name "*.log" -mtime +30 -delete
可能原因：
解决方案：
config.php可能原因：
解决方案：
可能原因：
解决方案：
# 修复数据目录权限
chown -R www-data:www-data data/
chmod -R 755 data/
可能原因：
常见问题及解决方案：
数据库相关问题
可能出现的问题包括数据库配置不正确、数据库服务未正常启动或网络连接异常。
对应的解决方式如下：
- 核实数据库的配置参数是否准确
- 确保数据库服务处于运行状态
- 进行网络连通性测试以排除连接故障
日志文件位置说明
系统日志：
admin/logs/system_YYYYMMDD.logadmin/logs/error_YYYYMMDD.log故障排查建议
- 详细查阅本指南及相关说明文档
- 检查错误日志，获取具体的错误信息以便定位问题
- 如问题仍未解决，可前往项目社区发帖提问
对于严重或紧急的技术问题，可直接联系开发团队寻求支持。
参与项目贡献
我们欢迎用户通过以下步骤提交 Issue 或 Pull Request：
1. Fork 项目仓库
2. 创建新的功能分支
3. 提交您的修改内容
4. 发起 Pull Request 合并请求
项目仓库地址：https://cnb.cool/cqbkxx.cn/VerifyGuard
扫码加好友，拉您进群
