CatLight

Azure DevOps connection problems

Some users experience authorization/authentication problems when they try to connect to Azure Devops from CatLight. They can get an error message "Unauthorized" or 302 HTTP code.

This usually happens when user has multiple Microsoft accounts(e.g. personal and work account), and the wrong account got used during connection.

CatLight uses default web browser to authenticate to Azure DevOps. This browser can have a different Microsoft account authenticated in it. For example, you use Chrome in day-to-day work and signed in using work account there. But, the default browser is Internet Explorer or Safari, and it might have your personal Microsoft account authenticated in it.

Resolution

  1. In default web browser, go to Azure DevOps website (https://dev.azure.com/your-account-name) -> click on User settings -> Profile -> Authorizations. Then remove "CatLight" from there, if it is present.
  2. In default web browser, sign out of Microsoft account.
  3. Try to connect again from CatLight. You should be prompted to authenticate using Microsoft account.

Workaround

As a workaround, you can try connecting using personal access token (PAT): 

  1. In Azure DevOps, click on your user picture in top right -> Security -> Personal access tokens -> New Token.
    • In organization dropdown, select "All accessible organizations"
    • Either provide a "full access" scope, or a more granular access that should include:
      • Build - Read and execute
      • Code - Read, Status (for getting pull requests)
      • Graph - Read
      • Identity - Read
      • Project and Team - Read
      • Release - Read
      • Test management - Read
      • User Profile - Read
      • Work Items - Read and Write
    • You can set long expiration time to avoid repeating this process frequently (e.g. 1 year)
  2. In Catlight app, create a TFS connection (not Azure DevOps) and use the following address:
    https://dev.azure.com/your-account-name (or https://your-account-name.visualstudio.com/ , depending on how it is displayed in your browser).
  3. Uncheck "automatic configuration".
  4. Provider a username: your email. Password: PAT token.

If the workaround did not work for you, you can check out the logs for more details, or open a support ticket, so we can troubleshoot the issue.

Top