# gitee-oauth-plugin

**Repository Path**: oscstudio/gitee-oauth-plugin

## Basic Information

- **Project Name**: gitee-oauth-plugin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2023-12-14
- **Last Updated**: 2025-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Jenkins Gitee OAuth Plugin

Fork From https://github.com/jenkinsci/gitlab-oauth-plugin.git

## Useful links

* License: [MIT Licensed](LICENSE.txt)
* [Changelog](CHANGELOG.md)

## 获取最新版本

1. Run `mvn clean package -DskipTests`
2. Get the plugin HPI from `target/gitee-oauth.hpi`

## jenkins 版本

最低支持 jenkis version 2.387.3

## 如何使用

### Gitee 企业版构建第三方应用

目前仅支持 **Gitee 企业版** 第三方应用

1. 创建第三方应用，填写 Jenkins 服务信息，如下图，**将应用主页和应用回调地址中的 https://jenkins.com 替换为自搭的 jenkins 服务**

    ![输入图片说明](https://foruda.gitee.com/images/1720750488506158640/93209978_2115668.png)

2. 选择第三方应用的权限（user_detail，members，groups）

    ![输入图片说明](https://foruda.gitee.com/images/1720750838111928644/2028302c_2115668.png)

### Jenkins 下载

系统管理 -> 插件管理, 进入 `Advanced settings`

上传 [gitee-oauth.hpi 文件](https://gitee.com/oscstudio/gitee-oauth-plugin/releases/download/v1.0.1/gitee-oauth.hpi)

### Jenkins 配置

系统管理 -> 全局安全配置

1. 安全域选择

    Gitee Authentication Plugin

    - Gitee Web URI : https://gitee.com
    - Gitee API URI : https://api.gitee.com
    - Client ID     : Gitee Enterprise 第三方应用 Client ID
    - Client Secret : Gitee Enterprise 第三方应用 Client Secret

    ![输入图片说明](https://foruda.gitee.com/images/1720751317366204771/95bedf66_2115668.png "屏幕截图")

2. 授权策略选择

    Gitee Committer Authorization Strategy

    ！！！注意：如果选择安全域为 `Gitee Authentication Plugin` 而不选择授权策略, 所有用户将无权限读取设置, **请务必在 `Admin User Names` 中某个企业用户账号或者 `Gitee Groups for Admin` 中某个企业团队账号中填写管理员权限**

    - `Admin User Names` 中需要填写用户的 `username` 个人空间命名地址，非账号名称，以逗号隔开，该用户将拥有管理员权限
    - `Gitee Groups for Admin` 中需要填写企业团队的 `path` 团队空间命名地址，非团队名称，以逗号隔开，该团队下的所有成员都将拥有管理员权限
    - `Participant in Organization` 中需要填写企业团队的 `path` 团队空间命名地址，非团队名称，以逗号隔开，该团队下将拥有普通成员权限
    - `Authenticated Users` 指所有通过第三方应用跳转登录的企业用户

    ![输入图片说明](https://foruda.gitee.com/images/1720751366231770641/cce3894a_2115668.png "屏幕截图")