Helper template tags for interacting with GitHub Apps using Insomnia
npm install insomnia-plugin-github-apps-helpergithub-apps-helper > :sleeping: Insomnia template tags for interacting with GitHub APIs using GitHub Apps
Provides custom template tags to generate JWTs (JSON Web Tokens) and _installation access tokens_, easing GitHub App authentication when working with GitHub APIs within Insomnia.
1. JWT (JSON Web Token) generation, for authenticating as a GitHub App
1. Installation access token generation, for authentication as a GitHub App installation
1. Caching, and automatic regeneration, of installation access tokens
1. Environment-wide configuration, that can be overridden per-request, to ease setup
Install insomnia-plugin-github-apps-helper from the Plugins tab within Insomnia's application preferences dialog:
Set the following environment variables within Insomnia:
1. github_app_id: The ID for your GitHub App
- This is available from the settings page of your GitHub App, as App ID.
1. github_app_private_key_path: The _path_ on your machine to a private key for your GitHub App, e.g. /path/to/your-app.YYYY-MM-DD.private-key.pem
- More information on generating and downloading private keys for your GitHub Apps is available in the documentation
1. github_app_installation_id: The ID for an installation of your GitHub App
- Found using the GET /app/installations API endpoint
1. github_api_root: The API Root for your GitHub App
Two template tags are provided by this plugin:
1. jwt: Generates a JSON Web Token, allowing you to authenticate with the GitHub API as your GitHub App
1. installation_access_token: Generates an Installation Access Token, allowing you to authenticate with the GitHub API as an installation of your GitHub App
Generates a JSON Web Token, allowing you to authenticate with the GitHub API as your GitHub App.
Usage
Create a new request, e.g. GET /app:

Set the appropriate URL for your request, and configure auth to Bearer Token:

Use auto-complete to select the JSON Web Token tag:

Hit Send. You're good to go :rocket:
Generates an Installation Access Token, allowing you to authenticate with the GitHub API as an installation of your GitHub App.
Usage
Create a new request, e.g. GET /installation/repositories:

Set the appropriate URL for your request, and configure auth to Bearer Token:
!installation-repositories-bearer-token-higlight-option
Use auto-complete to select the Installation Access Token tag:

Hit Send. You're good to go :rocket:
Please open an issue.