Rails 构建镜像安全处理加密凭证

最近在做一个小的 Side Project 作为公共服务首要是需要保证用户数据的绝对安全，这就需要对数据库数据做加密处理。

Rails 5.2 开始支持 credentials.yml.enc 加密凭证， 6.0 支持多环境的 credentials 加密凭证， 7.0 支持对 model 数据库表字段加密处理，但我从 5.1 支持 secrets.yml 开始就没使用过。 最近一周开发加摸索下来，总结一句话：一直加密一直爽，容器化奔赴火葬场。

机制原理

初始化一个 Rails 5.2+ 项目会在项目根目录 config 生成 master.key 和 credentials.yml.enc 两个文件，前者可以理解为核心密钥，后者是用核心密钥通过 ActiveSupport::EncryptedConfiguration 加密类生成的加密后的数据文件。

只需要保证 master.key 不会泄露，通过 rails credentials:edit 配置服务所需的各自私密 token、secret key 之类也可以安全的提交到 Git 仓库中。

存储路径

密钥和加密后的文件会存在如下目录：

 1# 缺省
 2config/master.key
 3config/credentials.yml.enc
 4
 5# Rails 生产环境决定 (6.0 开始支持)
 6# 如下分别对应 development 和 production 环境
 7config/credentials/development.key
 8config/credentials/development.yml.enc
 9
10config/credentials/production.key
11config/credentials/production.yml.enc

触发机制

只要运行的代码会涉及 config/environment.rb 文件解密流程就会自动被触发，比如：

• rails server
• rails console
• Rakefile 附加 :environment 参数的所有 tasks

常见加解密报错

解密机制被触发的那一刻，它会从存储路径从缺省到当前生产环境去寻找对应的文件，master key 会优先读取 RAILS_MASTER_KEY 环境变量的值，没有才会去存储文件读取，都没有找到就报错 MissingKeyError 错误。

master key 在 Rails 5.2 ~ 7 版本密钥的长度必须符合 aes-128-gcm 也就是 32 字节，设置错误会得到 InvalidKeyLengthError 错误。

*.enc 文件不存在会触发 MissingContentError 错误。

其他的错误还有可能是：

1# 通常是 credentials.yml.enc 文件缺失或未设置 secret_key_base (SECRET_KEY_BASE) 的值
2ArgumentError: Missing `secret_key_base` for 'production' environment, set this string with `bin/rails credentials:edit`
3
4# master key 密钥不正确无法解密
5Unable to load application: ActiveSupport::MessageEncryptor::InvalidMessage: ActiveSupport::MessageEncryptor::InvalidMessage
6
7# 错误同上
8OpenSSL::Cipher::CipherError

成就大体都列出来了，至于你能到哪步就看你的造化了（开玩笑）。

数据库字段加密

Rails 默认并不会对数据库字段加密，在 7.0 开始允许开发者定义加密字段也允许自定义加解密方法。这个不是本文的讨论范围不再展开。

初始化需要通过如下命令生成一个随机的 Keys：

1$ rails db:encryption:init
2Add this entry to the credentials of the target environment:
3
4active_record_encryption:
5  primary_key: KMw07GoiPScVwtmoNxlBv7YibFCnB4dU
6  deterministic_key: CTttlez04KZcy3MCMFtZ8FUEopSAmJOr
7  key_derivation_salt: FwUgrDWHX3wN7kKw5gYSsYEgzxRnYBWh

在通过 rails credentials:edit 把上端加密串加到 credentials 里面保存即可，不同的加密串是无法解密已经存在数据库中的数据的，切记！切记！切记！ 否则你会再获得一个成就 ActiveRecord::Encryption::Errors::Decryption 报错。

镜像构建处理

恭喜你，从现在开始你本应当直面恐惧，可惜你发现了我这篇文章缺少了点悲惨的经历。

制作 Docker 镜像无论什么情况都要保证不会包含任何私密数据，Rails 绕不开的点主要是 rails assets:complie。 上面我也说了只要涉及 :environment 参数的所有 tasks 都会走解密流程，它也不例外。

