conf

README

conf模块 实现说明

conf文件结构

整体结构

config 文件以yaml格式为准，整体分为: Global,MaskRules,Rules 三个部分。其中：

1. Global

包含影响DLP全局的一些配置项，例如API版本、禁用的规则ID、是否启用后端服务辅助判断。

1. MaskRules

包含脱敏操作的配置，例如打码、替换等方式。

1. Rules

包含识别和处理规则，其中一个识别过程包括 Detect, Filter 和 Verify 三个依次的过程， 处理需要引用上面定义的脱敏规则。

Global

Global配置项包含全局生效的配置，其中大部分通过名字可以理解其作用，剩下的配置项在这里说明:

• AllowRPC : 是否启用后端服务辅助判断结果，如果调用量巨大，期望高性能处理，就选择 false, 代表关闭后端服务辅助。
• DisableRules: 禁用的规则ID，一般用于修改系统默认规则，可以先禁用系统规则，然后根据原来的规则补充修改成一个自定义规则。

MaskRules

MaskRules 配置项包含脱敏规则，是一个脱敏规则的列表，其中每个脱敏规则包含如下配置项：

• RuleName: 脱敏规则名称，用于Mask() API调用或者是被后面的识别处理规则所引用。

• MaskType: 脱敏类型，目前支持的类型有，[CHAR, TAG, REPLACE, ALGO ]。其中：

  CHAR: 用字符替换敏感信息，需要用到后面更详细的配置项。 TAG: 用识别和处理规则中的InfoType, 以<InfoType>的形式替换敏感信息。 REPLACE: 用Value定义的字符串，替换敏感信息，可以设定为空串，用于直接抹除。 ALGO: 用Value定义的算法函数，处理敏感信息，用算法返回值替换原文，目前支持的算法有 [BASE64, MD5, CRC32]

• Value: 在不同脱敏类型中，传入不同的值

• Offset: 替换原文时，从Offset规定的偏移位置开始替换

• Length: 替换原文时，最多替换Length个byte的长度，0代表全替换

• Reverse: 是否从后往前替换

• IgnoreCharSet: 在 CHAR 脱敏类型中，如果遇到IgnoreCharSet字符串里面的CHAR，就不替换，例如邮箱就不替换@符号，忽略的符号不影响Length的计算

• IgnoreKind: 类似上面忽略符号，只是统一一些类型，支持的类型有 [NUMERIC 数字0-9, ALPHA_UPPER_CASE 大写字母, ALPHA_LOWER_CASE 小写字母, WHITESPACE 空白符, PUNCTUATION 标点符号] ， 具体定义见实现代码

默认conf文件

conf.yml 这个文件是DLP内置的默认conf文件。

Documentation

Overview

Package conf provides configuration handler for dlp

Index

• type DlpConf
  • func NewDlpConf(confString []byte) (*DlpConf, error)
  • func NewDlpConfByPath(confPath string) (*DlpConf, error)
  • func (I *DlpConf) Verify() error
• type MaskRuleItem
• type RuleItem

Types

type DlpConf

type DlpConf struct {
	Global struct {
		Date           string  `yaml:"Date"`
		ApiVersion     string  `yaml:"ApiVersion"`
		Mode           string  `yaml:"Mode"`
		AllowRPC       bool    `yaml:"AllowRPC"`
		EnableRules    []int32 `yaml:"EnableRules,flow"`
		DisableRules   []int32 `yaml:"DisableRules,flow"`
		MaxLogInput    int32   `yaml:"MaxLogInput"`
		MaxRegexRuleID int32   `yaml:"MaxRegexRuleID"`
	} `yaml:"Global"`
	MaskRules []MaskRuleItem `yaml:"MaskRules"`
	Rules     []RuleItem     `yaml:"Rules"`
}

func NewDlpConf

func NewDlpConf(confString []byte) (*DlpConf, error)

NewDlpConf creates DlpConf object by conf content string

func NewDlpConfByPath

func NewDlpConfByPath(confPath string) (*DlpConf, error)

NewDlpConfByPath creates DlpConf object by confPath

func (*DlpConf) Verify

func (I *DlpConf) Verify() error

type MaskRuleItem

type MaskRuleItem struct {
	RuleName      string   `yaml:"RuleName"`
	MaskType      string   `yaml:"MaskType"` // one of [CHAR, TAG, REPLACE, EMPTY, ALGO ]
	Value         string   `yaml:"Value"`
	Offset        int32    `yaml:"Offset"`
	Padding       int32    `yaml:"Padding"`
	Length        int32    `yaml:"Length"`
	Reverse       bool     `yaml:"Reverse"`
	IgnoreCharSet string   `yaml:"IgnoreCharSet"`
	IgnoreKind    []string `yaml:"IgnoreKind"` // one of [NUMERIC, ALPHA_UPPER_CASE, ALPHA_LOWER_CASE, WHITESPACE, PUNCTUATION]
}

type RuleItem

type RuleItem struct {
	RuleID      int32  `yaml:"RuleID"`
	InfoType    string `yaml:"InfoType"`
	Description string `yaml:"Description"`
	EnName      string `yaml:"EnName"`
	CnName      string `yaml:"CnName"`
	Level       string `yaml:"Level"` // L1 (least Sensitive) ~ L4 (Most Sensitive)
	// (KReg || KDict) && (VReg || VDict)
	Detect struct {
		KReg          []string `yaml:"KReg"`          // Regex List for Key
		KDict         []string `yaml:"KDict,flow"`    // Dict for Key
		VReg          []string `yaml:"VReg"`          // Regex List for Value
		VDict         []string `yaml:"VDict,flow"`    // Dict for Value
		KRelation     string   `yaml:"KRelation"`     // Relation for Key
		VRelation     string   `yaml:"VRelation"`     // Relation for Value
		KAndVRelation string   `yaml:"KAndVRelation"` // Relation for Key And Value
	} `yaml:"Detect"`
	// result which is hit by blacklist will not returned to caller
	Filter struct {
		// BReg || BDict
		BReg  []string `yaml:"BReg"`       // Regex List for BlackList
		BDict []string `yaml:"BDict,flow"` // Dict for BlackList
		BAlgo []string `yaml:"BAlgo"`      // Algorithm List for BlackList, one of [ MASKED ]
	} `yaml:"Filter"`
	// result need pass verify process before retured to caller
	Verify struct {
		// CReg || CDict
		CReg  []string `yaml:"CReg"`       // Regex List for Context Verification
		CDict []string `yaml:"CDict,flow"` // Dict for Context Verification
		VAlgo []string `yaml:"VAlgo"`      // Algorithm List for Verification, one of [ IDVerif , CardVefif ]
	} `yaml:"Verify"`
	Mask    string            `yaml:"Mask"` // MaskRuleItem.RuleName for Mask
	ExtInfo map[string]string `yaml:"ExtInfo"`
}