# 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ticket-log.com/guides/how-to-connect-to-azure-devops.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.