Follow these steps to connect Refacto to your Azure DevOps repositories.

Go to Integrations

  • Navigate to the Integrations page in your Refacto dashboard.
  • Click Connect on Azure Repos. Azure Integration Page Pn

Open Azure Repos Setup Form

  • After clicking Connect, you’ll be redirected to the Azure Repos setup form in Refacto.
  • This form requires three fields: PAT Token, Organisation Name, and Bot Email.
  • To get these values, please follow the next steps:
    • Create a Review User
    • Generate a Personal Access Token (PAT) Azure Setup Form Empty Pn

Create a Review User

You need to create a dedicated review user in Azure DevOps.
  1. Navigate to Organization Settings. Org Setting Pn
  2. Go to Users from the sidebar. Click Add users. Click On Add Users Pn
  3. Enter email or review user. Choose Access level as Basic. Choose the projects. Choose Project Pn
  4. Choose Project Adminstrator as Azure Devops Group. It is required to create webhooks in Service Hooks. Project Admin Pn

Generate a Personal Access Token (PAT)

Azure DevOps provides an option to generate a Personal Access token for a user. Follow these steps to generate the token:
  1. Next to your avatar on the header’s right side is a settings icon, click it, then choose Personal Access Tokens. Pat1 Pn
  2. Click New Token. Pat2 Pn
  3. Enter a name and an expiry date for the token. Pat3 Pn
  4. Grant the following permissions:
    1. Read & Write Code.
    2. Read for Work items.
    3. Read Graph for user info like email, name, etc. Pat4 Pn Pat5 Pn Pat6 Pn
Copy and save token. As its shown only once.

Fill in the Setup Form

On the Azure Repos setup page in Refacto, provide the following:
  • PAT Token – Paste the token you generated above.
  • Azure DevOps Organisation Name – Extract this from your Azure DevOps URL.
    Example:
    https://dev.azure.com/bluetowers/
  • → organisation name is bluetowers.
  • Bot Email – Enter the email of the review user you created earlier.
Click Save Settings when done.

Done

Your Azure Repos integration is now active.