企业微信-AD同步工具--基于ldaps协议

原创已于 2025-11-03 11:39:46 修改 · 985 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#企业微信

于 2025-10-11 17:45:28 首次发布

团队管理同时被 3 个专栏收录

29 篇文章

订阅专栏

企业信息安全

14 篇文章

订阅专栏

技术

4 篇文章

订阅专栏

项目介绍

本工具用于实现企业微信组织架构与Active Directory (AD)域之间的自动同步，帮助企业维护统一的用户目录和组织结构。通过定期同步，可以确保企业微信中的部门和用户信息与AD域保持一致。

注：基于ldaps协议同步修改，注意启用AD域控的ldaps协议，具体可以AI或者百度开启教程；源码和编译好的程序包在附件中，请根据文档注意生成config.ini文件。

核心特性

安全可靠：采用LDAPS (LDAP over SSL)协议进行AD域通信，确保数据传输安全
智能容错：内置continue-on-error机制，单个操作失败不影响整体同步
批量优化：使用批量操作减少网络往返，显著提升同步性能
增量同步：支持仅同步变更的用户，大幅提升效率
详细审计：自动生成操作日志(CSV)和验证报告(TXT)

主要功能

自动同步企业微信组织架构到AD域：将企业微信的部门结构自动同步到AD域中的OU结构
用户账户自动管理：自动创建、更新和禁用AD用户账户
组成员批量管理：批量处理用户组分配，提升同步效率
定时任务：支持按计划定时执行同步任务
实时监控：直观的界面展示同步进度和结果统计
日志记录：详细记录同步过程，支持日志过滤和导出
系统托盘运行：可最小化到系统托盘在后台运行
机器人通知：支持同步结果通过企业微信机器人通知
同步取消：支持优雅地中断正在进行的同步任务

系统要求

Windows操作系统（Windows 10/11 或 Windows Server 2016/2019/2022）
Active Directory域环境，支持LDAPS (端口636)
拥有足够权限的域管理员账户
Python 3.9+（如使用打包版本则无需单独安装Python）
企业微信自建应用及管理员权限

安装方式

方式一：使用打包好的可执行文件（推荐）

下载 dist 目录下的可执行文件
将以下文件复制到同一目录：
- WeCom-AD-Sync.exe - GUI主程序
- WeCom-AD-Sync-Console.exe - 控制台版本（可查看详细输出）
- Test-LDAP.exe - LDAP连接测试工具
- Test-WeCom-API.exe - 企业微信API测试工具
- config.ini - 配置文件
双击运行 WeCom-AD-Sync.exe

方式二：从源码运行

克隆或下载此仓库

创建虚拟环境（可选但推荐）：

python -m venv venv
venv\Scripts\activate

安装依赖：
```
pip install -r requirements.txt
```
运行程序：
```
python wecom_sync_ui.py
```

配置说明

首次运行程序时，需要在配置选项卡中填写以下信息：

企业微信配置

企业ID(CorpID)：企业微信管理后台获取的企业ID
应用AgentID：自建应用的AgentID（必填）
应用Secret：自建应用的Secret（必填）
机器人Webhook：用于发送通知的企业微信机器人Webhook地址（可选）

重要提示：本工具使用自建应用方式访问企业微信API，需要：

在企业微信管理后台创建自建应用
为应用配置"通讯录读权限"
将所有需要同步的部门添加到应用的"可见范围"
将服务器IP地址添加到企业微信"API接口调用许可IP"白名单

LDAP/AD域配置

LDAP服务器：AD域控制器的地址，例如 dc.example.com 或 192.168.1.10
域名：AD域的完整域名，例如 example.com
用户名：具有管理权限的域账户，格式：DOMAIN\username
密码：域账户密码
使用SSL：是否使用LDAPS（强烈推荐，选择"是"）
端口：LDAP端口，LDAPS默认为636，非SSL为389

安全建议：强烈建议启用SSL(LDAPS)以确保数据传输安全

AD基础配置

基础DN：用户OU的基础DN，例如 OU=Users,DC=example,DC=com
排除的用户：不需要同步的系统账户，用逗号分隔，例如 admin,administrator,guest

计划任务配置

每日执行时间：设置每天定时执行同步的时间（格式：HH:MM）
执行间隔：设置定时执行的间隔时间（分钟）
最大重试次数：同步失败时的最大重试次数

高级配置

可以通过编辑 config.ini 文件进行更多高级配置：

[WeChat]
CorpID = 企业微信ID
AgentID = 自建应用AgentID
CorpSecret = 自建应用Secret

[WeChatBot]
WebhookUrl = 机器人webhook地址

[LDAP]
Server = dc.example.com
Domain = example.com
Username = DOMAIN\admin
Password = your_password
UseSSL = True
Port = 636

[AD]
BaseDN = OU=Users,DC=example,DC=com
ExcludeUsers = admin,administrator,guest,krbtgt

[Account]
DefaultPassword = default password
ForceChangePassword = true

[Schedule]
Time = 03:00
Interval = 1440
MaxRetries = 3

[Sync]
IncrementalSync = true
ContinueOnError = true
BatchSize = 50

[Logging]
Level = INFO
DetailedLogging = true
KeepLogsDays = 30

使用说明

初次使用

配置企业微信：
- 在企业微信管理后台创建自建应用
- 获取 CorpID、AgentID 和 Secret
- 配置应用可见范围（包含需要同步的所有部门）
- 添加服务器IP到API白名单
配置LDAP连接：
- 使用 Test-LDAP.exe 测试LDAP连接
- 确保能够成功连接到域控制器
配置同步工具：
- 启动 WeCom-AD-Sync.exe
- 在配置选项卡填写所有必要信息
- 点击"保存配置"
测试同步：
- 使用 Test-WeCom-API.exe 测试企业微信API连接
- 点击"立即同步"执行首次同步
- 观察日志输出，确认同步正常