Azure DevOps Services

The Azure DevOps credential type stores the Personal Access Token and configuration associated with the Azure DevOps Organization(s) from which you're migrating data with Warp.

To configure an Azure DevOps credential, you'll need:

• A Personal Access Token (Global or Single Organization),

• Your Organization Slug (if you're not using a Global token), and

• The number of days until your token expires (from the day of issue)

Configuration

Search for the 🛠️ emoji if you’d like to skim through this content while focusing on the steps you need to follow.

Get the Organization Slug

🛠️ Sign in to Azure DevOps and navigate to the page for the organization containing the projects whose repositories you want to migrate:

The organization page in Azure DevOps.

The example Azure DevOps organization for this quickstart is joey-ado-testing.

Make a note of the URL in your browser’s address bar. The URL contains the organization slug, which is the part of the URL that uniquely identifies the organization. It’s the part of the URL after dev.azure.com/:

The browser's address bar, while on the organization page in Azure Devops.

In this example, the URL for the organization’s page is:

dev.azure.com/joey-ado-testing

The organization slug is the part that comes after dev.azure.com/, which means that this example’s organization slug is:

joey-ado-testing

🛠️ Copy the organization slug from your browser’s address bar and paste it someplace safe — you’ll use it when you create the vault file.

Generate a Personal Access Token for Your Organization

It’s time to get a Personal Access Token.

🛠️ Near the top right corner of the page, you’ll see the (User Settings) icon. Click it to reveal its menu:

The menu that appears when you click the User Settings icon.

🛠️ Select Personal access tokens from the menu.

You will see the Personal Access Tokens page:

The Personal Access Tokens page.

🛠️ Click any of the New Token buttons on the page.

A panel will appear, prompting you to create a new personal access token:

The Create a new personal access token panel.

🛠️ In the Name field, enter a name for the token. To make it easier to identify, we suggest you include “Warp” in the name.

🛠️ Under Scopes, change the option to Full access.

For the purposes of this Quickstart, we’ll leave the Expiration field at the default value of 30 days.

🛠️ Click the Create button.

You should now see the Success! panel, which will display the personal access token you just created:

The Success! panel.

🛠️ Copy the token and save it in a safe place — preferably a password manager.

This will be the only time that this Personal Access Token will be presented to you.

Make sure you’ve copied it someplace safe before clicking the Close button!

🛠️ Click the Close button.

When you close the Success! panel, you will be taken back to the Personal Access Tokens page. You will see the personal access token you just created listed there:

The Personal Access Tokens page, with the newly-created Personal Access Token.