Ansible 加密模块 Vault

2024-03-14 13:54:22

ansible-vault 只要用于配置文件加密，可以加密或解密，具体使用方式如下：

Usage: ansible-vault [create|decrypt|edit|encrypt|encrypt_string|rekey|view] [options] [vaultfile.yml]

可以看到有很多子命令：

create: 创建一个新文件，并直接对其进行加密
decrypt: 解密文件
edit: 用于编辑 ansible-vault 加密过的文件
encrypy: 加密文件
encrypt_strin: 加密字符串，字符串从命令行获取
view: 查看经过加密的文件

加密文件

先自己创建一个文件，写入一些内容：

[root@Ansible ~]# echo "123456" > pass.txt
[root@Ansible ~]# cat pass.txt 
123456
[root@Ansible ~]#

然后用 ansible-vault encrypt 加密文件：

[root@Ansible ~]# ansible-vault encrypt pass.txt
New Vault password: 
Confirm New Vault password: 
Encryption successful
[root@Ansible ~]#

这里会要求输入密码。

现在再去打开文件看看：

[root@Ansible ~]# cat pass.txt 
$ANSIBLE_VAULT;1.1;AES256
62633762393035316438663662343964656465376634393131313466313536336361333163313238
6162356161653365623961353533356264386134653830640a353531623635653337636564383763
38316636383334323533363666383963666161633332663461316338333332623434376162326265
6565623130373539330a313737646431626131336637663033656664383932393934633337383666
6334
[root@Ansible ~]#

查看文件内容，可以用 ansible-vault view 命令：

[root@Ansible ~]# ansible-vault view pass.txt
Vault password: 
123456
[root@Ansible ~]#

把文件还原可以用 ansible-vault decrypt 命令：

[root@Ansible ~]# ansible-vault decrypt pass.txt
Vault password: 
Decryption successful
[root@Ansible ~]# cat pass.txt 
123456
[root@Ansible ~]#

加密配置文件

上面的演示内容只是一个小工具的单独使用，这里看看结合ansible命令的使用。
在/etc/ansible/hosts文件中新加一台主机用于测试：

host1 ansible_host=127.0.0.1 ansible_connection=local

这里加的就是本机。

然后单独创建这台主机的变量文件 /etc/ansible/host_vars/host1 ，随便写入一些变量：

---
key1: vaule1
key2: VALUE2

先来验证一下：

