字段加解密

FieldEncrypt：对指定字段执行加密或解密

描述

FieldEncrypt 转换插件用于使用对称加密算法，对记录中的指定字段进行加密或解密。

参数说明

参数名	类型	是否必填	默认值	描述
fields	Array	是	-	需要加密或解密的字段列表
algorithm	String	否	AES_CBC	加密算法
key	String	是	-	Base64 编码的加密密钥
mode	String	否	ENCRYPT	操作模式：ENCRYPT 或 DECRYPT

algorithm [string]

用于指定该 transform 所使用的加密算法。

支持的值：

• AES_GCM：默认值。采用 GCM 模式并包含认证标签（Authentication Tag）的 AES 加密。
• AES_CBC：采用 CBC 模式及 PKCS5 填充（Padding）的 AES 加密。

AES_GCM 提供认证加密（Authenticated Encryption），安全性更高，推荐使用。

如果未明确指定，系统将默认使用 AES_GCM。

key [string]

加密密钥必须以 Base64 编码格式提供。 请确保密钥长度符合所选加密算法的要求。

对于 AES_GCM 和 AES_CBC，支持的密钥长度为 16、24 或 32 字节 （分别对应 AES-128、AES-192 和 AES-256）。

示例

• base64:AAAAAAAAAAAAAAAAAAAAAA==
• AAAAAAAAAAAAAAAAAAAAAA==

common options [string]

Transform 插件的通用参数，请参考 Transform Plugin。

示例

字段加密

transform {
  FieldEncrypt {
    fields = ["name"]
    key = "base64:AAAAAAAAAAAAAAAAAAAAAA=="
    algorithm = "AES_CBC"
    mode = "encrypt"
  }
}

字段解密

transform {
  FieldEncrypt {
    fields = ["name"]
    key = "base64:AAAAAAAAAAAAAAAAAAAAAA=="
    algorithm = "AES_CBC"
    mode = "decrypt"
  }
}