详解docker API管理接口增加CA安全认证

2022-07-14,,,,

前文中我们曾经介绍过《使用idea远程工具》连接docker rest api,我们会发现一个问题,任何知道docker 服务器ip、端口的第三方都可以访问这个api,非常的不安全。为了保证docker api的安全性,我们有必要使用数字证书进行安全验证。

  • 为docker服务端配置服务端证书,用于验证客户端请求
  • 为访问docker 服务的客户端配置客户端证书,用于验证服务端发送的交互信息的安全性。

如果只在自己公司内部使用到数字证书,就没有必要花钱向专业的ca机构进行认证授权(价格不菲),采用自生成的ca证书在公司内部使用也是完全可以的。下图是ca证书及子证书的签发过程,请结合文章进行理解。

一、模拟创建ca证书(中间边框的部分)

正常情况下ca机构有自己的私钥,因为我们是模拟ca机构,所以这个私钥需要我们自己创建。执行下文中的命令,输入2次密码(密码务必记住,后文中需要使用),执行完命令之后,当前目录下生成一个ca-key.pem文件(上图中红色背景代表)。

# openssl genrsa -aes256 -out ca-key.pem 4096
generating rsa private key, 4096 bit long modulus
e is 65537 (0x10001)
enter pass phrase for ca-key.pem:
verifying - enter pass phrase for ca-key.pem:

该命令用于创建机构ca证书,执行该命令首先会提示输入密码(上文中设置的)。正常请开给你下,该流程是某公司向ca提机构提交自己公司的相关信息,ca授权机构根据这些信息(审核信息之后)生成一个用于该公司的ca证书(该公司范围的根证书)。

openssl req -new -x509 -days 3650 -key ca-key.pem -sha256 -out ca.pem

然后提示需要输入国家、省份、地市、公司、组织、服务器地址或域名、邮箱联系方式,其中国家和服务器地址或域名要填上,否则后续无法使用。

# 国家:cn
country name (2 letter code) [xx]: cn
# 省份: 可以不填,直接回车
state or province name (full name) []:
# 地市:可以不填,直接回车
locality name (eg, city) [default city]:
# 公司: 可以不填,直接回车
organization name (eg, company) [default company ltd]:
# 组织: 可以不填,直接回车
organizational unit name (eg, section) []:
# 服务器地址或域名,按要求填写
common name (eg, your name or your server's hostname) []:  192.168.1.111
# 邮箱联系方式,可以不填,直接回车
email address []:

当前目录下生成一个ca.pem,该证书就是ca证书

二、签发服务器端证书(右边蓝色背景部分)

ca证书还可以用于签发子证书(数字证书),下面我们就模拟签发一个服务端证书。仍然需要先创建一个服务器端私钥server-key.pem

openssl genrsa -out server-key.pem 4096

创建服务器端csrserver.csr,该文件作为向授权机构申请签发子证书的申请文件

openssl req -subj "/cn=192.168.1.111" -sha256 -new -key server-key.pem -out server.csr

模拟授权机构创建配置文件,serverauth表示服务端证书

echo subjectaltname = ip:192.168.1.111,ip:0.0.0.0 >> extfile.cnf 
echo extendedkeyusage = serverauth >> extfile.cnf

创建服务器端证书会提示输入密码,输入上文中设置的密码即可。

openssl x509 -req -days 3650 -sha256 -in server.csr -ca ca.pem -cakey ca-key.pem -cacreateserial -out server-cert.pem -extfile extfile.cnf

生成2个文件ca.srl、server-cert.pem,我们需要的是server-cert.pem作为服务端ca证书

三、签发客户端证书(左边黄色背景的部分)

下面我们就模拟签发一个客户端证书。仍然需要先创建一个客户端私钥key.pem

openssl genrsa -out key.pem 4096

创建客户端csrclient.csr,该文件作为向授权机构申请签发子证书的申请文件

openssl req -subj '/cn=client' -new -key key.pem -out client.csr

模拟授权机构创建配置文件,clientauth 表示客户端证书

echo extendedkeyusage = clientauth >> extfile.cnf

执行下列命令同样会提示输入密码,生成2个文件ca.srlcert.pem,我们需要的是cert.pem作为客户端证书

openssl x509 -req -days 3650 -sha256 -in client.csr -ca ca.pem -cakey ca-key.pem -cacreateserial -out cert.pem -extfile extfile.cnf

四、签发证书收尾工作

删除证书签发请求文件,已经失去用处。

rm -v client.csr server.csr

为上文中生成的各种证书授予文件访问权限。

chmod -v 0400 ca-key.pem key.pem server-key.pem;
chmod -v 0444 ca.pem server-cert.pem cert.pem;

查看ca证书有效期

# openssl x509 -in ca.pem -noout -dates
notbefore=apr 10 01:17:55 2022 gmt
notafter=apr  7 01:17:55 2032 gmt

五、配置docker服务端

然后我们为docker服务端配置证书,分别是ca.pem、server-cert.pem、server-key.pem。将这三个文件放入/etc/docker/cert/目录下。

mkdir /etc/docker/cert/;
cp ./ca.pem ./server-cert.pem ./server-key.pem  /etc/docker/cert/;

修改vim /lib/systemd/system/docker.service文件中的execstart这一行,修改为如下的一段

execstart=/usr/bin/dockerd --tlsverify --tlscacert=/etc/docker/cert/ca.pem --tlscert=/etc/docker/cert/server-cert.pem --tlskey=/etc/docker/cert/server-key.pem -h tcp://0.0.0.0:2375 -h unix:///var/run/docker.sock

修改之后重启docker服务

#重启
systemctl daemon-reload && systemctl restart docker

六、idea配置使用客户端证书

我们在idea docker插件客户端证书配置处做如下选择:“file -> settings -> build、execution、deployment -> docker”

  • engine api url的位置写https://<ip>:2375,记住是https,不是http,也不是tcp
  • 将客户端的需要的三个证书文件ca.pem、cert.pem、key.pem放入一个目录下,并使选择该目录作为certificates folder。

到此这篇关于docker api管理接口增加ca安全认证的文章就介绍到这了,更多相关docker 增加ca安全认证内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!

《详解docker API管理接口增加CA安全认证.doc》

下载本文的Word格式文档,以方便收藏与打印。