Nginx反向代理的SonarQube对接Azure AD SAML认证报错如何解决

问题原因确认 #

该报错确实是Nginx反向代理配置存在冲突，叠加SonarQube缺少反向代理适配配置共同导致的：

1. 你在Nginx的location块中重复配置了X-Forwarded-Proto头，同时指定了http和https两个值，配置冲突导致SonarQube识别到的请求协议错误
2. SonarQube默认不会信任反向代理传递的X-Forwarded-*头，就算Nginx传递了正确的协议头，SonarQube也不会用它来生成回调地址

修复步骤 #

1. 修正Nginx配置 #

删除location块中重复的proxy_set_header X-Forwarded-Proto http;行，仅保留https的配置，修正后的location块如下：

location / {
    proxy_pass  http://127.0.0.1:9000;
    proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
    proxy_redirect off;
    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;
}

配置修改完成后执行nginx -t验证配置合法性，验证通过后执行nginx -s reload重载Nginx配置生效。

2. 调整SonarQube配置 #

编辑SonarQube安装目录下conf/sonar.properties配置文件，添加以下配置项：

# 配置SonarQube对外暴露的基础访问地址
sonar.core.serverBaseURL=https://sonarqube.mydomain.co.in
# 开启反向代理头信任，读取X-Forwarded-*头的内容
sonar.web.forwardHeadersStrategy=NATIVE

配置修改完成后重启SonarQube服务，所有配置即可生效。

验证 #

配置全部生效后重新触发SAML登录，即可解决回调地址协议不匹配的报错。

内容的提问来源于stack exchange，提问作者Anshul Walia