如何为Web API模型属性添加防XSS装饰特性,有可过滤脚本标签的消毒类库吗
.NET Web API XSS属性消毒方案
成熟可用的类库
Ganss.XSS.HtmlSanitizer:目前.NET生态维护最活跃、符合OWASP防护规范的开源HTML消毒库,支持自定义标签/属性白名单,可精准过滤script标签、内联事件、恶意样式等各类XSS注入内容,依赖少、性能稳定,是生产场景的首选。SanitizeHtml.Net:轻量型替代方案,区分普通文本、富文本两种消毒模式,配置灵活,适合对包体积有要求的小型项目。
实现[Sanitize]特性自动消毒的方式
基于上述类库,可通过两种方式实现你需要的属性标记效果,无需在每个接口中手动编写消毒逻辑:
方式1:自定义特性+管道钩子(灵活可控)
- 先定义用于标记需要消毒属性的特性类:
[AttributeUsage(AttributeTargets.Property)] public class SanitizeAttribute : Attribute { }
- 实现ASP.NET Core的自定义动作过滤器(比如命名为
SanitizeModelFilter),核心逻辑为:请求参数绑定完成后,遍历参数类的所有属性,对标记了[Sanitize]的string类型字段,调用注入的消毒服务执行清理后赋值回原属性。 - 启动时注册消毒服务和过滤器即可全局生效,示例配置代码:
// Program.cs 注册消毒服务 builder.Services.AddHtmlSanitizer(options => { // 普通文本场景:清空所有允许的标签,直接移除全部HTML内容 options.AllowedTags.Clear(); // 富文本场景:按需配置允许的标签白名单 // options.AllowedTags.AddRange(new[] { "p", "b", "i", "ul", "li" }); }); // 注册自定义消毒过滤器到MVC管道 builder.Services.AddControllers(options => { options.Filters.Add<SanitizeModelFilter>(); });
使用时直接在需要消毒的属性上打标记即可,和你给出的示例完全一致:
public class ClassToSanitze { public int Id {get;set;} [Sanitize] public string Name {get;set;} }
方式2:使用现成封装的扩展包
社区已经基于Ganss.XSS.HtmlSanitizer封装了大量适配ASP.NET Core的扩展包,内置了[Sanitize]特性的自动处理逻辑,安装后无需自行编写过滤器代码,直接为属性添加标记即可生效,适合追求快速落地的项目。
注意:早年微软推出的AntiXSS库已停止维护,不推荐在新项目中使用。消毒逻辑需要根据业务场景区分配置:普通文本输入(如用户名、备注)建议直接移除所有HTML标签;富文本输入(如用户发布的文章)需配置白名单,只过滤危险内容,保留合法的格式标签。
内容的提问来源于stack exchange,提问作者Code one
相关产品推荐
相关产品推荐

