> For the complete documentation index, see [llms.txt](https://docs.ticket-log.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ticket-log.com/guides/how-to-connect-to-azure-devops.md).

# How to connect to Azure DevOps

{% hint style="info" %}
This article discusses connecting to Azure DevOps with *Legacy Azure DevOps OAuth* method.

For instructions on connecting with *Microsoft Entra ID* method, visit the [Administrators guide](/documentation/administrators-guide/azure-devops-settings.md).
{% endhint %}

When authenticating to AzureDevOps using the *Legacy Azure DevOps OAuth* method, we recommend setting up the connection from TicketLog to Azure Devops from a Guest browser session. This way, you will not be logged in to any other Microsoft accounts that may otherwise interfere with the process.

We also recommend that you use a dedicated user in Azure DevOps for this purpose. We refer to this as the *Integration user.* This is so you can better control the permitted access between TicketLog and Azure DevOps. It also ensures that all interactions are recorded against the *Integration user* instead of a regular user, which may otherwise cause confusion.

Below is our recommended process for setting up this connection. This process should work even if a connection has already been attempted or completed.

## Quick setup guide

1. Open a new *Guest* browser session.
   * **Chrome:** Click your profile icon in the top-right corner and select 'Open Guest Profile'.
   * **Edge:** Click your profile icon in the top-right corner and select  'Other Profiles > Browse as Guest'.<br>

     <figure><img src="/files/u4UyF6DfpnjTuff7FnVU" alt="" width="563"><figcaption></figcaption></figure>

2. Visit [Azure DevOps website](https://dev.azure.com/) and sign in with your intended *Integration user*.

3. In the same Guest browser session, open a new tab and visit [TicketLog website](https://ticket-log.com/). Sign in with your TicketLog user.

4. In TicketLog, navigate to your service desk's Azure DevOps settings page.

5. Ensure the **Organization URL** and **Project** settings are entered correctly.

6. Click 'Save & Authorize'. You will see a screen asking  to accept the integration with Azure DevOps. Check the email address shown at "1" is the correct *Integration user*, then Click 'Accept'.<br>

   <figure><img src="/files/YaT8VfAik7rXDvKj4cwh" alt="" width="563"><figcaption></figcaption></figure>

7. You will be redirected back to the TicketLog website. Wait for the *Check Connection* process to complete. If successful, you will see "Status: OK".

If this process is not successful, please contact [TicketLog support](https://ticket-log.com/contact) or review the [Azure DevOps troubleshooting page](/troubleshooting/authorizing-azure-devops.md).
