SonarQube项目权限怎么设置 SonarQube项目权限导致成员看不到代码怎么办

SonarQube项目权限的设置，和因为权限问题导致成员看不到代码的处理，需要先分清楚项目到底是Public还是Private。公开的项目，一般来说更容易被访问到，私有的项目，则需要明确地去给用户，或者用户组进行授权。在SonarQube的官方说明里面，私有项目是需要去配置Browse Project和See Source Code这些权限的；如果要查看项目的结构和代码，私有项目的用户，就需要同时具备Browse和See Source Code这两项权限。

一、SonarQube项目权限怎么设置

SonarQube的项目权限，通常是由项目的管理员，或者是系统的管理员来进行配置的。不要把所有成员，都直接加成管理员，而是应该按照角色，去分配查看、扫描、问题处理，还有项目管理的权限。

1、先去确认项目的可见性

进到【Project Settings】里面的【Permissions】这个页面，先去确认一下项目是Public还是Private。

如果项目被设成了Private，那就要给对应的用户，或者用户组，分配Browse Project这项权限。没有Browse权限，成员是有可能连项目的首页、指标和问题的列表，都看不到的。官方的文档里面也说明过，项目变成private以后，是可以去定义哪些用户或者组，能够Browse project或者See Source Code的。

2、按照角色去分配权限

普通的开发成员，一般是需要Browse Project和See Source Code这两项权限的；负责提交扫描结果的CI账号，需要Execute Analysis这项权限；负责处理误报、接受问题，或者是调整安全热点的人员，再按照需要，去增加Administer Issues或者Administer Security Hotspots这些权限。Execute Analysis并不是用来查看代码的权限，它主要是用来启动分析，并且上传扫描结果的。在官方的权限说明里面，也把Execute Analysis描述为可以对项目执行分析。所以当成员看不到代码的时候，不要只给Execute Analysis，而是要去检查Browse和See Source Code。

3、优先使用用户组来进行管理

项目的成员比较多的时候，最好是能通过【Groups】去统一进行授权，而不是一个一个地给用户去添加权限。

比如给开发组赋予Browse和See Source Code，给CI组赋予Execute Analysis，给项目的负责人赋予Administer Project。这样一来，当人员发生变动的时候，就只需要去调整用户所属的组，不用再逐个项目地去重新配置了。

二、SonarQube项目权限导致成员看不到代码怎么办

当成员看不到代码的时候，要先看一看他到底是完全看不到项目，还是能够进到项目里面，但是却看不到源码。这两种不同的情况，它们所对应的权限，也是不一样的。

1、完全看不到项目

如果成员搜索不到项目，或者是进到链接以后，提示没有权限，这种情况，通常是缺少了Browse Project。对于私有的项目来说，Browse是进入项目的一项基础权限。需要先去检查一下，这个用户是不是属于正确的用户组，然后再去看项目的权限页面里面，这个组是不是已经被授予了相应的权限。

2、能看到项目，但是看不到源码

如果成员能够看到指标、问题的数量，还有质量门禁，但是点开Code页面，却看不到源码，这种情况，通常是缺少了See Source Code。在SonarQube的官方说明里面，See Source Code这项权限，是适用于私有项目的，并且需要先被授予Browse Project以后，才能够去查看源码。这种情况是很常见的，因为有些团队只给了Browse，就以为成员已经能够看到全部的内容了。实际上，Browse更偏向于项目的访问，See Source Code才是和源码的查看直接相关的。

3、权限的模板，没有覆盖到新的项目

如果新建的项目，权限总是不对，那就要去检查一下Permission Template了。SonarQube是支持通过权限的模板，去给新的项目自动分配默认权限的，文档里面也提到过，系统的管理员是可以去管理默认的项目权限，还有权限模板的。如果模板只给了管理员的权限，却没有给开发组Browse和See Source Code，那么新的项目被创建出来以后，成员自然是看不到代码的。处理的方式，就是先去调整模板，然后再对已有的项目，用手动的方式去补上权限。

三、项目权限调整后还要检查什么

权限被改完了以后，不要只是拿着管理员的账号去测试一遍。管理员的权限太高了，是很容易把问题给掩盖住的。最好是能用普通成员的账号，再去验证一次。

1、检查登录的账号，和用户组是不是同步的

如果SonarQube接入了LDAP、SAML，或者是其他的身份系统，用户组就有可能不是靠手动去维护的。成员被加入到了组织里面以后，SonarQube里面的组信息，要是没有同步过来，那也是会导致权限缺失的。可以先去看一看用户的详情页面里面的组，然后再去看一看项目权限页面里面的组，看看它们是不是一致的。

2、确认成员所访问的，是正确的项目和分支

有些时候，成员说看不到代码，其实是访问到了另外一个Project Key，或者是CI把结果扫描到了错误的那一个项目里面。需要先去确认好项目的名称、Project Key、最近一次分析的时间，还有分支，这些都是不是正确的，免得在错误的项目上面，反反复复地去改动权限。

3、不要随意地把管理员的权限放开

Administer Project这项权限，是可以去修改项目的设置，还有项目级别的权限的，它并不适合随随便便地，就交给普通的开发成员。当成员只是需要查看代码，和处理问题的时候，给Browse、See Source Code，还有必要的问题处理权限，就已经够了。权限越是清楚，到了后面，去做审计和问题追踪的时候，也就越是稳定。

总结

SonarQube项目的权限应当怎样去设置，以及项目权限导致成员看不到代码的时候，又该怎么去处理，这两件事的关键，是要先把项目的可见性给确认下来，然后再按照角色，去分配对应的权限。在私有的项目里面，成员要进入项目，通常是需要Browse Project的，要查看源码，还需要See Source Code；CI账号，要上传扫描的结果，则需要Execute Analysis。当成员看不到代码的时候，要优先去检查项目是不是私有的、用户组是不是正确的、Browse和See Source Code是不是都已经同时具备了，还有权限的模板，是不是影响到了新项目的默认授权。