构建方面我通过三种方式来解析如果从不安全到安全的构建过程：

🚫 最不安全的方式

镜像构建允许设置 build-arg 传递：

 1FROM ruby:3.0.3
 2
 3ARG master_key
 4ENV RAILS_MASTER_KEY=$master_key
 5ENV RAILS_ENV=production
 6
 7# 省略
 8...
 9
10RUN bin/rails assets:complie
11# 或者
12RUN RAILS_MASTER_KEY=$master_key bin/rails assets:complie

执行构建命令 docker build -t app --build-arg master_key=[32bits-length-key] . 构建后虽然可以获得镜像，但构建时设置的值也被封装在了容器中，就算没有封装到容器中使用 docker history 也可以看到，因此这种方式是绝对不可取的。

⭕️ 改进版

你可能会看到有些镜像的 Dockerfile 里面会包含多个 FROM 的多阶段构建。这个是为了利用隔离资源，重复利用缓存机制的方式使得最终的容器极可能的小和安全。我们可以利用它把私密数据隔离在前面的临时镜像中。

 1FROM ruby:3.0.3 as builder
 2
 3ARG workspace=/app
 4ARG master_key
 5ENV RAILS_MASTER_KEY=$master_key
 6ENV RAILS_ENV=production
 7
 8# 省略
 9...
10
11WORKDIR $workspace
12RUN bin/rails assets:complie
13
14# 省略
15...
16
17FROM ruby:3.0.3-slim
18
19# 省略
20...
21
22COPY --from=builder $workspace $workspace

镜像存在 builder 和一个缺省名字（通常是 stage-N, N 是数字从 1 开始）两个阶段，第一阶段是最不安全方式的实现方式，这里在最后一个阶段通过一个干净安全的镜像把上一个阶段的结果文件复制过来就达成了第一个阶段中私密数据泄露的问题。

这种方式也是当前大多数人会应用的方式，尤其利用 Github Action 的 Encrypted secrets 功能从某种程度上杜绝了隐私数据的泄露。

✅ 加强版

Buildkit 是 Docker 新一代镜像构建工具，启用可以通过配置环境变量 DOCKER_BUILDKIT=1 或在 Docker 配置文件的 features 字典增加 "buildkit" : "true"。

由于采用新的构建工具，额外还需要在 Dockerfile 头部显性声明新的语法：syntax = docker/dockerfile:1.2 配合 新的构建 secret

 1# syntax = docker/dockerfile:1.2
 2FROM ruby:3.0.3
 3
 4ARG workspace=/app
 5WORKDIR $workspace
 6
 7# 省略
 8...
 9
10RUN --mount=type=secret,id=master_key,target=config/master.key,required=true \
11    bin/rails assets:precompile

构建命令执行需要通过 buildx CLI 子命令来完成：

1$ docker buildx build \
2  --secret id=master_key,src=config/master.key \
3  -t app .

结合 –mount-type=secret 支持的参数:

id 关联 CLI 传参和构建镜像中执行步骤，CLI 入参设置 secret 的输入文件，构建镜像则需要把 secret 导出到镜像中具体的路径，其实就是这么简单。极少数支持 Docker 部署的云服务，比如 Render 支持这种方式。部署到云服务上还需要重新考量下。

本篇小结

折腾一圈终于获得了一个干净、安全的镜像，等到部署时又傻眼了。面向技术人员或公司的项目倒还好，初始化时通过命令一通操作配置完也不需要处理 master key 不匹配的情况。 无论使用上面改进版还是加强版都能过顺利跑起来。如果 Docker 镜像是要面向客户的话，怎么让他们初始化一个属于他们自己的 master key 和加密数据呢？开始挠头了吧。

未完待续… 翻看答案。

参考资源

• Railsのcredentials.yml.encとmaster keyをDockerで安全に扱う
• Don’t leak your Docker image’s build secrets

如果你觉得我的文章对你有帮助，欢迎打赏，这对我非常重要，谢谢！