字符串脱敏,输入输出多种处理模式,支持字符、拼音、简拼、同音字等替换模式,支持正则。
$ dotnet add package SensitiveWords字符串脱敏,输入输出多种处理模式,支持字符、拼音、简拼、同音字等替换模式,支持正则。
Install-Package SensitiveWords
// Web注入方式,根据配置自动处理输入输出
services.AddSensitiveWords(sensitiveWordsOptions =>
{
sensitiveWordsOptions.Add(new SensitiveWordsOptions(HandleOptions.Input, ReplaceOptions.Character, "*", true, false, GroupReplaceOptions.GroupPriority)
.Add("牛皮|反对").Build());
sensitiveWordsOptions.Add(new SensitiveWordsOptions(HandleOptions.Output, ReplaceOptions.Character, "*", true, false, GroupReplaceOptions.GroupPriority)
.Add(@"\w{4}(\w+(?:[-+.]\w+)*)@\w+(?:[-.]\w+)*\.\w+(?:[-.]\w+)*")
.Add(@"(?:13[0-9]|14[0-14-9]|15[0-35-9]|16[25-7]|17[0-8]|18[0-9]|19[0-35-9])(\d{4})\d{4}")
.Build()
);
});
// 直接调用
SensitiveWordsResolver.Desensitize("...");
// 扩展方法
"...".Desensitize();
using SensitiveWords;
...
{
// 初始化配置
SensitiveWordsResolver.Config(options =>
{
options.Add(new SensitiveWordsOptions(HandleOptions.Default, ReplaceOptions.Character, "*", true).Add("啊啊|zf|666").Build());
options.Add(new SensitiveWordsOptions(HandleOptions.Default, ReplaceOptions.Character, "?", true).Add("操|文|NM").Build());
options.Add(new SensitiveWordsOptions(HandleOptions.Default | HandleOptions.Output, ReplaceOptions.Character, "*", true, groupReplaceOptions: GroupReplaceOptions.GroupPriority)
.Add(@"\w{4}(\w+(?:[-+.]\w+)*)@\w+(?:[-.]\w+)*\.\w+(?:[-.]\w+)*")
.Add(@"(?:13[0-9]|14[0-14-9]|15[0-35-9]|16[25-7]|17[0-8]|18[0-9]|19[0-35-9])(\d{4})\d{4}")
.Build()
);
});
var text = "zf这是什么操作啊啊……666 nm";
// 扩展方法调用
text.Desensitize(); // Output: **这是什么?作**……*** ??
// 方法调用
SensitiveWordsResolver.Desensitize(text); // Output: **这是什么?作**……*** ??
var mail = "test123@mail.com";
var phone = "13623332333";
// 脱敏默认
mail.Desensitize(); // Output: test***@mail.com
// 脱敏输入
mail.DesensitizeInput(); // Output: test123@mail.com
phone.DesensitizeInput(); // Output: 13623332333
// 脱敏输出
mail.DesensitizeOutput(); // Output: test***@mail.com
phone.DesensitizeOutput(); // Output: 136****2333
// 脱敏所有
mail.DesensitizeAll(); // Output: test***@mail.com
phone.DesensitizeAll(); // Output: 136****2333
SensitiveWordsResolver.Config(options =>
options.Add(new SensitiveWordsOptions(HandleOptions.Default, ReplaceOptions.Character, "*", true, groupReplaceOptions: GroupReplaceOptions.GroupPriority)
.Add(@"政治(?!老师|家)").Build()
)
);
"一个政治老师在谈政治话题".Desensitize(); // Output: 一个政治老师在谈**话题
// 支持拼音等替换模式
SensitiveWordsResolver.Config(options =>
{
options.Add(new SensitiveWordsOptions(HandleOptions.Default, ReplaceOptions.PinYin, null, true, groupReplaceOptions: GroupReplaceOptions.GroupPriority).Add("尘埃|酒").Build());
options.Add(new SensitiveWordsOptions(HandleOptions.Default, ReplaceOptions.JianPin, null, true, groupReplaceOptions: GroupReplaceOptions.GroupPriority).Add("菩提|本来").Build());
options.Add(new SensitiveWordsOptions(HandleOptions.Default, ReplaceOptions.Homophone, null, true, groupReplaceOptions: GroupReplaceOptions.GroupPriority).Add("终身").Build());
});
"菩提本无树,明镜亦非台。本来无一物,何处惹尘埃!知足常乐,终身不辱,今朝有酒今朝醉,明日愁来明日愁。".Desensitize(); // Output: pt本无树,明镜亦非台。bl无一物,何处惹chenai!知足常乐,中伸不辱,今朝有jiu今朝醉,明日愁来明日愁。
}
特性:
IgnoreSensitiveWordsAttributeSensitiveWordsAttribute 通过 new SensitiveWordsOptions().SetTag("Tag") 配置标签SensitiveWordsOptions:敏感词配置选项
HandleOptions 处理选项
Default:默认Input:输入Output:输出ReplaceOptions 替换选项
Character:字符PinYin:拼音JianPin:简拼Homophone:同音字Character 替换字符串 ReplaceOptions.Character 时生效IgnoreCase 忽略大小写ReplaceSingle 替换为单个不补位,默认 false 补位至敏感词长度GroupReplaceOptions 组替换选项
Default:默认替换匹配到的值GroupOnly:只替换正则组GroupPriority:组优先,存在组就替换组不存在就默认替换IsMaxMatch:优先匹配最大长度(正则下不生效)WhiteSpaceOptions:空字符选项
Default:默认不处理IgnoreWhiteSpace:忽略空字符IgnoreNewLine:忽略换行符Tag 标签,可通过特性 SensitiveWordsAttribute 指定处理Add 添加敏感词,多个英文竖线|分隔,包含竖线需要转义,支持正则AddFile 添加文件敏感词,文本内容规则一致SetTag 设置标签Remove 删除敏感词Build 构建敏感词选项(添加删除非正则敏感词后调用生效)多音字词组添加:SensitiveWordsResolver.RegisterHomophoneRegexWordGroup(...) 存在多音字时无法区分,可通过添加词组确定