飞网OAuth认证连接器

gmzta2025年4月22日大约 6 分钟

—— 5分钟快速开启飞网oauth认证服务

✨ 1.什么是飞网 OAuth 认证连接器？

飞网 OAuth 认证连接器是一个轻量级的 OAuth/OIDC 身份认证服务。

✅ 快速集成：只需几行配置，即可将飞网 OAuth 认证服务集成到您的应用中。
✅ 即插即用：无需复杂的配置与部署，即可实现身份认证与授权。
✅ 安全性高: 内置端到端加密机制，支持零信任接入与最小权限控制，有效防止未授权访问。
✅ 轻量级：低内存占用，即可满足高并发的业务需求。

📦 提供标准 OIDC 接口
🔐 复用飞网网络中的身份信息
⚡ 适用于不同网络环境如：零公网、零 DNS、仅飞网私有网络环境

✅ 2.为什么选择飞网 OAuth 认证连接器？

🧠 统一身份，免二次登录

实现一次登录，处处通行
无需额外输入账号密码
用户登录飞网后，自动登录所有接入系统
用户登录过程 = 登录飞网 = 登录所有接入系统

🛜 无需公网，专为边缘设备设计

无需域名、TLS 证书或防火墙放行端口
设备只需接入飞网网络即可进行 OIDC 认证
适用于本地 Gitee、局域网内服务、私有云节点等

🧩 与飞网生态深度融合

支持细粒度权限管理和登录审计
自动识别用户身份信息（如团队、机器等）
身份验证与访问控制无缝集成，防止未经授权的访问
安全性增强：通过飞网的统一身份管理系统，减少潜在安全漏洞

⚙️ 部署极其轻量

容器化部署，极简配置
无需数据库或额外后端服务依赖
适合边缘设备与资源受限环境

🚀 3.飞网连接器对比分析

3.1 与传统模式对比

解决问题	传统方案痛点	飞网连接器优势
本地账户管理繁琐	需搭建公网 IdP	飞网登录直接接入
无 SSO 功能	配置繁琐	一行配置搞定
手动管理用户	零信任难实现	访问控制快速配置
无公网条件	DNS/证书配置复杂	飞网自动配置加密网络

3.2 部署模式对比

传统接入 vs 飞网接入结构对比图

客户端 + IdP 接入飞网

全飞网部署示意图

传统模式：依赖公网条件，部署繁琐、存在较高安全风险；
飞网接入：逐步替代公网架构，构建安全、自动化的访问通路；
全飞网模式：零公网依赖，极简部署体验，适合各种受限环境。

模式	描述	网络要求	安全性	运维复杂度
传统模式（未接入飞网）	传统 OAuth 或 SSO 架构，依赖公网 IdP 与服务地址	客户端、认证系统、后端服务均需公网、TLS、端口放行	🔒 低：明文暴露多，配置复杂、易出错	🛠 高：需手动部署 IdP、配置 DNS、TLS 等
客户端+IdP 接入飞网	客户端和飞网 IdP 在飞网内网，后端服务保持公网	客户端经飞网连接 IdP，后端仍需公网访问	🔒 中：登录链路加密受控，后端仍在公网	🛠 中：只需为 IdP 和客户端配置飞网网络
全飞网模式（推荐）	客户端、IdP 与后端服务均部署在飞网网络内	无需公网、域名、TLS 证书或端口放行	🔒 高：全链路加密、身份自动注入	🛠 低：无需公网资源，开箱即用

🧩 4.飞网 OAuth 认证连接器使用指南

4.1 体验飞网 OAuth 认证服务

在接入飞网测试团队网络之前，访问飞网单点登录演示项目（地址如下）：

http://demo3.gmzta.com:44280/

此时由于尚未接入体验网络，访问将会失败，页面显示如下所示的认证失败信息：

飞网单点登录演示网址

认证失败

注册飞网账号，并成功接入测试团队网络后，页面访问状态会发生变化，进入认证成功界面。如下图所示：

加入体验网络

飞网 OAuth 认证服务测试

4.2 Docker 部署飞网OAuth认证连接器

4.2.2 拉取镜像

docker pull registry.cn-beijing.aliyuncs.com/gmzta/gmzta-oauth-connector:latest

4.2.2 启动容器

docker run -d \
  --name gmzta-oauth-connector \
  --hostname gmzta-oauth-connector-test \
  -e GM_TOKEN=gmzta-authkey-123456789abcd \
  -v ${PWD}/gmzta/conf:/var/lib/gmzta \
  --restart unless-stopped \
  registry.cn-beijing.aliyuncs.com/gmzta/gmzta-oauth-connector:latest \
  --verbose --dir=/var/lib/gmzta --in

贡献者

lizhengaas