[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key2={{key2}}" 
host1 | CHANGED | rc=0 >>
key1=vaule1, key2=VALUE2
[root@Ansible ~]#

现在把配置文件加密：

[root@Ansible ~]# ansible-vault encrypt /etc/ansible/host_vars/host1 
New Vault password: 
Confirm New Vault password: 
Encryption successful
[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key2={{key2}}" 
ERROR! Attempting to decrypt but no vault secrets found
[root@Ansible ~]#

加密后再运行就不管用了，这里需要加一个参数 --ask-vault-pass 来提供vault加密的密码：

[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key2={{key2}}"  --ask-vault-pass
Vault password: 
host1 | CHANGED | rc=0 >>
key1=vaule1, key2=VALUE2
[root@Ansible ~]#

使用文件加密

之前都是直接使用密码进行加密。对我们来说，其实只是把一个密码用另一个密码加密了。在使用的时候，我们不使用原来的密码，而是使用vault的密码。
为了方便不用每次都输入密码，可以把密码写在文件中。不过直接把密码明文写在文件中总是不安全的。利用 ansible-vault 就是让我们可以把密码直接写在配置中（也可以是一个单独的配置文件），然后把有敏感信息的文件加密。这样做的好处是，整个项目所有的配置信息都是全的，包括项目中使用的密码，并且是加密的。
如果每次使用时仍然不想输入密码，也可以把vault的密码写到文件中（明文的），这样每次使用时就不是手动输入，而是让ansible自动从文件中获取这个密码。

还是重复使用之前的配置文件，先把文件进行解密：

[root@Ansible ~]# ansible-vault decrypt /etc/ansible/host_vars/host1 
Vault password: 
Decryption successful
[root@Ansible ~]#

然后再生成文件后用文件进行加密：

[root@Ansible ~]# echo "123456" > vault-pass-file
[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key2={{key2}}"
ERROR! Attempting to decrypt but no vault secrets found
[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key2={{key2}}" --vault-password-file vault-pass-file
host1 | CHANGED | rc=0 >>
key1=vaule1, key2=VALUE2
[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key2={{key2}}" --ask-vault-pass
Vault password: 
host1 | CHANGED | rc=0 >>
key1=vaule1, key2=VALUE2
[root@Ansible ~]#

这里最后还试了一下使用密码 --ask-vault-pass 效果其实和使用 --vault-password-file 是一样的。一个是手动输入密码，一个是从文件中读取密码字符串。

加密变量

上面的加密方式是加密整个文件。加密后，文件中敏感的内容不敏感的内容就都看不到了，这样也很不方便。一个解决办法是把敏感的和不敏感的内容分开，写在不同的文件中，只加密敏感文件。就像之前的示例中那样。
还有一个更灵活的方式，使用 ansible-vault encrypt_string 把值进行加密。

通过文件加密

准备好用作vault认证的文件：

[root@Ansible ~]# ansible-vault encrypt_string --vault-id vault-pass-file 'ssh_pass' --name 'key3'
key3: !vault |
          $ANSIBLE_VAULT;1.1;AES256
          66613666353739356536663965336234383363373563353231353939303839313430616161336365
          6662336162386231316132633365366232363936613561650a313637643339323861626364633864
          32653666626333623961643866656235653764646333613533343231303734313862376232393734
          6563343539393264650a653438326463646364646338656339356236383537663135633935313239
          3664
Encryption successful
[root@Ansible ~]#

参数--name，可以不写。写上后最后生成的内容就是带key的，否则只是生成值的部分，key我们也可以手动加上。

手动输入密码

如果不使用文件，而是要手动输入，可以将指定的文件名替换为prompt，这样就会让我们输入2次密码确认了：

[root@Ansible ~]# ansible-vault encrypt_string --vault-id prompt 'ssh_pass' --name 'key3'
New vault password (default): 
Confirm new vault password (default): 
key3: !vault |
          $ANSIBLE_VAULT;1.1;AES256
          30666333366265346464383165373062613165666130373066613930316364363432376336613938
          3131663337633863373539666134643661623734613330350a616661613934633335303365366266
          36363433613334386664663839346435656534373732333632303532303939383466303662396438
          3433633535333130350a323934373162356139363762383739386139333937666237613564313939
          3137
Encryption successful
[root@Ansible ~]#

加上用户标识

官方的文档如下：
https://docs.ansible.com/ansible/latest/network/getting_started/first_inventory.html#protecting-sensitive-variables-with-ansible-vault

在官方文档的示例中 --vault-id 的参数值，都是加上了用户名称表示的，加在文件名或者prompt前，用@隔开：

$ ansible-vault encrypt_string --vault-id steed@vault-pass-file 'ssh_pass' --name 'key3'
$ ansible-vault encrypt_string --vault-id steed@prompt 'ssh_pass' --name 'key3'

貌似也没什么用，但是生成的内容中会有这个用户标识。还是尽量参考官方的建议来比较好。

生成一个新的变量，将加密的值写到配置文件中：

[root@Ansible ~]# ansible-vault encrypt_string --vault-id steed@vault-pass-file 'ssh_pass' --name 'key3' >> /etc/ansible/host_vars/host1
[root@Ansible ~]# cat /etc/ansible/host_vars/host1
---
key1: vaule1
key2: VALUE2
key3: !vault |
          $ANSIBLE_VAULT;1.2;AES256;steed
          30343264386638623133383632353762356632643531643735653131663662623164303533373163
          3032646663363765386135386362376433326131333262310a366636396233653038646133336334
          62376532343064396639623835646563643663613530383739666239663565386364303931316637
          6137343936636266340a306233633039323537346332336132313766383039653565646230393662
          6332
[root@Ansible ~]#

这里可以看到密文上一行的内容的最后，有之前加上的用户标识信息。

使用的时候，使用密码还是指定文件都可以：

[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key3={{key3}}" --vault-id vault-pass-file 
host1 | CHANGED | rc=0 >>
key1=vaule1, key3=ssh_pass
[root@Ansible ~]# ansible host1 -a "echo key1={{key1}}, key3={{key3}}" --vault-password-file vault-pass-file 
host1 | CHANGED | rc=0 >>
key1=vaule1, key3=ssh_pass
[root@Ansible ~]#

官方文档中是用 --vault-id 来指定解密用的文件的，不过试了下 --vault-password-file 也是可以的。

使用debug模块进行调试

官方的建议是使用debug模块就行调试：

To see the original value, you can use the debug module.

之前的示例就不改了，要用debug模块，简单的可以这么使用：

[root@Ansible ~]# ansible host1 -m debug -a 'var="key1,key2,key3"' --vault-password-file vault-pass-file
host1 | SUCCESS => {
    "key1,key2,key3": "('vaule1', 'VALUE2', 'ssh_pass')"
}
[root@Ansible ~]#

码农公寓