Provision
—— XP

Практика: пароль в Vault и без утечек

практика~30 минут+550 XP

Сейчас ты дашь машине пароль от базы так, как это делают в настоящем репозитории: шифром в group_vars, с ключом от шифра вне Git. А заодно посмотришь, где расшифрованный пароль всё-таки может вылезти наружу, — чтобы это случилось на стенде, а не в журнале конвейера.

Пароль будет учебный — S3cretPass. Работаем в ~/infra/ansible.

Шаг 1. Ключ от шифра

Сначала пароль, которым будем шифровать. Придумывать его не надо: openssl rand выдаёт случайные байты, -base64 24 — 24 байта в читаемом виде. > записывает вывод в файл.

ubuntu@stand:~$
openssl rand -base64 24 > ~/.vault-pass

Файл лежит в домашнем каталоге, а не в ~/infra, — в репозиторий он не попадёт. Закроем его от чужих глаз: права 600 из раздела 02.

ubuntu@stand:~$
chmod 600 ~/.vault-pass
ubuntu@stand:~$
ls -l ~/.vault-pass
ubuntu@stand:~$
-rw------- 1 anton anton 33 Oct  1 12:10 /home/anton/.vault-pass

-rw------- — читать и писать может только владелец. Флаг -l у ls — подробный список.

Шаг 2. Сказать Ansible, где ключ

Допиши строку в секцию [defaults] файла ansible.cfg.

дописать в ~/infra/ansible/ansible.cfg
vault_password_file = ~/.vault-pass

Теперь Ansible будет расшифровывать молча. Без этой строки пришлось бы добавлять --ask-vault-pass к каждому запуску.

Шаг 3. Зашифровать пароль

Шифруем одно значение. --name — имя будущей переменной.

ubuntu@stand:~$
ansible-vault encrypt_string 'S3cretPass' --name db_password
ubuntu@stand:~$
Encryption successful
db_password: !vault |
          $ANSIBLE_VAULT;1.1;AES256
          6132376431633965383839346163...

Скопируй всё, начиная с db_password:, и вставь в конец group_vars/lab.yml, с теми же отступами. Файл остаётся читаемым: web_message открыт, зашифрован только пароль.

Учебный пароль ты набрал в команде, и он остался в истории шелла. На работе так не делают: пароль вставляют, когда команда спросит его сама, если вызвать её без значения.

Шаг 4. Убедиться, что расшифровывается

Модуль debug печатает переменную. Флаг -a передаёт ему параметр var.

ubuntu@stand:~$
ansible lab -m debug -a var=db_password
ubuntu@stand:~$
target | SUCCESS => {
    "db_password": "S3cretPass"
}

Вот первая утечка: Vault зашифровал хранение, а в работе пароль — обычная строка, и любая задача может её напечатать.

Шаг 5. Задача с паролем — пока без защиты

Добавим в site.yml, в список tasks, задачу, которая кладёт пароль в файл для приложения. mode — права файла, кавычки нужны, чтобы YAML не превратил 0600 в число.

дописать в tasks в site.yml
    - name: Файл с паролем базы на месте
      ansible.builtin.copy:
        dest: /etc/app.env
        content: "DB_PASSWORD={{ db_password }}\n"
        mode: "0600"

Посмотрим заранее с разницей файлов:

ubuntu@stand:~$
ansible-playbook site.yml --check --diff
ubuntu@stand:~$
TASK [Файл с паролем базы на месте] ******************
--- before
+++ after: /etc/app.env
@@ -0,0 +1 @@
+DB_PASSWORD=S3cretPass
changed: [target]

Вторая утечка: --diff напечатал пароль. В конвейере CI этот журнал увидели бы все участники проекта.

Шаг 6. Закрыть задачу

Допиши к задаче одну строку на уровне ansible.builtin.copy:

дописать в задачу «Файл с паролем базы»
      no_log: true

Теперь применяем по-настоящему, тоже с --diff:

ubuntu@stand:~$
ansible-playbook site.yml --diff
ubuntu@stand:~$
TASK [Файл с паролем базы на месте] ******************
changed: [target]

Пароля в выводе нет, осталась только пометка, что задача что-то изменила. Это при обычном выводе. С флагом -v (подробнее) Ansible печатает и результат задачи — и вместо него ты увидишь заглушку:

та же задача с -v
changed: [target] => {"censored": "the output has been hidden due to the fact that 'no_log: true' was specified for this result", "changed": true}

«censored» — результат спрятан, потому что у задачи стоит no_log: true. Без no_log на этом месте с -v лежал бы весь результат вместе с содержимым файла.

Шаг 7. Проверить на машине

Файл должен принадлежать root и читаться только им. stat -c '%a %U' печатает права числом и владельца.

ubuntu@stand:~$
docker exec target stat -c '%a %U' /etc/app.env
ubuntu@stand:~$
600 root

Шаг 8. Проверить репозиторий

Последнее — убедиться, что открытого пароля нет ни в одном файле репозитория. git grep ищет по файлам под контролем Git, -c печатает по строке на каждый файл с совпадениями, а wc -l считает эти строки. Флаг -C у git — выполнить в другом каталоге, не переходя туда.

ubuntu@stand:~$
git -C ~/infra grep -c S3cretPass | wc -l
ubuntu@stand:~$
0

Ноль файлов — открытого пароля в репозитории нет. Теперь коммит:

Работаем в своей ветке: -c создаёт её и переходит в неё.

ubuntu@stand:~$
cd ~/infra
git switch -c ansible-vault

Коммит, флаг -m — его сообщение.

ubuntu@stand:~$
git add ansible/
git commit -m "ansible: пароль базы в vault, файл app.env"

Флаг -u у push связывает новую ветку с GitLab.

ubuntu@stand:~$
git push -u gitlab ansible-vault

Слей merge request в GitLab, затем git switch main и git pull. Файл ~/.vault-pass в коммит не попал: он вне репозитория. Сохрани его копию в менеджере паролей — потеряешь, и зашифрованное не прочитает никто.

Шаг 9. Сдать

Выполни команду сдачи: она проверит шифр, права ключа, прогон, файл на машине и отсутствие открытого пароля в Git.

Практика 04+550 XP

Хранить пароль в репозитории только шифром, держать ключ от шифра отдельно и увидеть своими глазами, где расшифрованный пароль всё равно утекает.

  • Пароль зашифрован
  • Ключ от шифра закрыт
  • Прогон чистый
  • Файл с паролем на машине закрыт
  • Задача закрыта от журнала
  • Открытого пароля в git нет
Команда сдачи — выполни на своей машине
команда
cd ~/infra/ansible; grep -A1 db_password group_vars/lab.yml; stat -c '%a' ~/.vault-pass; ansible-playbook site.yml | tail -2; docker exec target stat -c '%a %U' /etc/app.env; echo NOLOG=$(grep -c 'no_log: true' site.yml); echo PLAIN=$(git -C ~/infra grep -c S3cretPass | wc -l)

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.