GitLab
通过 OAuth 授权接入 GitLab，获取仓库信息作为信息源
核心概念
GitLab 是基于 Git 的代码托管与 DevOps 平台
开发团队用来存放、管理、协作开发代码的平台，支持 CI/CD、Issue 跟踪、代码审查等完整的 DevOps 工作流。很多企业和开源项目使用 GitLab 管理代码仓库，它也支持 OAuth 授权登录。
Zleap 接入 GitLab用的是第三方授权登录（OAuth）：你不需要把 GitLab 密码告诉 Zleap，只需在 GitLab 官方页面授权，Zleap 就能获取你的仓库信息（代码、Issue、MR 等）完成对接。
操作步骤
前置条件：在 GitLab 中创建 OAuth 应用
在 Zleap 中配置 GitLab 之前，需要先在 GitLab 中创建一个 OAuth 应用程序。
登录您的 GitLab 账号（GitLab.com 或自托管实例），进入【User Settings】-【Applications】，点击【Add new application】创建新应用。
填写应用信息：
- Name：应用名称，例如 "Zleap Integration"
- Redirect URI：回调地址，从 Zleap 配置页面复制
- Scopes：勾选所需权限（至少需要 read_user、read_repository）
创建成功后，GitLab 会生成 Application ID 和 Secret，请妥善保存这两个值。
在 Zleap 中配置 GitLab
步骤1：进入 GitLab 配置页面
在 Zleap 中进入【信息管理】-【创建信息源】-【GitLab】。
步骤2：选择 GitLab 实例类型
根据您使用的 GitLab 类型选择：GitLab.com（使用官方云服务）或 Self-hosted GitLab（使用企业自托管实例）。
步骤3：填写 GitLab 实例地址（仅自托管）
如果选择了 Self-hosted GitLab，需要填写您的 GitLab 实例地址。
步骤4：复制回调地址
在 Zleap 配置页面中，复制显示的【Redirect URI】（回调地址）。
步骤5：填写 Application ID 和 Secret
将从 GitLab OAuth 应用中获取的凭证填入 Zleap。
- Application ID：粘贴 GitLab 生成的 Application ID
- Secret：粘贴 GitLab 生成的 Secret
步骤6：完成授权
点击【去授权】按钮，页面会自动跳转到 GitLab 授权页面。确认授权 Zleap 访问您的 GitLab 数据，授权成功后自动返回 Zleap，即完成 GitLab 接入。
配置完成后，Zleap 就可以访问您授权的 GitLab 仓库信息了！
关键说明
关于权限范围（Scopes）
在 GitLab 中创建 OAuth 应用时，需要选择合适的权限范围：
- read_user：读取用户基本信息（必需）
- read_repository：读取仓库代码和文件（推荐）
- read_api：读取 API 数据，包括 Issue、MR 等（推荐）
安全提示：只授予 Zleap 必要的权限，避免授予写入权限（如 write_repository、api）
常见错误排查
错误 1：Redirect URI mismatch
原因：GitLab OAuth 应用中配置的回调地址与 Zleap 提供的不一致
解决：检查并确保 GitLab 应用配置中的 Redirect URI 与 Zleap 显示的完全一致（包括协议、域名、路径）
错误 2：Invalid client credentials
原因：Application ID 或 Secret 填写错误
解决：重新从 GitLab OAuth 应用页面复制 Application ID 和 Secret，确保没有多余的空格或字符
错误 3：Connection timeout（自托管实例）
原因：GitLab 实例地址无法访问或网络不通
解决：确认 GitLab 实例地址正确，且 Zleap 服务器可以访问该地址（检查防火墙、VPN 等网络配置）
错误 4：Insufficient permissions
原因：OAuth 应用的权限范围不足
解决：返回 GitLab OAuth 应用配置，勾选必要的 Scopes（至少需要 read_user 和 read_repository）
提交反馈意见
›对 GitLab 接入有疑问或建议？欢迎通过反馈表单告诉我们