Apache ShardingSphere 数据脱敏 YAML 配置详解

晏灵昀Odette

于 2025-06-02 09:00:06 发布

阅读量284

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/gitblog_00173/article/details/148374547

Apache ShardingSphere 数据脱敏 YAML 配置详解

shardingsphere Distributed SQL transaction & query engine for data sharding, scaling, encryption, and more - on any database. 项目地址: https://gitcode.com/gh_mirrors/sh/shardingsphere

数据脱敏技术概述

在现代数据安全领域，数据脱敏是一项至关重要的技术，它通过对敏感数据进行变形、替换或部分隐藏，确保数据在开发、测试或分析环境中使用时不会泄露真实信息。Apache ShardingSphere 提供了强大的数据脱敏功能，可以无缝集成到现有系统中，而无需修改业务代码。

YAML 配置的优势

YAML 配置方式因其良好的可读性和简洁性，成为 ShardingSphere 中配置数据脱敏规则的首选方式。相比编程式配置，YAML 具有以下优势：

直观清晰：通过缩进和层级关系，可以一目了然地看到表、列和脱敏算法之间的关系
易于维护：修改配置无需重新编译代码，只需更新 YAML 文件即可
快速部署：配置变更可以快速应用到生产环境
版本可控：YAML 文件可以纳入版本控制系统进行管理

核心配置结构解析

ShardingSphere 的数据脱敏配置主要包含两个核心部分：

1. 表级脱敏规则配置

rules:
- !MASK
  tables:
    t_user:  # 表名
      columns:
        password:  # 列名
          maskAlgorithm: md5_mask  # 使用的脱敏算法

这部分定义了哪些表的哪些列需要进行脱敏处理，以及每个列使用的具体脱敏算法。

2. 脱敏算法定义

maskAlgorithms:
  md5_mask:  # 算法名称
    type: MD5  # 算法类型
  mask_before_special_chars_mask:
    type: MASK_BEFORE_SPECIAL_CHARS
    props:
      special-chars: '@'
      replace-char: '*'

这部分定义了具体的脱敏算法实现及其参数配置。ShardingSphere 提供了多种内置算法，也可以扩展自定义算法。

常用脱敏算法详解

ShardingSphere 内置了多种实用的脱敏算法，以下是几种典型算法的说明：

MD5 算法：
- 类型：MD5
- 特点：将原始值转换为 MD5 哈希值，不可逆
- 适用场景：密码等需要完全隐藏原始值的数据
特殊字符前脱敏：
- 类型：MASK_BEFORE_SPECIAL_CHARS
- 参数：
  - special-chars：指定的特殊字符
  - replace-char：替换字符
- 示例：example@domain.com → *******@domain.com
- 适用场景：邮箱地址等包含特定分隔符的数据
保留前后几位：
- 类型：KEEP_FIRST_N_LAST_M
- 参数：
  - first-n：保留前N位
  - last-m：保留后M位
  - replace-char：中间部分的替换字符
- 示例：手机号 13812345678 → 138****5678
- 适用场景：电话号码、身份证号等需要部分展示的数据

完整配置示例解析

下面我们通过一个完整的配置示例来理解各个部分的实际应用：

dataSources:
  unique_ds:
    dataSourceClassName: com.zaxxer.hikari.HikariDataSource
    driverClassName: com.mysql.jdbc.Driver
    jdbcUrl: jdbc:mysql://localhost:3306/demo_ds
    username: root
    password:

rules:
- !MASK
  tables:
    t_user:
      columns:
        password:
          maskAlgorithm: md5_mask
        email:
          maskAlgorithm: mask_before_special_chars_mask
        telephone:
          maskAlgorithm: keep_first_n_last_m_mask

  maskAlgorithms:
    md5_mask:
      type: MD5
    mask_before_special_chars_mask:
      type: MASK_BEFORE_SPECIAL_CHARS
      props:
        special-chars: '@'
        replace-char: '*'
    keep_first_n_last_m_mask:
      type: KEEP_FIRST_N_LAST_M
      props:
        first-n: 3
        last-m: 4
        replace-char: '*'

这个配置实现了：