You need to enable JavaScript to run this app. 如何为Web API模型属性添加防XSS装饰特性,有可过滤脚本标签的消毒类库吗
优惠活动
大模型
产品
解决方案
定价
更多

如何为Web API模型属性添加防XSS装饰特性,有可过滤脚本标签的消毒类库吗

.NET Web API XSS属性消毒方案

成熟可用的类库

  • Ganss.XSS.HtmlSanitizer:目前.NET生态维护最活跃、符合OWASP防护规范的开源HTML消毒库,支持自定义标签/属性白名单,可精准过滤script标签、内联事件、恶意样式等各类XSS注入内容,依赖少、性能稳定,是生产场景的首选。
  • SanitizeHtml.Net:轻量型替代方案,区分普通文本、富文本两种消毒模式,配置灵活,适合对包体积有要求的小型项目。

实现[Sanitize]特性自动消毒的方式

基于上述类库,可通过两种方式实现你需要的属性标记效果,无需在每个接口中手动编写消毒逻辑:

方式1:自定义特性+管道钩子(灵活可控)

  1. 先定义用于标记需要消毒属性的特性类:
[AttributeUsage(AttributeTargets.Property)]
public class SanitizeAttribute : Attribute
{
}
  1. 实现ASP.NET Core的自定义动作过滤器(比如命名为SanitizeModelFilter),核心逻辑为:请求参数绑定完成后,遍历参数类的所有属性,对标记了[Sanitize]的string类型字段,调用注入的消毒服务执行清理后赋值回原属性。
  2. 启动时注册消毒服务和过滤器即可全局生效,示例配置代码:
// 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 20:45:02