Links

GitHub: Managing Access to Teams

In this tutorial, you'll learn how to configure Grant Kits to automate access requests to a GitHub Team by attaching Team Membership. This use case models Role-Based Access Control (RBAC) for GitHub.
We will be using the GitHub Starter Kit as a base and replace configuration stubs for our use case.

Before you start

  1. 1.
    Make sure you have:
  2. 2.
    Make sure you setup:
    1. 1.
    2. 2.
      A Connection to a repo by following Connect a Repo​

Step 1: Configure Your Grant Kit

Configure Output

Grant Kits rely on your GitHub account and repository name to output access changes, which we'll set through Terraform local variables. Update the locals block in main.tf with your account_name and repo_name
main.tf
locals {
account_name = "" #CHANGEME
repo_name = "" #CHANGEME
...
}

Configure Reviewers

Workflow defines who should approve an access request.
Let's update the reviewers block by adding yourself as the reviewer by switching [email protected] with the email address you use to sign into Abbey.
main.tf
resource "abbey_grant_kit" "..." {
...
workflow = {
steps = [
{
reviewers = {
- one_of = ["[email protected]"] # CHANGEME
+ one_of = ["[email protected]"]
Now you'll need to link GitHub with Abbey.
curl -X POST \
-H "Authorization: Bearer $ABBEY_API_TOKEN" \
-H 'Content-Type: application/json' \
https://api.abbey.io/v1/users/<user_id>/apps \
-d '{"type": "github", "data": {"username": "<your GitHub username>"}}'

Step 3: Replace GitHub Stubs

main.tf
1
provider "github" {
2
- owner = "replace-me"
3
+ owner = "abbeylabs" # Replace with your own organization
4
token = var.token
5
}
6
​
7
resource "github_team" "abbey_test_team" {
8
+ name = "AbbeyTestTeam" # You may replace this with your own team name
9
description = "This team is testing Abbey."
10
}

Step 3: Deploy Your Starter Kit

First, add your GitHub-related secrets to your repo:
  • ABBEY_TOKEN
  • GH_TOKEN
ABBEY_TOKEN is your Abbey API Token. Make sure that your GH_TOKEN is for your organization and has the following permissions
  • Read and Write for Members
What should it look like?
​
​
​
​
To deploy your Starter Kit, follow instructions from Deploy Your Grant Kit.

Step 4: Automate Access Management

​
ğŸŽ‰
Congratulations! Abbey is now managing permissions to your Resource for you.
ğŸŽ‰
​
You can now start requesting and approving access by following the Request Access and Approve or Deny Access Requests guides.
Abbey strives to help you automate and secure access management without being intrusive.
To that end, this Pull Request contains native Terraform HCL code using normal open source Terraform Provider libraries. It represents the permissions change. In this case, it's just a simple creation of a new Terraform Resource.

Next Steps

To learn more about what Resources you can configure, try one of our Tutorials.
For more information on how Abbey works, visit the Key Concepts or Grant Kits page.