> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# ostk0069/github-app-token

Impersonate a GitHub App in a CircleCI Orb. Make your GitHub Personal Token to be secured.

## Commands

### fetch-token

Fetch Installation Token as GITHUB_APP_TOKEN


| Parameter | Type | Default | Description |
|---|---|---|---|
| `app_id` | string |  | ID of the GitHub App |
| `base64_private_key` | string |  | Base64 encoded Private key of the GitHub App |
| `env_name` | string | GITHUB_APP_TOKEN | Enable to Customize Token ENV Name |
| `installation_id` | integer |  | The ID of the installation for which the token will be requested (defaults to the ID of the repository's installation) |
| `repository_name` | string |  | GitHub Repository Name |

## Executors

### default

This is a sample executor using Docker and Node. If you want to provide a custom environment in your orb, insert your image here. If you do not require an executor, you can simply delete this directory.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `tag` | string | lts | Pick a specific cimg/node image variant: https://hub.docker.com/r/cimg/node/tags
 |

## Examples

### example

Impersonate a GitHub App in a CircleCI Orb

```yaml
version: '2.1'
orbs:
  github-app-token: ostk0069/github-app-token@0.1.0
workflows:
  use-my-orb:
    jobs:
      - github-app-token/fetch-token:
          app_id: << your app id >>
          base64_private_key: << your private key >>
          installation_id: << your installation id >>
```