SonarQube 安全加固实战:权限与令牌配置

SonarQube 安全加固经常被跳过,因为它是“内部工具”。但它同时存着全公司源码、未修复漏洞清单和 CI 令牌:一旦被打穿,攻击者拿到的不是一台机器,而是一张标注了“哪个系统有洞、怎么打”的地图。本文按入口、身份、授权三条线做收敛,所有配置均可直接复制执行。

适用场景

  • 内网自建 SonarQube,办公网可访问,且曾出现过“谁都能打开项目页看源码”的情况;
  • CI 流水线通过用户令牌调用扫描接口,令牌由离职人员创建且从未轮换;
  • 平台直接暴露 9000 端口明文 HTTP,或反代后链接仍指向 localhost;
  • 等保或客户审计要求代码扫描平台具备身份鉴别、访问控制与审计日志。

前置条件

  • SonarQube 9.9 LTS 或 10.x(Community、Developer 版命令一致,项目级令牌仅企业版提供);
  • Linux 主机,Docker 或 systemd 部署均可;
  • Nginx 1.20 及以上,具备可用的 TLS 证书;
  • 持有管理员账号,可修改 conf/sonar.properties 并重启服务;
  • 已安装 curl 与 jq,用于后续验证。

原理说明

SonarQube 有三个对外入口:Web 面板、Web API(/api/*,用 Basic Auth 传令牌)、以及后台的 Compute Engine 队列。默认状态下 9000 端口是明文 HTTP,匿名访问可以浏览公开项目,令牌没有过期时间,Web API 也没有速率限制——这四点构成了主要风险面。

因此加固分三层,缺一层都会留后门:

  • 入口收口:服务只监听 127.0.0.1,由 Nginx 终结 TLS 并做来源网段白名单,避免 9000 端口被内网任意主机直连;
  • 身份收敛:开启强制认证关闭匿名浏览,改掉默认 admin 口令,接入 LDAP 或 SAML 统一身份;
  • 授权与令牌治理:用权限模板控制新项目的默认可见性,令牌按流水线拆分并定期轮换,开启审计日志留存权限变更。

一个容易忽略的点:sonar.forceAuthentication 在 9.x 之后存在数据库里,优先级高于配置文件。只改 sonar.properties 而不检查数据库设置,会出现“改了没生效”的假象。

操作步骤

第一步:只监听回环,交给 Nginx 终结 TLS

# /opt/sonarqube/conf/sonar.properties
sonar.web.host=127.0.0.1
sonar.web.port=9000
sonar.web.context=/
sonar.forceAuthentication=true
sonar.web.sessionTimeoutInMinutes=30
sonar.web.maxUploadSize=100
sonar.core.serverBaseURL=https://sonar.example.com/
sonar.updatecenter.activate=false

sonar.core.serverBaseURL 必须写成反代后的外部地址,否则邮件通知、webhook 回调、扫描报告里的链接都会回落成 localhost:9000。sonar.updatecenter.activate=false 用于关闭联网检查更新,离线环境必须设,否则会持续外连并暴露版本信息。

server {
    listen 443 ssl;
    server_name sonar.example.com;

    ssl_certificate     /etc/nginx/certs/sonar.crt.pem;
    ssl_certificate_key /etc/nginx/certs/sonar.key.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;
    server_tokens       off;

    # 只允许办公网与 CI 网段
    allow 10.10.0.0/16;
    allow 10.20.30.0/24;
    deny  all;

    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
    }
}

client_max_body_size 要与 sonar.web.maxUploadSize 保持一致,否则大项目上传扫描报告会返回 413;X-Forwarded-Proto 不透传的话,SonarQube 生成的绝对链接仍是 http,点击后会跳回明文端口。

第二步:确认匿名已被关闭

# 不带凭据访问 API:期望 401;返回 200 说明匿名仍可读
curl -s -o /dev/null -w "%{http_code}\n" https://sonar.example.com/api/projects/search

# 校验令牌是否有效(-u 后的冒号不能省,否则会被当成用户名无密码)
curl -s -u "$SONAR_TOKEN:" https://sonar.example.com/api/authentication/validate

# 若配置文件未生效,直接用 API 覆盖数据库设置
curl -s -u admin:$PWD -X POST "https://sonar.example.com/api/settings/set" \
  -d "key=sonar.forceAuthentication" -d "value=true"

第一条返回 200 就意味着任何人都能枚举项目并读取源码与漏洞明细,必须先修掉再谈其他。第三条是幂等操作,重复执行不会报错,适合写进部署后置脚本。

第三步:账号与权限模板

SONAR=https://sonar.example.com

# 1. 改掉默认 admin 口令(原口令 admin 必须变更)
curl -s -u admin:$OLD_PWD -X POST "$SONAR/api/users/change_password" \
  -d "login=admin" -d "previousPassword=$OLD_PWD" -d "password=$NEW_STRONG_PWD"

# 2. 建立只读审计组,全局只给“配置”以外的浏览能力
curl -s -u admin:$PWD -X POST "$SONAR/api/user_groups/create" -d "name=audit-readonly"

# 3. 建立严格权限模板:默认不给 Anyone 任何项目权限
curl -s -u admin:$PWD -X POST "$SONAR/api/permissions/create_template" \
  -d "name=default-strict" -d "description=no-anonymous-access"

# 4. 只读组在模板中仅获得 user(浏览项目)权限
curl -s -u admin:$PWD -X POST "$SONAR/api/permissions/add_group_to_template" \
  -d "templateId=$TEMPLATE_ID" -d "groupName=audit-readonly" -d "permission=user"

# 5. CI 机器人组授予全局 scan 权限,仅用于触发扫描
curl -s -u admin:$PWD -X POST "$SONAR/api/permissions/add_group" \
  -d "groupName=ci-bot" -d "permission=scan"

# 6. 设为新项目默认模板
curl -s -u admin:$PWD -X POST "$SONAR/api/permissions/set_default_template" \
  -d "templateId=$TEMPLATE_ID"

关键是第 6 步:只有把严格模板设为默认,之后新建的项目才会继承;存量项目需要执行 api/permissions/apply_template 批量套用。scan 是全局权限,拿到它的账号可以扫描任意项目并读取结果,因此只能给 CI 机器人组,不能给个人账号。

第四步:令牌治理

# 列出全部令牌及其创建时间,用于发现长期未轮换的对象
curl -s -u admin:$PWD "$SONAR/api/user_tokens/search" \
  | jq -r '.userTokens[] | [.login, .name, .createdAt, .lastConnectionDate] | @tsv'

# 吊销指定令牌
curl -s -u admin:$PWD -X POST "$SONAR/api/user_tokens/revoke" \
  -d "login=cx" -d "name=ci-old"

令牌等同口令,且默认永不过期。治理规则建议写死三条:只给机器人账号发令牌、一条流水线一个令牌、90 天强制轮换。Community 版没有项目级令牌,只能靠“一流水线一账号”来隔离权限范围;企业版则可用项目令牌把影响面收敛到单个项目。

第五步:审计与出站收敛

# 1. 权限与用户变更审计
curl -s -u admin:$PWD "$SONAR/api/audits/search?category=PERMISSION&ps=50" \
  | jq -r '.audits[] | [.createdAt, .login, .message] | @tsv'

# 2. 反代侧看爆破与异常扫描来源
awk '{print $1}' /var/log/nginx/sonar.access.log | sort | uniq -c | sort -rn | head -20
grep -c ' 401 ' /var/log/nginx/sonar.access.log

# 3. 出站:确认没有非预期的 webhook 把扫描结果外带
curl -s -u admin:$PWD "$SONAR/api/webhooks/list" | jq -r '.webhooks[] | [.key, .url] | @tsv'

webhook 是容易被忽视的外带通道:任何有项目管理员权限的人都能配一个外部 URL,把每次扫描的结果推出去。只允许内网地址作为回调目标,并定期用第 3 条命令核对;插件只从官方市场安装,长期不用的插件卸载,减少 CVE 暴露面。

配置验证

# 1. 端口只监听回环:9000 不应出现在对外地址上
ss -ltnp | grep 9000

# 2. 未登录访问系统状态接口应返回 401
curl -s -o /dev/null -w "%{http_code}\n" https://sonar.example.com/api/system/status

# 3. TLS 版本与证书链
openssl s_client -connect sonar.example.com:443 -servername sonar.example.com \
  < /dev/null 2>/dev/null | grep -E "Protocol|Verify return code"

# 4. 默认模板已切换为严格模板
curl -s -u admin:$PWD "$SONAR/api/permissions/templates" \
  | jq -r '.permissionTemplates[] | [.name, .projectKeyPattern] | @tsv'

四项全部符合预期才算收口:监听地址是 127.0.0.1、未登录返回 401、TLS 协商为 TLSv1.2 以上且校验返回 0、默认模板为 default-strict。若第 1 项显示 0.0.0.0:9000,说明配置文件没生效或容器端口映射仍然对外开放。

常见问题

FAQ 1:升级或恢复备份后,强制认证又变回允许匿名?

因为该设置存放在数据库的 settings 表里,恢复旧备份自然带回旧值,而 sonar.properties 只是初始值。处理办法是在部署脚本末尾固定执行 api/settings/set 覆盖一次,然后用 api/settings/values?keys=sonar.forceAuthentication 回读确认,不要凭配置文件判断。

FAQ 2:本地扫描正常,CI 流水线却一直 401?

三类原因按概率排序:令牌随离职账号被吊销;流水线里用了 sonar.login=用户名 加口令而非令牌(新版本已拒绝口令认证);令牌所属账号缺少全局 scan 权限。先用 api/authentication/validate 确认令牌本身有效,再用 api/permissions/groups?permission=scan 查权限归属。

FAQ 3:反代后邮件通知和扫码报告里的链接指向 localhost:9000?

两个原因同时存在:serverBaseURL 未配置或配成了 http;Nginx 没有传 X-Forwarded-Proto,导致 SonarQube 认为外部协议是 http 而拼接回内部地址。把 serverBaseURL 改成带结尾斜杠的 https 地址、补上该请求头,重启后即可恢复。

总结

SonarQube 加固的性价比很高:一个 serverBaseURL、一个 forceAuthentication、一份来源白名单,就能挡掉绝大多数“内网随手一搜就能看源码”的场景;再叠加权限模板与令牌轮换,把“平台被拿下”的影响面从全公司收敛到单个项目。落地顺序建议是先收口入口,再关匿名,最后治理令牌与审计,每一步都用文中命令回读验证,不靠“应该生效了”来判断。