Используемые термины: Hashicorp Vault , Hashicorp Consul .
Мы рассмотрим настройку отказоустойчивой системы Hashicorp Vault, состоящей из 2 серверов самого Vault и 3-х серверов Consul. Кластер управления паролями будет работать в режиме hot — standby. Предполагается, что у нас уже есть серверы с настроенными Consul, иначе, рекомендуется прочитать инструкцию Установка и настройка кластера Consul Hashicorp на CentOS . Установку Vault мы выполним в процессе настройки кластера.
Настройка Consul в качестве агентов Vault
Установка Consul
Настройка агентов
Установка и конфигурирование Hashicorp Vault
Инициализация Vault и тестирование кластера
Установка и настройка агентов Consul на ноды Vault
Первым делом добавим наши серверы Vault к кластеру Consul. Для этого на каждый узел нам нужно установить последний и сконфигурировать его. Рассмотрим подробнее и разобьем процесс на установку и настройку агента консул. Данные действия необходимо выполнить на обоих серверах Vault.
Установка Consul
Предварительно, установим пакеты:
yum install wget unzip
На сервере Consul смотрим версию установленного программного продукта:
consul -v
В моем случае, это был Consul v1.9.5 . На клиентские ноды будем устанавливать туже версию продукта:
export VER=»1.9.5″
После чего скачиваем бинарник нужной нам версии:
wget https://releases.hashicorp.com/consul/${VER}/consul_${VER}_linux_amd64.zip
И распаковываем его:
unzip consul_${VER}_linux_amd64.zip
Скопируем распакованный бинарник в каталог /usr/bin :
mv consul /usr/bin/
Проверяем, что команды консул выполняются:
consul -v
Мы должны увидеть версию программы:
Consul v1.9.5
…
Настройка агентов
Создаем учетную запись, от которой будет работать консул агент:
useradd -r -c ‘Consul Agent’ consul
* в данном примере мы создадим системную учетную запись consul.
Создаем каталоги для приложения консул:
mkdir -p /var/consul/data /etc/consul
И выставим на него соответствующие права:
chown consul:consul /var/consul/data /etc/consul
chmod 775 /var/consul/data /etc/consul
* в данном примере мы указали, что владельцем данных каталогов будет созданная учетная запись consul . Права будут полные у владельца, остальные смогут читать данные.
Создаем конфигурационные файлы для консула на каждом из будущих серверов vault:
vi /etc/consul/config.json
а) для сервера 1:
{
«server»: false,
«datacenter»: «dc1»,
«node_name»: «vault01»,
«data_dir»: «/var/consul/data»,
«bind_addr»: «192.168.0.100»,
«client_addr»: «127.0.0.1»,
«retry_join»: [«192.168.0.15», «192.168.0.20», «192.168.0.25»],
«encrypt»: «zpjf5a4reDbJFpT6FeaF0LGxD0zBRPSRbIoUkLBt0ps=»,
«log_level»: «DEBUG»,
«enable_syslog»: true
}
б) для сервера 2:
{
«server»: false,
«datacenter»: «dc1»,
«node_name»: «vault02»,
«data_dir»: «/var/consul/data»,
«bind_addr»: «192.168.0.101»,
«client_addr»: «127.0.0.1»,
«retry_join»: [«192.168.0.15», «192.168.0.20», «192.168.0.25»],
«encrypt»: «zpjf5a4reDbJFpT6FeaF0LGxD0zBRPSRbIoUkLBt0ps=»,
«log_level»: «DEBUG»,
«enable_syslog»: true
}
* обратите внимание, что конфигурационный файлы отличаются IP-адресом привязки сервиса ( bind_addr ) и именем ноды ( node_name ).
Проверяем корректность настройки:
consul validate /etc/consul/config.json
Мы должны увидеть:
Configuration is valid!
Продолжаем. Создаем юнит в systemd:
vi /etc/systemd/system/consul.service
[Unit]
Description=Consul client agent
Requires=network-online.target
After=network-online.target
[Service]
User=consul
Group=consul
PIDFile=/var/run/consul/consul.pid
RuntimeDirectory=consul
ExecStart=/usr/bin/consul agent
-config-file=/etc/consul/config.json
-pid-file=/var/run/consul/consul.pid
ExecReload=/bin/kill -HUP $MAINPID
KillMode=process
KillSignal=SIGTERM
Restart=on-failure
RestartSec=42s
[Install]
WantedBy=multi-user.target
Перечитываем конфигурацию systemd:
systemctl daemon-reload
Разрешаем автозапуск сервиса, стартуем его и проверяем статус:
systemctl enable consul
systemctl start consul
systemctl status consul
На любом из узлов кластера выполним:
consul members
Мы должны увидеть 5 нод — 3 для кластера консул и 2 для vault.
Установка и настройка Vault
Мы выполним настройку из репозитория. Но сначала нам нужно открыть в брандмауэре порт 8200:
firewall-cmd —permanent —add-port=8200/tcp
firewall-cmd —reload
Теперь скачиваем файл с настройкой репозитория:
wget https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo -O /etc/yum.repos.d/hashicorp.repo
Устанавливаем волт:
yum install vault
Открываем конфигурационный файл установленного софта:
vi /etc/vault.d/vault.hcl
Комментируем настройки для storage file и снимаем комментарии с настроек storage consul :
##storage «file» {
## path = «/opt/vault/data»
##}
storage «consul» {
address = «127.0.0.1:8500»
path = «vault»
## token = «59ac7fa8-dca6-e066-ff33-0bf9bb6f466a»
}
* данной настройкой мы говорим vault хранить данные в консуле. Также наш волт зарегистрирует сервис в consul.
** обратите внимание на закомментированную строку token — она нужна, если наш consul настроен для аутентификации (acl enable). 59ac7fa8-dca6-e066-ff33-0bf9bb6f466a — токен, который используется для получения авторизации.
Комментируем настройки TLS:
# HTTPS listener
##listener «tcp» {
## address = «0.0.0.0:8200»
## tls_cert_file = «/opt/vault/tls/tls.crt»
## tls_key_file = «/opt/vault/tls/tls.key»
##}
Снимаем комментарии для настройки HTTP listener и добавляем опцию cluster_address:
# HTTP listener
listener «tcp» {
address = «127.0.0.1:8200»
cluster_address = «127.0.0.1:8201»
tls_disable = 1
}
А также добавляем строки с опциями api_addr и cluster_addr .
а) для сервера vault 1:
api_addr = «http://192.168.0.100:8200»
cluster_addr = «http://192.168.0.100:8201»
б) для сервера vault 2:
api_addr = «http://192.168.0.101:8200»
cluster_addr = «http://192.168.0.101:8201»
Разрешаем автостарт сервиса vault и запускаем его:
systemctl enable vault —now
Проверить статус можно командой:
systemctl status vault
Распечатывание Vault и проверка работы кластера
Переходим на веб-интерфейс консула. Мы должны увидеть, что у нас зарегистрировался новый сервис Vault с двумя экземплярами, но он должен быть в состоянии Fail:
Если посмотреть подробную информацию, ошибка в том, что наши серверы Vault запечатаны. Так и должно быть. Выполняем инициализацию на любом из серверов vault.
Для получения возможности управлять сервисом, задаем переменную среды VAULT_ADDR :
export VAULT_ADDR=http://127.0.0.1:8200
Проверяем, что мы можем подключиться к волту:
vault status
Мы должны увидеть что-то на подобие:
Key Value
— ——
Seal Type shamir
Initialized false
Sealed true
Total Shares 0
Threshold 0
Unseal Progress 0/0
Unseal Nonce n/a
Version 1.8.2
Storage Type consul
HA Enabled true
Теперь можно инициализировать сервис:
vault operator init
В результате выполнения команды мы получим 5 ключей для распечатывания сервиса и токен для авторизации под рутом — что-то на подобие:
Unseal Key 1: /1Z92ccahn8WacFp7Ve1ZBP+9MwfVTttxhlHORaFqtxv
Unseal Key 2: 4nqI081IYLzpb3xCujGz6/JevySqYmxEK6XUvJv9zOTl
Unseal Key 3: A5Lt1Fxzn6gLWc+4RFVvQ4gV6gQZa2YnFz6HrMlbFXwN
Unseal Key 4: v1Zt7nqP29AO3Whpq8nB/TeUWAtWXdHp/DwPft44IAUI
Unseal Key 5: j0OPqlTd6AkYTRxZ7mnazWnvK82qHs50+n5HZVHRqz01
Initial Root Token: s.pcpkuP35fZeC3pHHl0JAp7Lm
…
Сохраняем данные значения, они нужны для работы с системой управления паролями.
Распечатываем первый vault тремя любыми ключами, введя 3 раза команду:
vault operator unseal
Переходим на веб-интерфейс Consul — мы должны увидеть, что одна из нод сервиса vault прошла все проверки:
Продолжаем. На второй ноде vaul также вводим команды для распечатывания:
export VAULT_ADDR=http://127.0.0.1:8200
vault operator unseal
После третьего ввода корректного ключа, проверяем, что на портале консула у нас нет ошибок.
Теперь пробуем обратиться к DNS консула, чтобы получить IP рабочего сервера:
nslookup -port=8600 vault.service.dc1.consul. 192.168.0.15
* где dc1 — имя датацентра в конфигурации консула ( datacenter ), consul — имя домена в конфигурации консула ( domain ); 192.168.0.15 — IP-адрес любого из серверов кластера Consul.
Мы должны получить ответ на подобие:
Name: vault.service.dc1.consul
Address: 192.168.0.100
Name: vault.service.dc1.consul
Address: 192.168.0.101
Кластер возвращает нужные нам значения.
Активную vault-ноду можно опросить запросом:
nslookup -port=8600 active.vault.service.dc1.consul. 192.168.0.15
Теперь пробуем остановить сервис vault на одной из нод кластера:
systemctl stop vault
И сделать DNS запрос:
nslookup -port=8600 vault.service.dc1.consul. 192.168.0.15
Теперь мы в ответ получим только одну запись:
Name: vault.service.dc1.consul
Address: 192.168.0.100
