Create a Dynamics Lifecycle Services connection in Azure pipelines

The Dynamics 365 finance and operations Tools extension for Microsoft Azure DevOps has several pipeline tasks that let you perform actions in Microsoft Dynamics Lifecycle Services. For example, you can upload assets, download assets, and service an environment. For the connection with Dynamics Lifecycle Services to work, you must set up a new service connection in Azure DevOps. This service connection provides the authentication details that are required to connect to Dynamics Lifecycle Services. For more information about service connections in Azure DevOps, see Service connections.

This article assumes that you have a working knowledge of Azure Pipelines.

Note

Before you can add these steps to a pipeline, the Dynamics 365 finance and operations Tools extension for Azure DevOps must be enabled and installed in the Azure DevOps account. For more information about how to install an extension for an organization, see Install extensions.

Prerequisites

You must have the credentials for a user who has access to one or more Dynamics Lifecycle Services projects that you want to interact with from Azure DevOps. Make sure that this user has successfully signed in to Dynamics Lifecycle Services before, and has opened the dashboard for the projects that you want to interact with.

Note

Dynamics Lifecycle Services doesn't support service-to-service authentication. Therefore, only regular user credentials (that is, a user name and password) can be used. Because the pipelines don't run interactively, multifactor authentication must not be set up for the account that you use. We recommend that you set up a separate user account that has limited access and strong credentials that can regularly be rotated for security purposes.

To enable direct connections from Azure DevOps to Dynamics Lifecycle Services on a user's behalf, you must register an application in your Azure Active Directory (Azure AD).

  1. Follow the instructions in Quickstart: Register an application with the Microsoft identity platform, and add a new redirect URI:

    1. Select Public client/native (mobile & desktop).
    2. Enter any valid URI, such as http://localhost.
  2. Add permissions to the application registration to access the Dynamics Lifecycle Services web APIs. Follow the instructions in Add permissions to access your web API. When you request the API permissions, select APIs my organization uses, and search for Dynamics Lifecycle services.

  3. Make sure that the account that you will use has given consent for the application registration in Azure AD. Follow the instructions in Configure the way end-users consent to an application in Azure Active Directory. You can either enable a specific user or grant admin consent for the whole tenant.

  4. Configure the registration as a public client application.

    1. In the Azure portal, select your app in App registrations, and then select Authentication.
    2. In Advanced settings > Allow public client flows > Enable the following mobile and desktop flows, select Yes.

Create the Dynamics Lifecycle Services service connection

You can create a new service connection either directly from a pipeline task or from your project's settings page. For more information about how to create service connections, see Create a service connection. In the dialog box for the Dynamics Lifecycle Services service connection, provide the following information:

  • Authentication Endpoint – The default value works for all Azure AD tenants in the Azure cloud. If your Azure AD is in a national cloud, see National clouds to find the correct authentication endpoint.
  • Dynamics Lifecycle Services API Endpoint – Provide the endpoint. If your Dynamics Lifecycle Services project is deployed in local geographies, ensure you are using the correct Dynamics Lifecycle Services API endpoint address. See Supported geographies and endpoints to find the correct API endpoint.
  • Username – Provide the email alias for the user credentials.
  • Password – Provide the password for the user credentials.
  • Application (Client) ID – Provide the ID that was previously created for your application registration in Azure AD.
  • Service connection name – Provide a meaningful name for the connection. This name will appear in the connection field for pipeline tasks that require a Dynamics Lifecycle Services connection.
  • Description – Provide an optional description of this connection.