Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support for authentication as a GitHub App #286

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

fatmcgav-depop
Copy link

This commit adds support for authentication as a GitHub App.
This is beneficial in several ways, including:

  • Increased rate limits
  • Better separation of access
  • Finer grained control over access
  • Removes the need for a bot or service account

As part of these changes, have added the github.com/bradleyfalzon/ghinstallation/v2
module and it's associated dependencies.

Added several new configuration fields:

  • UseGitHubApp - Boolean flag signalling if user wants to auth as a GitHub App
  • PrivateKey - PEM encoded private key
  • PrivateKeyFile - Filename for RSA Private Key generated for GitHub App
  • AppID - GitHub App application numerical identifier
  • InstallationID - GitHub App installation numerical identifier

N.B I'm currently working on documentation and integration testing, however I thought it would be useful to get early feedback...

This commit adds support for authentication as a GitHub App.
This is beneficial in several ways, including:
* Increased rate limits
* Better separation of access
* Finer grained control over access
* Removes the need for a bot or service account

As part of these changes, have added the `github.com/bradleyfalzon/ghinstallation/v2`
module and it's associated dependencies.

Added several new configuration fields:
* `UseGitHubApp` - Boolean flag signalling if user wants to auth as a GitHub App
* `PrivateKeyFile` - Filename for RSA Private Key generated for GitHub App
* `AppID` - GitHub App application numerical identifier
* `InstallationID` - GitHub App installation numerical identifier
This enables either reading the private key from a file, or providing the contents
of the private key.
Expanded testing to cover additional scenarios.

Also rename `AppID` to `ApplicationID`.
@fatmcgav-depop fatmcgav-depop requested a review from a team as a code owner September 27, 2022 15:06
@duelyy
Copy link

duelyy commented Oct 27, 2023

Any updates on when this can be merged? Would love to use Github App as an authentication to take advantage of the 15,000 requests per hour (rate limit).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants