/automate-repo-permissions

Automate teams repository access

Primary LanguagePowerShellMIT LicenseMIT

Automate repo permissions

Overview

Teams can require access to repositories with different levels of access. The tool with the help of few inputs will Provide bulk access for teams to the mapped repositories in the excel file. With each release, the updated exe is available.

Current Challenges

  • When a large number of repositories are migrated to GitHub, we will need to give access to each migrated repo to the relevant team
  • The process becomes repititive, when there are 100s of repositories

Benefits

  • The process can be completed in one shot with an excel file which has the repository names, teams and permissions mapped

GitHub REST API

The endpoints used in the tool are GitHub's Rest API v3. A series of endpoints are made available by GitHub to alter resources like repositories, teams, projects and make organization level changes. For further reading on the GitHub's REST API please click here

Prerequisites

  • Only current organizational teams will be considered
  • Admin access to the organization for creating the repositories
  • Excel File with Team Names and permissions
  • GitHub PAT Token must be authorized to access the required organization

Download ⬇️

Download the tool from here

Usage Instructions 📝

For instructions on how to use the tool, please click here

Current Tool Limitations ❌ ❌

  • In the future, GitHub could change its remaining endpoints used in the tool without warning