# VerifyGuard - 企业微信二次验证与安全登录系统



## 📋 项目介绍

VerifyGuard 是一款专为企业微信（WeCom）设计的二次验证与安全登录系统。该系统为企业内部系统登录提供了统一、安全、便捷的认证网关解决方案，有效解决身份核验问题。

##准备服务器和安装宝塔面板

![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/3404a137295919e90510df85f9c61df3.png)
服务器可准备2h2c或2h4c最基础即可，然后安装宝塔面板


宝塔面板命令：可到宝塔官网下载
https://www.bt.cn/new/download.html

安装完成宝塔面板后提示出账号密码进行登录如下
![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/eff69e812deb65384f1a2b988427dc09.png)

此系统是PHP系统，请直接在网站列表打开绑定您所需要的域名绑定即可

## 🚀 核心功能特性

### 身份验证功能
- **多方式登录支持**
  - 验证码登录（邮箱/手机号）
  - 密码登录
  - 企业微信 OAuth2.0 一键登录
  
- **二次验证流程**
  - 符合企业微信安全规范
  - 双重身份核验机制
  - 可配置的验证策略

### 账号管理系统
- **账号状态管理**
  - 实时查看用户在线状态
  - 支持强制下线违规账号
  - 账号启用/禁用控制
  
- **信息查询服务**
  - 自助查询企业微信账号ID
  - 支持手机号/邮箱查询方式
  - 快速定位用户信息

### 管理后台功能
- **用户管理模块**
  - 企业微信用户列表展示
  - 批量用户操作支持
  - 详细用户信息查看

- **系统监控仪表盘**
  - 实时系统状态监控
  - 用户登录统计报表
  - 登录日志可视化展示

- **配置管理中心**
  - 在线管理版权信息
  - 系统名称全局配置
  - 动态参数调整

- **安全审计日志**
  - 管理员操作记录
  - 用户行为追踪
  - 异常登录告警

---

## ⚙️ 安装部署指南

### 1. 环境要求

#### 服务器环境
```
- PHP 版本: 7.4 或更高
- Web 服务器: Nginx 或 Apache
- 数据库: MySQL 5.7+ 或 MariaDB 10.2+
- 操作系统: Linux/Windows Server
```

#### PHP 扩展要求
```php
// 必需扩展
- OpenSSL 扩展
- cURL 扩展
- PDO MySQL 扩展
- JSON 扩展
- MBString 扩展

// 推荐扩展
- Redis 扩展（用于会话缓存）
- GD 库（用于验证码生成）
```

### 2. 目录结构说明
```
verifyguard/
├── admin/                    # 管理后台
│   ├── logs/                # 日志目录（需写入权限）
│   └── ...
├── api/                     # API接口
│   ├── callback.php         # 企业微信回调接口
│   └── ...
├── data/                    # 数据存储目录（需写入权限）
├── config.php              # 配置文件模板
├── index.php               # 主入口文件
└── README.md               # 说明文档
```

### 3. 权限配置

