Connecting Azure DevOps

There are two primary methods to connect your Azure DevOps organization.

Prerequisites:

  1. You must be an Entra admin or able to install Microsoft Entra enterprise applications. If you do not have permissions, you may need to request approval before you can install our application.
  2. You must have access to a “Service Account” dedicated to installing ADO apps (if preferred over using a personal account).

Option 1: Connect Using a Personal Account

This method is the simplest and fastest way to get started. It uses the personal credentials of an existing user in Azure DevOps to establish the connection.

The user who connects should have "Project Collection Administrator" or "Organization Owner" permissions in order to provide access to all the repositories in your organization.

A disadvantage of this approach is that the connection is linked to an individual's account. If that user leaves the company or their permissions are changed, the integration will break and must be re-established by another owner.

Steps:

  1. Sign up for a Software.com account (https://app.software.com/signup) using Google or an email/password (note: support for Entra SSO is coming soon).
  2. Connect to ADO by clicking the ADO icon.
  3. Sign in to ADO using your personal Azure DevOps account.
  4. Authorize Software.com to access your Azure DevOps organization.

Option 2: Connect as a "Service Account"

This method involves creating a dedicated user account in your Azure DevOps organization (e.g., svc-software-com@yourcompany.com ) solely for this integration.

In this setup, the integration is not tied to an individual person, so it will not break due to personnel changes; however, it will consume an extra paid user license in Azure DevOps.

Steps:

  1. Create a new user account in your Microsoft Entra ID or Active Directory that is connected to your Azure DevOps organization.
    • Add the user to your Azure DevOps organization:
    • Navigate to Organization Settings > Users and click Add users.
    • Add the new service account user (e.g., svc-software-com@yourcompany.com ).
    • Set the Access level to "Basic". This will consume one license.
  2. Grant Administrator permissions:
    • Navigate to Organization Settings > Permissions.
    • Select the Project Collection Service Accounts group.
    • Click the Members tab, then Add, and add the new service account user to this group.
  3. Connect in Software.com: complete the same steps as in Option #1, but use the credentials of this newly created service account to establish the connection when connecting ADO.

Steps to Approve a Request (Entra Admin) in Azure AD

One approved, the user who initially tried to connect ADO can repeat the same steps at app.software.com as in Option #1 or Option #2 to connect ADO to Software.com.

If your organization requires Admin approval to install Enterprise Apps into Azure AD, follow these instructions to approve the application.

  1. Sign in to the Azure Portal (https://portal.azure.com) with your Azure AD administrator credentials. You will need to have at least a Cloud Application Administrator role to review and act on these requests.
  2. Navigate to Azure Active Directory in the left-hand navigation pane.
  3. In the left-hand navigation pane, go to Identity > Applications > Enterprise applications.
  4. Under the Activity section, select Admin consent requests.
  5. Select the Software.com application from the list of pending requests.
  6. Go to the Review permissions and consent tab.
  7. Click Grant Admin Consent to approve the request.

Once approved, all users who requested the app will be notified, and the application will be available for use by all users in the tenant unless you have configured it to require user assignment.

Still need help? Contact Us Contact Us