GitHub 集成
如需集成 GitHub,可以按照以下流程配置:
- GitHub Organization 管理员新建 OAuth 应用程序
- 配置 OAuth 应用程序,填写基本信息以及回调地址
- 获取 OAuth 应用程序的 、
Client Secret
信息 - 跳转到 GitHub 进行认证授权
要启用 GitHub OAuth2,你必须在 GitHub 中注册一个应用程序。
- 个人账号下的代码库接入:可以通过点击 Github 账号头像 -> Settings -> Developer settings -> OAuth Apps 来新建应用程序。
- GitHub Organization 下的代码仓库接入:可以通过点击 Organization Settings -> Developer settings -> OAuth Apps 来新建应用程序。
下面以 GitHub Organization 为例,如下所示。
- 打开
Organization Settings
。
- 选择
Developer settings
-> ,点击New OAuth App
新建应用程序。
在新建应用程序页面,你需要进行如下步骤:
- Application name:zadig,也可以填写可识别的任一名称。
- Authorization CallBack URL:
http://[koderover.yours.com]/api/directory/codehosts/callback
- Authorization CallBack URL:
- 点击创建
注意
回调地址中 koderover.yours.com
需要替换为 Zadig 系统部署的实际地址
应用创建成功后,GitHub 会返回应用的基本信息,点击 Generate a new client secret
生成 Client Secret
。
此时页面包括完整的 Client ID
、。
切换到 Zadig 系统,管理员依次点击系统设置
-> 集成管理
-> 代码源集成
-> 点击添加按钮。
依次填入如下已知信息:
代码源
:此处选择 GitHubClient ID
:步骤 3 应用创建成功返回的 Client ID- :如果授权 Organization 下的 OAuth App,此处填写 Organization 名称;如果授权个人账号下的 OAuth App,此处填写个人 GitHub Username。
信息确认无误后点击 前往授权
,耐心等待,此时系统会跳转到 GitHub 进行授权。
点击授权按钮,同意授权后,GitHub 会跳转到 Zadig 系统,至此 GitHub 集成完毕。