Provision
—— XP

Практика: секрет, политика и токен

практика~25 минут+700 XP

Сейчас ты сделаешь в Vault то, что делают с каждым новым приложением: положишь его секрет, напишешь политику ровно на него и выдашь токен. А потом проверишь главное — что этот токен не читает чужого.

Как и раньше, нужен второй терминал: в нём будет работать сервер Vault.

Шаг 1. Установить и запустить сервер

Vault ставится так же, как Nomad и Consul: архив с зеркала, сверка суммы, программа в /usr/local/bin.

ubuntu@stand:~$
BASE=https://hashicorp-releases.yandexcloud.net
V=2.1.1
A=amd64
ubuntu@stand:~$
wget $BASE/vault/$V/vault_${V}_linux_${A}.zip
wget $BASE/vault/$V/vault_${V}_SHA256SUMS
ubuntu@stand:~$
sha256sum -c --ignore-missing vault_${V}_SHA256SUMS
ubuntu@stand:~$
vault_2.1.1_linux_amd64.zip: OK
ubuntu@stand:~$
unzip vault_${V}_linux_${A}.zip
sudo mv vault /usr/local/bin/
ubuntu@stand:~$
vault version
ubuntu@stand:~$
Vault v2.1.1 (d78bbbe2d2f3d289c1ec29d431071beb23668212), built 2026-09-15T21:21:56Z

Во втором терминале запусти Vault в режиме разработки. Флаг -dev — распечатанный сервер с данными в памяти, -dev-root-token-id задаёт главный токен, чтобы не переписывать случайный.

ubuntu@stand:~$
vault server -dev -dev-root-token-id=root
ubuntu@stand:~$
==> Vault server started! Log data will stream in below:
WARNING! dev mode is enabled! In this mode, Vault runs entirely
in-memory and starts unsealed with a single unseal key.
Root Token: root

Предупреждение честное: главный токен root может всё, и в проде им не пользуются.

Шаг 2. Куда и с чем ходить

В рабочем терминале скажи клиенту vault, где сервер и с каким токеном к нему ходить. Это переменные окружения, которые читает программа vault.

ubuntu@stand:~$
export VAULT_ADDR=http://127.0.0.1:8200
export VAULT_TOKEN=root

Шаг 3. Состояние

Проверь, что сервер отвечает и распечатан.

ubuntu@stand:~$
vault status
ubuntu@stand:~$
Key             Value
Sealed          false
Version         2.1.1
Storage Type    inmem

Sealed false — распечатан, inmem — хранит всё в памяти.

Шаг 4. Секрет приложения

Положи секрет для приложения web. Путь выбран не случайно: так его найдёт задание Nomad в миссии.

ubuntu@stand:~$
vault kv put secret/default/web/config greeting=привет
ubuntu@stand:~$
========= Secret Path =========
secret/data/default/web/config

И второй, чужой секрет — пароль базы, который приложению web видеть не положено:

ubuntu@stand:~$
vault kv put secret/default/db/config password=qwerty
ubuntu@stand:~$
======== Secret Path ========
secret/data/default/db/config

Шаг 5. Прочитать

Пока ты с главным токеном, читается всё.

ubuntu@stand:~$
vault kv get secret/default/web/config
ubuntu@stand:~$
====== Data ======
Key         Value
greeting    привет

Шаг 6. Политика

Создай файл ~/hashi/web-read.hcl: читать можно только то, что лежит под web. Не забудь data/ в пути — без него политика не сработает.

~/hashi/web-read.hcl
path "secret/data/default/web/*" {
  capabilities = ["read"]
}

Загрузи её в Vault под именем web-read.

ubuntu@stand:~$
cd ~/hashi
vault policy write web-read web-read.hcl
ubuntu@stand:~$
Success! Uploaded policy: web-read

Шаг 7. Токен с политикой

Выпусти токен с этой политикой. Флаг -policy — какую политику привязать, -field=token — вывести только сам токен. Знак > сохранит его в файл. Срок жизни по умолчанию — 32 дня; в проде его сокращают флагом -ttl, например до часа.

ubuntu@stand:~$
vault token create -policy=web-read -field=token > web.token

Команда молчит — токен ушёл в файл web.token.

Шаг 8. Войти токеном приложения

Переменная VAULT_TOKEN важнее входа, поэтому сначала убери её.

ubuntu@stand:~$
unset VAULT_TOKEN

Команда vault login - читает токен со стандартного ввода, а < подаёт туда файл.

ubuntu@stand:~$
vault login - < web.token
ubuntu@stand:~$
Success! You are now authenticated. The token information displayed below
…
token_duration       768h
token_policies       ["default" "web-read"]

Теперь ты — приложение web с политикой web-read.

Шаг 9. Своё и чужое

Свой секрет читается:

ubuntu@stand:~$
vault kv get secret/default/web/config
ubuntu@stand:~$
====== Data ======
Key         Value
greeting    привет

А чужой — нет:

ubuntu@stand:~$
vault kv get secret/default/db/config
ubuntu@stand:~$
Error reading secret/data/default/db/config: Error making API request.

URL: GET http://127.0.0.1:8200/v1/secret/data/default/db/config
Code: 403. Errors:

* permission denied

Ровно то, ради чего политика писалась. Если бы приложение web взломали, пароль базы остался бы в безопасности.

Шаг 10. Вернуться

Войди обратно главным токеном и отправь команду сдачи. Сервер во втором терминале не останавливай: он понадобится в миссии.

ubuntu@stand:~$
vault login root
ubuntu@stand:~$
Success! You are now authenticated. The token information displayed below
…
token_policies       ["root"]

Что дальше

Все три программы ты запускал по отдельности. В миссии они заработают вместе: задание Nomad, найденное через Consul, с секретом из Vault и без единого пароля в описании.

Практика 03+700 XP

Хранить секреты в Vault и выдавать к ним доступ политикой ровно на нужный путь.

  • Vault распечатан
  • Секрет записан
  • Политика на свой путь
  • Своё читается
  • Чужое не читается
Команда сдачи — выполни на своей машине
команда
export VAULT_ADDR=http://127.0.0.1:8200; echo "SEALED=$(vault status 2>/dev/null | grep Sealed)"; echo "SECRET=$(VAULT_TOKEN=root vault kv get -field=greeting secret/default/web/config 2>/dev/null)"; echo "POLICY=$(VAULT_TOKEN=root vault policy read web-read 2>/dev/null | grep -c 'secret/data/default/web')"; T=$(cat ~/hashi/web.token 2>/dev/null); echo "OWN=$(VAULT_TOKEN=$T vault kv get -field=greeting secret/default/web/config 2>/dev/null)"; echo "FOREIGN=$(VAULT_TOKEN=$T vault kv get secret/default/db/config 2>&1 | grep -c 'permission denied')"

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