Connect a Repo
In order for Abbey to orchestrate your access requests flows, you'll need to connect a code repository that holds your Terraform files.
For this step, you'll be working in
Abbey App
GitHub
Step 1: Connect Abbey to your Repo
For this step, you'll be working in
Abbey App
GitHub
To use Abbey for access requests, you'll need to connect Abbey to your GitHub.
Create a Connection
Go to the Abbey App (app.abbey.io)
Go to the Settings > Version Control page and click ➕Create a Connection
Choose a name for your connection, then click Create. You'll be redirected to GitHub to install Abbey on your GitHub account.
In the Github App Permissions screen, choose either All Repositories or Only select repositories with the repository you created earlier in Step 1 selected
5. Once you click Install & Authorize, you'll be redirected back to the Abbey App, and your connection will be created 🎉
🏁 Congrats! You've now authorized Abbey to talk with the newly created GitHub repo in your personal account
At this point you should
Have a connection to GitHub under the Abbey Settings -> Version Control tab
Have created a repo into your own GitHub account based off the Abbey Labs Quickstart Repo
Have cloned the newly created repo into your own terminal to work with
Step 2: Configure Permissions for Abbey
For this step, you'll be working in
Abbey App
Github
Create an Abbey Token
Go to Abbey API Tokens via Settings -> API Tokens in the Abbey app
Click on the + New API Token
Enter a name for your new API token or leave as is
Configure the Expires At field or leave it blank to have the token never expire
Click Create to make the new key
Copy the key - you'll need this for the next step!
Add your Abbey token to Github
Navigate to the repo you created in your own GitHub account
Go to the Settings tab
Select Secrets and Variables -> Actions on the left side
Create a new Repository Secret
For the Name, enter in
ABBEY_TOKEN
For the Secret, enter in the value of the Abbey API token you created in the last step.
⚠️ Make sure you don't have any newlines or spaces when copy/pasting this
Click Add Secret to finish adding the repository secret
Update Repo Permissions
Abbey needs a few permissions to operate in your GitHub repo.
Go to the Settings tab of the same repo you added the API token
Select Actions -> General on the left side
Scroll to the Workflow Permissions section
Select the Read and write permissions button
Click on Save in the Workflow Permissions section
Great! Now you've allowed Abbey to interact with your terraform repository.
Last updated