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.
Step 1: Connect Abbey to your Repo
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 🎉
Step 2: Configure Permissions for Abbey
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

Last updated