Vault

This document contains the steps needed to initialize an existing Vault instance and to obtain the role_id and app_id needed for Garden Enterprise.
At this point, you should already have a Vault instance running that you can connect to.
Setting up Vault JWT Authentication
The commands below should be run from a host that has access to Vault, not in the Vault instance itself.
After going through the these steps, you'll have the Vault App ID and Vault Secret ID that Garden Enterprise needs. These values are provided to Garden Enterprise via the admin console during the installation process.
Connect to Vault
How you connect to Vault depends on your set up. In what follows, we'll assume you're coming here from Initialize Bundled Vault step of our installation guide and that you will connect to Vault via a kubectl port-forward.
Assuming you have the kubectl context set to that of the Garden Enterprise cluster, run:
1
kubectl --namespace garden-enterprise port-forward svc/prod-charts-vault 8200:8200
Copied!
Note: If you're installing Garden Enterprise into a namespace other than the default garden-enterprise, use that namespace name instead.
Set Environment
Export the following environment variables:
1
export VAULT_SKIP_VERIFY=TRUE
2
export VAULT_ADDR=http://localhost:8200
Copied!
Note: If you're not connecting to Vault over a port-forward as described in Connect to Vault step above, you may need to set a different VAULT_ADDR.
To verify that everything works, try running:
1
vault status
Copied!
You should see a response like:
1
Sealed: false
2
Key Shares: 5
3
Key Threshold: 3
4
Unseal Progress: 0
5
Unseal Nonce:
6
Version: x.y.z
7
Cluster Name: vault-cluster-49ffd45f
8
Cluster ID: d2dad792-fb99-1c8d-452e-528d073ba205
9
​
10
High-Availability Enabled: false
Copied!
Initialize Vault
Run:
1
vault operator init
Copied!
You should get a response like:
1
Recovery Key 1: /4+9fBQXFjjwWZiTHr96Xz**********************
2
Recovery Key 2: Xqc0bUNTKXVaQiKR73HyLj**********************
3
Recovery Key 3: hwOB4Hw5jVEgxf+LbnnGpf**********************
4
Recovery Key 4: pi0v0uUWUmjlQiyJvHalIi**********************
5
Recovery Key 5: iGAmfc9zyTuOAfC01rvvVA**********************
6
​
7
Initial Root Token: s.hf9vNpHLWS8*************
8
​
9
Success! Vault is initialized
10
​
11
Recovery key initialized with 5 key shares and a key threshold of 3. Please
12
securely distribute the key shares printed above.
Copied!
Add Root Token to Environment
Export the root token from the step above by running:
1
export VAULT_TOKEN=<root-token>
Copied!
Enable JWT Auth
Run:
1
vault auth enable jwt
Copied!
Write JWT Public Key
Write the JWT private key you created for the Garden Enterprise installation (see the Prepare Environment Variables step of the installation guide).
1
vault write auth/jwt/config [email protected]
Copied!
Write Policy
Create a file called policy.hcl and add the following to it:
1
path "/sys/mounts" {
2
  capabilities = ["create", "read", "update", "list"]
3
}
4
​
5
path "/sys/mounts/*" {
6
  capabilities = ["create", "read", "update", "list"]
7
}
8
​
9
path "/sys/policy/*" {
10
  capabilities = ["create", "read", "update", "delete", "list"]
11
}
12
​
13
path "/auth/jwt/role/*" {
14
  capabilities = ["create", "read", "update", "delete", "list"]
15
}
Copied!
and then run:
1
vault policy write garden-enterprise policy.hcl
Copied!
Enable App Role
Run:
1
vault auth enable approle
Copied!
Update App Role
Run:
1
curl --insecure -X PUT \
2
  ${VAULT_ADDR}/v1/auth/approle/role/garden-enterprise-approle \
3
  -H 'cache-control: no-cache' \
4
  -H 'content-type: application/json' \
5
  -H "x-vault-token: ${VAULT_TOKEN}" \
6
  -d '{
7
    "role_name":"garden-enterprise-approle",
8
    "bind_secret_id": true,
9
    "token_no_default_policy": true,
10
    "policies":["garden-enterprise"]
11
}'
Copied!
Here, we're using the environment variables set in the Set Environment step above, and the app role we enabled in the previous step.
Get App Role ID
Run:
1
curl --insecure -X GET \
2
${VAULT_ADDR}/v1/auth/approle/role/garden-enterprise-approle/role-id \
3
-H 'cache-control: no-cache' \
4
-H "x-vault-token: ${VAULT_TOKEN}"
Copied!
...and make note of the role_id in the response.
Example response:
1
{"request_id":"37c93ba5-c05f-1fb8-b82f-bdaf9ad75048","lease_id":"","renewable":false,"lease_duration":0,"data":{"role_id":"a5f945ec-2dd1-557c-ae50-aa9c62e000b5"},"wrap_info":null,"warnings":null,"auth":null}
Copied!
Create Secret
Run:
1
curl --insecure -X POST \
2
  ${VAULT_ADDR}/v1/auth/approle/role/garden-enterprise-approle/secret-id \
3
  -H 'cache-control: no-cache' \
4
  -H "x-vault-token: ${VAULT_TOKEN}"
Copied!
...and make note of the secret_id in the response.
Example response:
1
{"request_id":"cf9b1d37-a2a9-bf8c-76eb-81eb6d16bb45","lease_id":"","renewable":false,"lease_duration":0,"data":{"secret_id":"33481814-06c1-fb40-e61b-baebf9257c61","secret_id_accessor":"9c367c60-1acb-5918-8479-9aa4a2281b37"},"wrap_info":null,"warnings":null,"auth":null}
Copied!
Add App Role ID and Secret ID to Admin Console
Add the app role ID and secret ID from the steps above to the Garden Enterprise admin console. If you came here from the Initialize Bundled Vault step of the installation guide, you can now proceed with the installation.