写点什么

Nacos 中的配置文件如何实现加密传输

作者:江南一点雨
  • 2022-11-28
    广东
  • 本文字数:2188 字

    阅读完需:约 7 分钟

Nacos 中的配置文件如何实现加密传输

小伙伴们知道,Spring Cloud Config 很早就提供了配置文件的加解密功能,并且支持对称加密和非对称加密两种不同的模式。Nacos 作为分布式配置中心+服务注册中心的合体,在配置文件加密这块一直差点意思,不过好在,如果你使用的 Nacos 版本大于 2.0.4 这个版本,那么现在也可以通过插件的方式来实现配置文件加密了。

1. 配置文件加密

松哥在之前的微服务视频中讲过,Spring Cloud Config 的对称加密和非对称加密,加密后的文件格式类似下面这样:


name={cipher}密文password={cipher}密文
复制代码


可以看到,在 Spring Cloud Config 中,对配置文件的加密是针对字段一个一个加密的。


而 Nacos 中的加密,则是对整个配置文件的内容进行加密,这点和 Spring Cloud Config 不同。


Nacos 中是通过 SPI 的机制抽象出加密和解密的操作,Nacos 默认提供 AES 对称加密的实现,不过用户也可以自定义加解密的实现方式。


在 Nacos 服务端启动的时候就会加载所有依赖的加解密算法,然后通过发布配置的 dataId 的前缀来进行匹配是否需要加解密和使用的加解密算法。


客户端发布的配置会在客户端通过 filter 完成加解密,也就是配置在传输过程中都是密文的,而控制台发布的配置会在服务端进行处理。


换言之,用了 Nacos 的配置文件加密插件之后,我们在 Nacos 管理页面上配置的配置文件,将会以加密的密文形式存储在数据库中,也会以密文的形式传输到客户端,然后在客户端自动完成解密操作。大致上就是这样一个过程。接下来我们就来看看具体的用法。

2. 实践

首先我们需要下载 nacos 源码进行编译,编译完成之后,需要将之安装到本地 Maven 仓库(因为编译加密插件需要用到 Nacos)。


首先 clone nacos 源码,如下:


git clone https://github.com/alibaba/nacos.git
复制代码


下载之后,个人建议用 IDEA 去编译,操作方便一些(因为后续还有其他操作)。


所以我们先用 IDEA 打开项目,确认项目所需依赖均已下载完毕,然后点击 install 按钮,将项目编译安装到本地仓库:



接下来 clone 配置文件加解密的插件,如下:


git clone https://github.com/nacos-group/nacos-plugin.git
复制代码


也用 IDEA 打开这个插件项目。这个插件编译要用到我们刚刚编译安装好的 Nacos,但是给的版本号不对,需要我们手动修改下,位置在 nacos-plugin/pom.xml,修改里边 Nacos 的版本号,从 2.2.0-SNAPSHOT 改为 2.2.0-BETA(我刚刚编译安装的是这个版本,大家根据自己的实际情况选择):


<alibaba-nacos.version>2.2.0-BETA</alibaba-nacos.version>
复制代码


改完之后也执行 install 操作,将所有的插件都安装到本地仓库:



接下来回到一开始的 Nacos 项目中,在 Nacos 项目中引入这个插件的依赖,建议在 config 模块中引入,如下图:



引入内容如下:


<dependency>    <groupId>com.alibaba.nacos</groupId>    <artifactId>nacos-aes-encryption-plugin</artifactId>    <version>1.0.0-SNAPSHOT</version></dependency>
复制代码


加了这个依赖之后,我们的 Nacos 就具备了配置文件加密功能了。


现在我再改一下 console/src/main/resources/application.properties 配置文件,让 Nacos 将数据存入到本地数据库中,如下:


### Count of DB:db.num=1spring.sql.init.platform=mysql### Connect URL of DB:db.url.0=jdbc:mysql://127.0.0.1:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTCdb.user=rootdb.password=123
复制代码


配置完成后,本地提前准备好一个名为 nacos_config 的数据库,并执行 distribution/conf/mysql-schema.sql 脚本文件,将所需的表先创建出来。


接下来,为项目添加启动参数,我们以单机而不是集群的方式来启动 Nacos,如下:



上图大家重点看两个地方,一个是启动类所处的位置,另外一个则是启动参数。


好啦,现在我们就可以像启动 Spring Boot 项目那样启动 Nacos 了。

3. 发布

如果我们想将项目打包发布的话,松哥建议大家先从 GitHub 上下载官方的压缩包,官方的压缩包里边,有一个 target 目录,这个目录下有一个 nacos-server.jar 文件,这个就是 nacos 的启动包了。对于这个官方的压缩包,大家正常配置就行了。


然后,在 IDEA 中,对我们刚刚处理过的 nacos,重新打包,不过记得打包的时候设置一下环境,如下:



设置好环境之后,然后对项目重新进行打包。打包完成后,生成了新的 nacos-server.jar,如下:



用这个 jar 包替换掉官方压缩包中的 jar,然后启动 nacos 即可。

4. 访问

启动成功之后,我们就可以直接访问 nacos 了,用法和平时用法都一样,不同的是,在创建配置文件的时候,文件名有一个固定的前缀 cipher-aes-,有了这个前缀,这个配置文件就会自动加密,否则就不会加密。


例如我现在创建如下配置文件:



创建完成后,我们去数据库中看一下这个配置文件:



可以看到,这个 content 字段已经是一个加密的字符串了(如果没有我们没有加密,则 content 字段保存的就是明文 name=javaboy)。


现在我们创建一个项目,来加载这个加密的配置文件。


创建项目时候,选择 Nacos Configuration,如下:



创建好之后,记得手动加上刚刚的那个加密插件的依赖(解密的时候会用到)。


项目名称记得设置为 cipher-aes-nacos


# 应用名称spring.application.name=cipher-aes-nacos# 应用服务 WEB 访问端口server.port=8080
复制代码


其他都正常配置即可。


好啦,大功告成!Nacos 配置文件加密就实现啦~

发布于: 刚刚阅读数: 3
用户头像

技术宅 2019-04-09 加入

Java猿

评论

发布
暂无评论
Nacos 中的配置文件如何实现加密传输_nacos_江南一点雨_InfoQ写作社区