Miss any of our Open RFC calls?Watch the recordings here! »

insomnia-plugin-github-apps-helper

2.1.1 • Public • Published

github-apps-helper

😴 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.

Features

  1. JWT (JSON Web Token) generation, for authenticating as a GitHub App
  2. Installation access token generation, for authentication as a GitHub App installation
  3. Caching, and automatic regeneration, of installation access tokens
  4. Environment-wide configuration, that can be overridden per-request, to ease setup

Installation

Install insomnia-plugin-github-apps-helper from the Plugins tab within Insomnia's application preferences dialog:

installation

Configuration

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.
  2. 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
  3. github_app_installation_id: The ID for an installation of your GitHub App
  4. github_api_root: The API Root for your GitHub App

Usage

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
  2. installation_access_token: Generates an Installation Access Token, allowing you to authenticate with the GitHub API as an installation of your GitHub App

jwt

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:

screen shot 2019-02-22 at 7 29 33 pm

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

screen shot 2019-02-22 at 7 30 08 pm

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

screen shot 2019-02-22 at 7 30 27 pm

Hit Send. You're good to go 🚀

installation_access_token

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:

screen shot 2019-02-22 at 7 06 06 pm

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:

screen shot 2019-02-22 at 7 10 12 pm

Hit Send. You're good to go 🚀

Feedback

Please open an issue.

Keywords

Install

npm i insomnia-plugin-github-apps-helper

DownloadsWeekly Downloads

6

Version

2.1.1

License

ISC

Unpacked Size

12.3 kB

Total Files

7

Last publish

Collaborators

  • avatar