本文主要翻译自Security Code Scan的官方Github文档，结合自己的初步使用简单介绍一下这款工具，大家可以结合自己团队的情况参考使用。此外，对.NET Core开发团队来说，可以参考张队的《.NET Core 必备安全措施》看看可以使用哪些方法提高我们.NET Core应用程序的安全性，此文也算是对张队的那篇文章的一个补充。此外，本文不会介绍常见的Web攻击及其场景，有兴趣的园友可以读读参考书《白帽子讲Web安全》一书。
一、Why SCS？
最近公司官网被Google拉入了安全黑名单，我们被迫把安全性的优先级提高了，先是启用HTTPS，然后是安全扫描，最后漏洞修复。以前做内部系统时往往不会很在意安全问题，现在经历了这么一波后印象深刻了。我们希望找寻一款工具，能够在代码开发阶段就能够分析出我们得代码存在的风险（至少是常见的风险，比如XSS、CSRF等），让开发人员第一时间能够知道并选择性地进行改正。
在Visual Studio Marketplace上，我们发现了一款工具：Security Code Scan，以下简称SCS，它是一款开源的代码安全分析工具，其Github地址为：https://github.com/security-code-scan/security-code-scan，目前Star数量只有150 ，但作者一直在维护，我们可以选择性使用。当然，有机会我们也可以为其提Issue甚至PR。
SCS能够检测的安全问题有哪些？
（1）SQL注入
（2）XSS跨站点攻击
（3）CSRF跨站点请求伪造攻击
（4）XXE（XML External Entity Injection）XML外部实体注入攻击
（5）......
SCS能够支持哪些项目类型？
当然是我们喜欢的.NET 和 .NET Core项目啦！
SCS能够支持CI吗？
可以，通过MSBuild完美实现，后续会有介绍。
SCS支持哪些Visual Studio版本？
Visual Studio 2015及以上版本均支持，包括社区版、专业版和企业版。
二、SCS的安装与基本使用
2.1 SCS的安装
目前，SCS支持两种方式的安装：
（1）VS扩展插件
（2）Nuget包
目前最新版本为3.0.0，2018年12月4日更新。
推荐使用Nuget包方式使用，因为CI也会依赖该Nuget包。
2.2 SCS的使用
为了演示SCS的使用，这里我们使用一个SCS在官方文档中准备好的一个故意留有安全问题的ASP.NET 项目（不是ASP.NET Core）叫做WebGoat.NET来初步使用一下。下载完成后，发现该示例项目是一个VS2010的项目，于是将其升级到.NET Framework 4.6.1并使用VS2017打开，最后效果如下图所示：
WebGoal.NET项目结构
第一步，当然是通过Nuget管理器引入SCS的包啦：
PS：VS2017的话选择SecurityCodeScan.VS2017版本，VS2015的话直接选择SecurityCodeScan。
第二步，确保错误列表窗口的选项是生成 IntelliSense：
第三步，编译该项目，查看错误列表Tab的警告信息：
当然，我们也可以将安全警告信息筛选出来，它们都是以SCS开头的规则：
第四步，点开其中一个安全问题，比如SCS0008，看看是什么提示信息：
原来是说Cookie缺少了Secure标记，推荐我们在设置新Cookie时都加上Secure标记。至于为什么要加上Secure标记，这个是OWASP推荐的一个最佳实践，你可以通过这篇《SecureFlag》来了解了解。大概意思就是：如果一个cookie被设置了Secure=true，那么这个cookie只能用https协议发送给服务器，用http协议是不发送的。换句话说，cookie是在https的情况下创建的，而且他的Secure=true，那么之后你一直用https访问其他的页面（比如登录之后点击其他子页面），cookie会被发送到服务器，你无需重新登录就可以跳转到其他页面。但是如果这是你把url改成http协议访问其他页面，你就需要重新登录了，因为这个cookie不能在http协议中发送。从另一个侧面来看，整站HTTPS的必要性也得以体现。
一个设置了Secure属性的C#代码示例：
代码语言：javascript复制 HttpCookie cookie = new HttpCookie("UID");
cookie.Path = "/";
cookie.Value = loginId.ToLower();
cookie.Expires = DateTime.Now.AddDays(1);
cookie.Secure = true;
Response.Cookies.Add(cookie);因此，这里我们可以定位到有漏洞问题的代码行，为其添加Secure=true，再次编译后，这一条SCS0008的警告就已经不再了。当然，你为此得付出的工作却没有结束，你还需要为系统配置Https证书和端口等等。
下一步？继续查看SCS给出的安全警告，选择性地进行修复，迭代反复。
三、SCS的规则集设置
和StyleCop.Analyzers之类的代码风格分析器一样，SCS也可以设置其规则集，对我们来说最有用的就是可以统一设置其严重性级别（比如：警告、信息还是错误）。怎么做呢？看下面的介绍。
在分析器上选择“打开活动规则集”：
在分析器规则集列表中定位到“SecurityCodeScan”中，可以看到SCS开头的一系列规则集，这里假设我们为SCS0008这条规则的严重性设置为错误：
保存后再次进行编译，可以看到，SCS0008已经是一个错误信息，编译不通过了：
通过改变安全规则的严重性，我们可以在开发阶段确保团队注意安全性，前提是要筛选出来哪些规则你要设置为错误，哪些规则你要设置为警告或信息等不影响编译的级别。
更多的规则想要了解？你想要了解的都在这里：
四、SCS与CI的集成
前面提到可以修改规则严重性来影响编译，那么在CI的继承中，我们如果使用MSBuild，那么作为Nuget包的SCS可以直接影响CI过程中的编译。
五、ASP.NET Core中的安全
这里参考张队的《.NET Core 必备安全措施》一文中的部分内容：
在ASP.NET Core 2.1中，默认会让你启用HTTPS，而在2.0中，默认是不启用的。
对于CSRF攻击，ASP.NET Core使用 ASP.NET Core data protection stack 来实现防请求伪造。默认情况下处于启用状态，CSRF令牌将自动添加为隐藏输入字段。
对于XSS攻击，可以使用内容安全策略（CSP），它是一个增加的安全层，可帮助缓解XSS（跨站点脚本）和数据注入攻击。实现上主要是在header里加了Content-Security-Policy的安全策略，ASP.NET Core中的代码参考如柳随风的这篇《ASP.NET Core2中使用CSP内容安全策略》。
对于微服务应用架构，我们默认会借助IdentityServer4实现标准的OIDC进行身份验证，则无需担心如何存储用户、密码或对用户进行身份验证。
.......
参考资料
（1）Security Code Scan，GitHub文档
（2）张善友，《.NET Core 必备安全措施》
（3）Forwill，《Cookie的Secure属性》
（4）如柳随风，《ASP.NET Core2中使用CSP内容安全策略》 吴翰清，《白帽子讲Web安全》
作者：周旭龙
出处：http://edisonchou.cnblogs.com
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文链接。
