Skip to content

Experimental support for GitHub token authentication #198

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

infinisil
Copy link

Summary

Implements experimental support for authentication using personal access tokens directly.

Why do you need this?

This comes from the desire to be more fine-grained in the permissions given to the github management automation, see NixOS/org#99 (comment).

E.g. With GitHub Apps, there's no way to give both the "manage teams" permission without also the "remove org owners" permission. Similarly, the "manage repos" permission also comes with the "remove repos" permission. only what's required.

In comparison, with a personal access token of a user, you can give that user specific access levels on the repos it needs access to, or only add it to specific teams it needs to manage.

What else do we need to know?

For now, personal access tokens are limited to team member management, because unless you make the user an org admin, you run into problems for pretty much any other functionality.

DRI: myself

Reviewer's Checklist

  • It is clear where the request is coming from (if unsure, ask)
  • All the automated checks passed
  • The YAML changes reflect the summary of the request
  • The Terraform plan posted as a comment reflects the summary of the request

This comes from the desire to be more fine-grained in the permissions
given to the github management automation.

E.g. With GitHub Apps, there's no way to give both the "manage teams"
permission without also the "remove org owners" permission. Similarly,
the "manage repos" permission also comes with the "remove repos"
permission. only what's required.

In comparison, with a personal access token of a user, you can give that
user specific access levels on the repos it needs access to, or only add
it to specific teams it needs to manage.

For now, personal access tokens are limited to team member management,
because unless you make the user an org admin, you run into problems for
pretty much any other functionality.
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.

1 participant