#### 目录权限设置
```bash
# 切换到项目目录
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根目录之外
- 定期清理日志文件
- 设置适当的文件上传限制

### 4. 配置文件设置

#### 复制配置文件
```bash
cp config.example.php config.php
```

#### 编辑配置文件
```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';
}
```

#### 数据库配置
```php
// 数据库连接配置
class DatabaseConfig {
    const HOST = 'localhost';      // 数据库主机
    const PORT = '3306';          // 数据库端口
    const NAME = 'verifyguard_db'; // 数据库名称
    const USER = 'db_username';    // 数据库用户名
    const PASS = 'db_password';    // 数据库密码
    const CHARSET = 'utf8mb4';    // 字符集
}
```

---

## 📱 企业微信配置指南

### 1. 准备工作
1. 确保拥有企业微信管理员权限
2. 准备已备案的域名（企业微信要求）
3. 获取服务器的公网IP地址

### 2. 企业微信后台配置步骤

#### 第一步：创建自建应用
1. 登录 [企业微信管理后台](https://work.weixin.qq.com/)
2. 进入 **应用管理** → **自建应用**
![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/06bed8918785bfd91a6a4f0f0965fdc2.png)
4. 点击"创建应用"
![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/f3bec0c609ccb9937f77fdfec9eca904.png)
5. 填写应用信息：
   - 应用名称：VerifyGuard 安全登录
   
   - 应用Logo：上传系统Logo
   - 应用介绍：简要说明应用功能
![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/ecb2ba40dfdefc543ef3c0c63b852ad8.png)

#### 第二步：获取应用凭证
创建应用后，在应用详情页面获取以下信息：
- **AgentId**: 应用唯一ID
- **Secret**: 应用密钥（务必妥善保存）
- **CorpID**: 企业ID（在"我的企业"页面查看）
- ![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/6f5db8abfc29a287f171cccbb870cbf9.png)

#### 第三步：配置网页授权
1. 在应用详情页面，找到 **"网页授权及JS-SDK"** 部分
2. 点击"修改"
3. 设置 **可信域名**：
![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/487415ffd19de40259ad015aa57b9012.png)
   ```
   https://your-domain.com
   ```
   ⚠️ **注意**：
   - 域名必须已完成工信部备案
   - 域名必须支持HTTPS
   - 确保域名解析正确

#### 第四步：配置二次验证
1. 进入 **管理工具** → **安全与开发** → **二次验证**
2. 点击"设置"
3. 填写二次验证页面URL：
   ```
   https://xxx/api/callback.php
   ```
4. 保存配置

#### 第五步：配置应用可见范围
1. 在应用详情页面，找到 **"可见范围"**
![image.png](https://developer.qcloudimg.com/http-save/yehe-10211184/135df0fb079e9f8d63bd59ed4e410d1d.png)
2. 选择需要使用该系统的部门或成员
3. 保存设置

### 3. 回调地址验证
企业微信会验证回调地址的有效性，确保：
- 服务器已正确部署
- HTTPS证书有效
- 回调接口可正常访问

---

## 👥 用户使用指南

### 首次访问流程

#### 方式一：企业微信内访问
1. 在企业微信中点击应用图标
2. 系统自动跳转到登录页面
3. 完成身份验证
4. 进入系统主界面

#### 方式二：浏览器访问
1. 打开浏览器，访问系统URL
2. 选择登录方式：
   - **企业微信一键登录**（推荐）
   - **验证码登录**（邮箱/手机）
   - **账号密码登录**

### 登录方式详解

#### 1. 企业微信一键登录
- **适用场景**：已登录企业微信的用户
- **操作步骤**：
  1. 点击"企业微信登录"按钮
  2. 授权应用访问基本信息
  3. 自动完成登录

#### 2. 验证码登录
- **手机号登录**：
  1. 输入手机号码
  2. 点击获取验证码
  3. 输入收到的6位验证码
  4. 点击登录

- **邮箱登录**：
  1. 输入邮箱地址
  2. 点击获取验证码
  3. 查看邮箱中的验证码
  4. 输入验证码登录



### 个人中心功能
登录成功后，用户可以在个人中心：
- 查看账号基本信息
- 修改个人资料
- 查看登录历史记录
- 管理登录设备
- 修改密码

---

## 👨‍💼 管理员操作指南

### 1. 管理员登录
1. 访问管理员后台地址：
   ```
   https://xxx/admin/
   ```
2. 使用管理员账号登录
   - 默认账号：查看 `config.php` 中的配置
   - 首次登录建议修改默认密码

### 2. 用户管理

#### 查看用户列表
1. 进入 **用户管理** → **用户列表**
2. 查看所有注册用户信息
3. 支持按部门、状态筛选

#### 用户状态管理
- **强制下线**：
  1. 找到目标用户
  2. 点击"强制下线"按钮
  3. 确认操作
  
- **启用/禁用账号**：
  1. 选择需要操作的账号
  2. 点击"启用"或"禁用"
  3. 填写操作原因（可选）

#### 用户信息查询
1. 进入 **用户管理** → **账号查询**
2. 输入手机号或邮箱
3. 查询对应的企业微信账号ID

### 3. 系统监控

#### 仪表盘查看
1. 登录后进入管理首页
2. 查看系统关键指标：
   - 当前在线用户数
   - 今日登录次数
   - 系统运行状态
   - 异常登录告警

#### 登录日志审计
1. 进入 **日志管理** → **登录日志**
2. 查看详细的登录记录
3. 支持按时间、用户、IP筛选
4. 导出日志数据

### 4. 系统配置

#### 全局设置
1. 进入 **系统设置** → **基本配置**
2. 修改系统参数：
   - 系统名称
   - 版权信息
   - 登录页样式
   - 会话超时时间

#### 安全策略配置
1. 进入 **系统设置** → **安全策略**
2. 配置验证策略：
   - 二次验证开关
   - 验证码有效期
   - 密码强度要求
   - IP白名单设置

### 5. 日常维护

#### 数据备份
```bash
# 手动备份数据库
mysqldump -u username -p verifyguard_db > backup_$(date +%Y%m%d).sql

