# 访问控制
如果使用 project_full_path,确保 project_full_path 编码过,例子:/api/v3/projects/tencent/code--> /api/v3/projects/tencent%2Fcode (/ 编码 %2F)
# 获取访问控制配置
查看项目的访问控制配置。(包括 IP 白名单、用户白名单、特定访问规则 IP 白名单、特定访问规则用户白名单)
GET /api/v3/projects/:id/acl/config
参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| id | integer 或 string | 项目 ID 或 项目全路径 project_full_path |
返回值:
{
"project_id": 1,
"acl_enabled": true,
"allow_ips": "127.0.0.1;30.20.165.0/24",
"allow_users": "git_01;git_02",
"spec_allow_ips": "30.20.165.46",
"spec_hit_users": "git_03"
}
# 更新项目访问控制配置
更新项目访问控制中的 ACL 开关、IP 白名单、用户白名单、特定访问规则 IP 白名单、特定访问规则用户白名单
PUT /api/v3/projects/:id/acl/config
参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| id | integer 或 string | 项目 ID 或 项目全路径 project_full_path |
| acl_enabled | boolean(可选) | 项目 ACL 开关 |
| allow_ips | string(可选) | 项目 IP 白名单 (如有多个请用英文";"分隔) |
| allow_users | string(可选) | 项目用户白名单 (如有多个请用英文";"分隔) |
| spec_allow_ips | string(可选) | 项目特定访问规则 IP 白名单 (如有多个请用英文";"分隔) |
| spec_hit_users | string(可选) | 项目特定访问规则用户白名单 (如有多个请用英文";"分隔) |
返回值:
{
"project_id": 1,
"acl_enabled": true,
"allow_ips": "127.0.0.1;30.20.165.0/24",
"allow_users": "git_01;git_02",
"spec_allow_ips": "30.20.165.46",
"spec_hit_users": "git_03"
}