Arbess 是一款开源且支持私有化部署的 CI/CD 工具,具备零配置、一键安装的特点,界面简洁、操作便捷。它支持通过第三方平台同步用户并实现登录功能,如 Ldap、企业微信、钉钉等。本文将详细说明如何完成 Arbess 的安装部署、配置企业微信用户同步,并使用企业微信账号进行系统登录。
一、Arbess 安装与基础设置
1.1 系统安装流程
以 CentOS 操作系统为例进行演示。
首先进行安装包下载:服务端程序已包含 Agent 组件,可前往官方页面获取 CentOS 版本安装包:
下载完成后,会得到一个名为 tiklab-arbess-x.x.x.rpm 的文件。
将该文件上传至目标服务器,并在所在目录执行安装命令。
rpm -ivh tiklab-arbess-x.x.x.rpm
安装完成后,系统默认路径为 /opt。进入启动脚本目录:/opt/tiklab-arbess/bin,运行以下命令启动服务:
./arbess start
服务启动成功后,可通过浏览器访问:http://ip:9200。
首次登录使用默认账户信息:用户名 admin,密码 123456。系统会强制要求修改初始密码。登录成功后即可进入主界面。
1.2 配置企业微信集成
为实现企业微信用户同步与登录,需先完成企业微信相关信息的填写。配置完成后,即可实现用户数据同步及单点登录功能。
进入系统设置模块 → 用户管理 → 用户目录,选择配置企业微信选项。
需要填写以下关键参数:
| 属性 |
说明 |
| 企业ID |
可在企业微信“我的企业”页面底部找到企业ID信息。 |
| 凭证秘钥 |
在企业微信应用管理中创建自建应用后,获取其 Secret 值。 |
| 授权回调域 |
必须为公网可访问的域名地址,且与企业微信 → 应用管理 → 自建应用 → Web网页授权回调域名保持一致。 |
| AgentId |
对应企业微信自建应用中的 AgentId 编号。 |
| Token |
用于接收用户目录变更回调,在“接收消息”配置项中设置并获取。 |
| EncodingAesKey |
同在“接收消息”中生成,用于加密消息体的安全校验密钥。 |
上述凭证信息均在企业微信后台的应用管理模块中获取。
此外,还需验证服务器地址的合法性:进入企业微信应用中心 → 打开对应应用 → 授权回调域 → 点击“验证”按钮下载认证文件 → 将该文件上传至服务器指定路径完成校验。
二、企业微信用户登录操作
2.1 账号同步处理
配置信息无误后,点击“开启”按钮,此时“同步数据”功能将变为可用状态。点击该按钮,系统即开始从企业微信拉取组织架构和用户信息,并同步至 Arbess 平台。
若同步失败,可能是由于配置错误导致。此时可点击“禁用”按钮,重新激活配置编辑权限,对相关参数进行修正。
2.2 使用企业微信登录系统
完成同步后,可在用户列表中查看已导入的企业微信用户记录。
退出当前会话,在登录页面选择“企业微信登录”入口,即可使用企业微信账号直接登录系统。
以上步骤完成后,即实现了 Arbess 的完整部署、企业微信用户同步以及基于企业微信的身份认证登录功能。