GitHub Action
App Token Action
GitHub action to create an installation token for a GitHub app installed with scope org, user or repo.
Many actions requires access to the GitHub API, as long the required scope is within the authorization of the GitHub action there is no issue. But in several cases actions requires a PAT token (personal access token) that have access to an org, user, or admin rights on a repo.
The downside of the PAT is clear, the token has the same access as the user that owns the token. Alternatively you can create a GitHub app and install the app to your user, org or specific repo. For the app you configure the access level to that user, org or repo in a more fine grained way then you can do with a PAT token.
This action let you easy create an app token in the workflow that you can pass to subsequent actions in the workflow for authorization against the GitHub API via an app. Se for example the release flow in this repo.
- uses: 040code/app-token-action
id: app-token
with:
appId: <THE APP ID>
appPrivateKeyBase64: ${{ secrets.APP_PRIVATE_KEY_BASE64 }}
appInstallationType: <user | org | repo>
appInstallationValue: <npalm | 040code | 040code/app-token-action>
- uses: some-other-action
with:
token: ${{ steps.app-token.outputs.token }}
parameter | description | required | default |
---|---|---|---|
appId | App id of the app to use. | true |
|
appPrivateKeyBase64 | Base64 encoded private key of the app. | true |
|
appInstallationType | Supported types are: org, user and repo | true |
|
appInstallationValue | Depending on the type provide name of org, user or repo slug (owner/repo) | true |
parameter | description |
---|---|
token | GitHub app installation token |
This action is an node12
action.
This project are released under the MIT License.