# 备份配置文件
cp config.php config_backup_$(date +%Y%m%d).php
```

#### 日志清理
1. 定期检查日志文件大小
2. 清理过期日志：
   ```bash
   # 保留最近30天的日志
   find admin/logs/ -name "*.log" -mtime +30 -delete
   ```

#### 系统更新
1. 下载最新版本
2. 备份当前版本
3. 替换文件（保留配置文件）
4. 运行更新脚本（如有）
5. 测试系统功能

---

## 🔧 故障排除

### 常见问题及解决方法

#### 问题1：企业微信登录失败
**可能原因**：
- 企业微信配置错误
- 回调地址不正确
- 域名未备案或HTTPS证书问题

**解决方法**：
1. 检查 `config.php` 中的企业微信配置
2. 验证回调地址URL
3. 确认域名已备案且HTTPS有效

#### 问题2：验证码发送失败
**可能原因**：
- SMTP配置错误
- 邮件服务器限制
- 频率限制触发

**解决方法**：
1. 检查邮件服务器配置
2. 查看邮件发送日志
3. 调整发送频率限制

#### 问题3：权限不足错误
**可能原因**：
- 目录权限设置不正确
- Web服务器用户无写入权限

**解决方法**：
```bash
# 重新设置目录权限
chown -R www-data:www-data data/
chmod -R 755 data/
```

#### 问题4：数据库连接失败
**可能原因**：
- 数据库配置错误
- 数据库服务未启动
- 网络连接问题

**解决方法**：
1. 检查数据库配置信息
2. 确认数据库服务运行状态
3. 测试网络连接

### 日志查看位置
- **系统日志**：`admin/logs/system_YYYYMMDD.log`
- **错误日志**：`admin/logs/error_YYYYMMDD.log`
- **访问日志**：Web服务器日志文件

---

## 📞 技术支持

### 获取帮助
1. **查看文档**：仔细阅读本指南和相关注释
2. **检查日志**：查看错误日志获取详细信息
3. **社区支持**：访问项目社区提问
4. **联系开发团队**：对于紧急问题

### 贡献指南
欢迎提交 Issue 和 Pull Request：
1. Fork 项目仓库
2. 创建功能分支
3. 提交更改
4. 发起 Pull Request

仓库地址：https://cnb.cool/cqbkxx.cn/VerifyGuard
---








VerifyGuard 是一款专为企业微信（WeCom）设计的二次验证与安全登录系统。该系统为企业内部系统登录提供了统一、安全、便捷的认证网关解决方案，有效解决身份核验问题。

VerifyGuard - 企业微信二次验证系统

后端开发工程师

后端

安全

网络与通信

VerifyGuard是企业微信二次验证与安全登录系统，提供多方式登录、双重身份核验、账号管理等功能。支持验证码、密码及企业微信OAuth2.0一键登录，具备实时监控、安全审计等后台管理模块。安装需PHP7.4+环境，配置企业微信应用后即可使用，有效提升企业系统登录安全性。

身份验证

数据备份

安全审计

日志文件

访问管理

数据存储

数据库

验证码

服务器

Redis

JSON

4核4G3M云服务器 新用户低至38元/年！

lighthouse

AI驱动 智领未来

tencentdb-catalog

captcha

域名特惠新用户低至1元！


domain

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

VerifyGuard - 企业微信二次验证系统-腾讯云开发者社区-腾讯云

VerifyGuard - 企业微信二次验证系统

VerifyGuard - 企业微信二次验证系统

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