---
name: "vault-github-token"
description: "Create a GITHUB_TOKEN environment variable from VAULT_GITHUB_TOKEN."
author: "elastic"
repo: "vault-github-token-buildkite-plugin"
stars: 1
official: false
version: "v0.2.3"
lastUpdated: "2026-10-08T18:14:49.000Z"
---

# Configure the ephemeral GitHub token provided by the Vault Plugin

[![usages](https://img.shields.io/badge/usages-white?logo=buildkite&logoColor=blue)](https://github.com/search?q=elastic%2Fvault-github-token+%28path%3A.buildkite%29&type=code)

## Usage

```yml
steps:
  - command: <...>
    plugins:
      - elastic/vault-github-token#v0.2.3:
```

## Configuration

### `configure-git-user` (optional, boolean)

When set to `true`, configures the git `user.name` and `user.email` in the current workspace to default CI bot values:

- `user.name`: `elastic-ci[bot]`
- `user.email`: `elastic-ci[bot]@users.noreply.github.com`

Defaults to `false` (opt-in).

```yml
steps:
  - command: <...>
    plugins:
      - elastic/vault-github-token#v0.2.3:
          configure-git-user: true
```

### `export-tf-var-github-token` (optional, boolean)

When set to `true`, exports the GitHub token as `TF_VAR_github_token` for Terraform configurations that consume it as an input variable.

Defaults to `false` (opt-in).

```yml
steps:
  - command: <...>
    plugins:
      - elastic/vault-github-token#v0.2.3:
          export-tf-var-github-token: true
```