5
0
Fork 0
mirror of https://github.com/hashicorp/vault-action.git synced 2025-11-07 07:06:56 +00:00
A GitHub Action that simplifies using HashiCorp Vault™ secrets as build variables.
Find a file
Richard Simpson da9a93f3f5
fix: package action (#3)
Package action output per github docs.
2019-10-15 14:00:01 -05:00
.github/workflows fix: package action (#3) 2019-10-15 14:00:01 -05:00
dist fix: package action (#3) 2019-10-15 14:00:01 -05:00
e2e feat: make secret names less derp for tsts 2019-09-20 17:29:13 -05:00
integration feat: simplify input parameters and docs 2019-09-20 17:56:08 -05:00
.gitignore Initial commit 2019-09-20 12:33:19 -05:00
action.js feat: simplify input parameters and docs 2019-09-20 17:56:08 -05:00
action.test.js feat: simplify input parameters and docs 2019-09-20 17:56:08 -05:00
action.yml fix: package action (#3) 2019-10-15 14:00:01 -05:00
index.js feat: add initial code logic 2019-09-20 15:09:58 -05:00
jest.config.js feat: fix unit and add e2e test 2019-09-20 17:11:09 -05:00
jsconfig.json feat: add initial code logic 2019-09-20 15:09:58 -05:00
LICENSE Initial commit 2019-09-20 12:33:19 -05:00
package-lock.json fix: package action (#3) 2019-10-15 14:00:01 -05:00
package.json fix: package action (#3) 2019-10-15 14:00:01 -05:00
README.md feat: simplify input parameters and docs 2019-09-20 17:56:08 -05:00

vault-action

A helper action for easily pulling secrets from the v2 K/V backend of vault.

Example Usage

jobs:
    build:
        # ...
        steps:
            # ...
            - name: Import Secrets
              uses: RichiCoder1/vault-action
              with:
                url: https://vault.mycompany.com:8200
                token: ${{ secrets.VaultToken }}
                secrets: |
                    ci/aws accessKey | AWS_ACCESS_KEY_ID ;
                    ci/aws secretKey | AWS_SECRET_ACCESS_KEY ;
                    ci npm_token                    
            # ...

Key Syntax

The secrets parameter is a set of multiple secret requests separated by the ; character.

Each secret request is comprised of the path and the key of the desired secret, and optionally the desired Env Var output name.

{{ Secret Path }} {{ Secret Key }} | {{ Output Environment Variable Name }}

Simple Key

To retrieve a key npmToken from path ci that has value somelongtoken from vault you could do:

with:
    secrets: ci npmToken

vault-action will automatically normalize the given data key, and output:

NPMTOKEN=somelongtoken

Set Environment Variable Name

However, if you want to set it to a specific environmental variable, say NPM_TOKEN, you could do this instead:

with:
    secrets: ci npmToken | NPM_TOKEN

With that, vault-action will now use your requested name and output:

NPM_TOKEN=somelongtoken

Multiple Secrets

This action can take multi-line input, so say you had your AWS keys stored in a path and wanted to retrieve both of them. You can do:

with:
    keys: |
        ci/aws accessKey | AWS_ACCESS_KEY_ID ;
        ci/aws secretKey | AWS_SECRET_ACCESS_KEY        

Masking

This action uses Github Action's built in masking, so all variables will automatically be masked if printed to the console or to logs.