iT邦幫忙

2018 iT 邦幫忙鐵人賽
DAY 14
0

本系列文資料可參考以下:


既然是 Configure 有存入 data,就會有敏感資訊的議題,像是 User/Password 這類型的東西就可以使用 hiera-eyaml 來加密。

hiera-eyaml 介紹

hiera-eyaml 是由 Github 在 voxpupuli 維護的 Open Source 專案,前身是 hiera-gpg,但是 hiera-gpg 在 2015/08/25 EOL,所以就出現了 hiera-eyaml。

hiera-eyaml 相較於 hiera-gpg 的 feature:

  • only encrypts the values (which allows files to be swiftly reviewed without decryption)
  • encrypts the value of each key individually (this means that git diff is meaningful)
  • includes a command line tool for encrypting, decrypting, editing and rotating keys (makes it almost as easy as using clear text files)
  • uses basic asymmetric encryption (PKCS#7) by default (doesn't require any native libraries that need to be compiled & allows users without the private key to encrypt values that the puppet master can decrypt)
  • has a pluggable encryption framework (e.g. GPG encryption (hiera-eyaml-gpg) can be used if you have the need for multiple keys and easier key rotation)

除了官方以上的介紹以外,最大的特點是他可以支援片段加密,在 hiera-data 中你可以針對你想要的字串進行加密,但其他顯示明碼,就像是:

profile::users:
  user: 'shazi'
  password: >
    ENC[PKCS7,MIIB2gYJKoZIhvcNAQcDoIIByzCCAccCAQAxggEhMIIBHQIBADAFMAACAQEw
    DQYJKoZIhvcNAQEBBQAEggEAX5J09MMulrg7zUvwDamARR0oYaq7RNkxZyvV
    SQWBSrBq+4C+u9wALGxZHatQpCOMzPlz3gRJKWq7KOqLHgrPehAofJUpDx1T
    KI32Hbac8rkWGx5gOAghSew3cufTgZg8nMZ1z0fngXwC5/ENZbmZbA/99udx
    gGMz18QUwVY9KwDw+FtYyxX5eV/ndcF2XAGNIsQwRYM09SBRYd5LEIxhC6+o
    b8JSVt2VuxggCRn9RQOwqUhMAI0YfgfUpARD94HOXWIqoI+S2HB18TZGVXQE
    ZuVu3G0HGhesovgEs/hoy95TUsSZekZWYoFE+oelkfDNQQCtHRhcTQJeMnXi
    swtqajCBnAYJKoZIhvcNAQcBMB0GCWCGSAFlAwQBKgQQgd7ZFA2MHAv2d0EQ
    u+u1yoBwYAz1z6FrIaRO3bZZjms0t+PG6CK3+kzisLpe7a/Fc7FROo94XuMn
    PtYksgfanjR9P87xIXgr8V0dVM0+xjyXBX/dHv6Qyy5avYZg3N/p+c8d7PD8
    Tp8FhVr7ayAU8TuoUoeZbF3YL/iydMPDtJZ7DA==]

安裝

hiera-eyaml 必須在 Master 安裝

  1. 用 gem 安裝 hiera-eyaml
$ sudo gem install hiera-eyaml
  1. 替 puppetserver 安裝 hiera-eyaml
$ puppetserver gem install hiera-eyaml 
  1. 使用 eyaml createkeys 生成 Public/Private key
$ cd /etc/puppetlabs/puppet
$ sudo eyaml createkeys

這個步驟會在當下的目錄產生:

  • keys/private_key.pkcs7.pem
  • keys/public_key.pkcs7.pem

這兩把 Key 是用來加解密 hiera-eyaml 使用。

  1. 因為安全所以會特別處理權限的部份 only read
$ sudo chown -R puppet:puppet /etc/puppetlabs/puppet/keys/
$ sudo chmod -R 0500 /etc/puppetlabs/puppet/keys/
$ sudo chmod 0400 /etc/puppetlabs/puppet/keys/*.pem
$ ls -lha /etc/puppetlabs/puppet/keys
-r-------- 1 puppet puppet 1679 May 31 14:12 private_key.pkcs7.pem
-r-------- 1 puppet puppet 1050 May 31 14:12 public_key.pkcs7.pem
  1. 如果你要使用 eyaml 的 command line 的話必須要設定 config 指定 key 的位置
# /etc/eyaml/config.yaml
---
pkcs7_private_key: /etc/puppetlabs/puppet/keys/private_key.pkcs7.pem
pkcs7_public_key:  /etc/puppetlabs/puppet/keys/public_key.pkcs7.pem

eyaml 讀取設定檔的順序是:

  • /etc/eyaml/config.yaml
  • ~/.eyaml/config.yaml
  • $EYAML_CONFIG 變數

設定

hiera 本身可以 hiera-eyaml 的設定,如果拿來跟 hiera 放在一起,你的 hiera.yml 會長這樣:

---
version: 5
 
defaults:
  datadir: data
  data_hash: yaml_data
 
hierarchy:
  - name: "Secret data: per-node, per-datacenter, common"
    lookup_key: eyaml_lookup_key
    paths:
      - "secrets/nodes/%{trusted.certname}.eyaml"
      - "common.eyaml"
    options:
      pkcs7_private_key: /etc/puppetlabs/puppet/keys/private_key.pkcs7.pem
      pkcs7_public_key:  /etc/puppetlabs/puppet/keys/public_key.pkcs7.pem
 
  - name: "Per-node data"
    path: "nodes/%{trusted.certname}.yaml"
 
  - name: "Common data"
    path: "common.yaml"

hiera-eyaml 預設是 .eyaml 為檔名,你可以把有被 hiera-eyaml 加密的 String 放在 common.eyaml。

加密與解密

透過 eyaml encrypt 來加密字串或檔案。

  • -s 加密字串
  • -f 加密檔案
$ eyaml encrypt -s '123'
 
[hiera-eyaml-core] Loaded config from /Users/scottliao/.eyaml/config.yaml
string: ENC[PKCS7,MIIBeQYJKoZIhvcNAQcDoIIBajCCAWYCAQAxggEhMIIBHQIBADAFMAACAQEwDQYJKoZIhvcNAQEBBQAEggEALG08ai79eR+tE1Ilh7i+Hnw585ZCGDrcL+/ae54x5em2IA0EzrtS+yZVED3x1hGQPzsi/vwDvZf0VXuFQCDa14OXVsrcz1YVY2dDRYu0lTQEb1RGFUlb1aarQdIOrrfuvMcC/awDRXkNuLl/0IbHfH20P5IRo6Zd/lDhBzFCN9hSzvJ187TmwNqXDV3HzZ/d76SNW1RA6SP/0T2iZ/8x2YOhcyYqz+l/BjSMxffGzlLFFsiiOndPqHtuldZGfqwnzvzkvMSml8no0695et8wwsFz1nAG3oyQFVWCi7TtF7nJ46SdY6pyy0GCHI0tVMyXlO5W0IBzSLkHfvh1Ukoy7DA8BgkqhkiG9w0BBwEwHQYJYIZIAWUDBAEqBBBFC79eC77bcWazzCrKwncpgBAeU+vF/bzMD9ZYjblt9WUT]
 
OR
 
block: >
    ENC[PKCS7,MIIBeQYJKoZIhvcNAQcDoIIBajCCAWYCAQAxggEhMIIBHQIBADAFMAACAQEw
    DQYJKoZIhvcNAQEBBQAEggEALG08ai79eR+tE1Ilh7i+Hnw585ZCGDrcL+/a
    e54x5em2IA0EzrtS+yZVED3x1hGQPzsi/vwDvZf0VXuFQCDa14OXVsrcz1YV
    Y2dDRYu0lTQEb1RGFUlb1aarQdIOrrfuvMcC/awDRXkNuLl/0IbHfH20P5IR
    o6Zd/lDhBzFCN9hSzvJ187TmwNqXDV3HzZ/d76SNW1RA6SP/0T2iZ/8x2YOh
    cyYqz+l/BjSMxffGzlLFFsiiOndPqHtuldZGfqwnzvzkvMSml8no0695et8w
    wsFz1nAG3oyQFVWCi7TtF7nJ46SdY6pyy0GCHI0tVMyXlO5W0IBzSLkHfvh1
    Ukoy7DA8BgkqhkiG9w0BBwEwHQYJYIZIAWUDBAEqBBBFC79eC77bcWazzCrK
    wncpgBAeU+vF/bzMD9ZYjblt9WUT]

你可以有兩種形式寫在 common.eyaml,ENC 代表已加密。

透過 eyaml decrypt 來解密字串或檔案。

$ eyaml decrypt -e common.eyaml
 
users:
  shazi:
    password: >
        DEC::PKCS7[123]!

解密後會以 DEC 來表示已經被解密,而 123 就是解密後的值。

使用 hiera-eyaml 後的 KEY 管理

在用了 hiera-eyaml 後同時也必須思考 Public / Private key 存放的問題,基本上 repository 不會存放 key,只提供開發 Puppet 的人員 Public key (有 Public key 就可以 encrypt),讓系統管理者把 Public / Private key 塞到 Puppet master。

  • 怎麼 Deploy Key

當使用 Puppet 後通常都會講 code 保存在 Version Control,但 Key 並不適合保存在 repository,所以可以嘗試在 CI 的時候打包,或是 CD 的時候再從儲存 Key 的地方 deployment 到 puppetserver。

如果你的環境有是用 AWS 則可以使用 Parameter Store 來保存,並且在 deployment 時拉下來,由於 Parameter Store 可以支援 IAM 的權限控管與 KMS 的加密,所以你可以將 Key 控制在有權限的 Server 上才能獲取到這把 Key。


上一篇
Day 13 - 用 Hiera 來處理資料
下一篇
Day 15 - Puppet 內建的檔案系統
系列文
Ops 的轉職之路 - Puppet 從入門就放棄30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言