|
| 1 | +--- |
| 2 | +title: Azure DevOps Integration |
| 3 | +sidebar_title: Azure DevOps |
| 4 | +--- |
| 5 | + |
| 6 | +## Create an Azure Application |
| 7 | + |
| 8 | +Log into your Azure DevOps account or create a new one, and ensure you have a project set up. |
| 9 | + |
| 10 | +Make sure the organization has third-party access via OAuth enabled in the organization settings. |
| 11 | + |
| 12 | + |
| 13 | + |
| 14 | +To use the Azure DevOps integration you'll need to create an application. |
| 15 | + |
| 16 | +To start, you will need access to a [Microsoft Entra Admin Portal](https://entra.microsoft.com/#home) |
| 17 | + |
| 18 | + |
| 19 | + |
| 20 | + |
| 21 | +When configuring the app, use the following values: |
| 22 | + |
| 23 | +| Setting | Value | |
| 24 | +| ------------------------------- | -------------------------------------------------------------------------------------------------- | |
| 25 | +| Supported account types | Accounts in any organizational directory | |
| 26 | +| Redirect URI | `{YOUR_DOMAIN}/extensions/vsts/setup` | |
| 27 | + |
| 28 | +<Note> |
| 29 | + |
| 30 | +Take note of your App ID as we'll need it later. |
| 31 | + |
| 32 | + |
| 33 | +</Note> |
| 34 | + |
| 35 | +Next go to Manager -> API Permissions to add the following permissions: |
| 36 | +* Azure DevOps (`vso.code`, `vso.graph`, `vso.work_item`, `vso.service_endpoint`) |
| 37 | +* Microsoft Graph (`User.Read`) (This should be added by default) |
| 38 | + |
| 39 | + |
| 40 | + |
| 41 | +Go to the "Certificates & secrets" tab and create a new client secret. Make sure you copy the secret as we'll need it later. |
| 42 | + |
| 43 | + |
| 44 | + |
| 45 | +Add the App ID and Client Secret to `devlocal.py` like this: |
| 46 | + |
| 47 | +```python |
| 48 | +# Azure DevOps # |
| 49 | +SENTRY_OPTIONS["vsts_new.client-id"] = your-app-id |
| 50 | +SENTRY_OPTIONS["vsts_new.client-secret"] = your-client-secret |
| 51 | +``` |
| 52 | + |
| 53 | +You can also add the App ID and Client Secret to `config.yml` like this: |
| 54 | + |
| 55 | +```yml |
| 56 | +# Azure DevOps # |
| 57 | +vsts_new.client-id: your-app-id |
| 58 | +vsts_new.client-secret: your-client-secret |
| 59 | +``` |
| 60 | +
|
| 61 | +You will also need to enable the feature flag to use the new Azure DevOps integration. |
| 62 | +Enable the `migrate-azure-devops-integration` feature flag in your organization. |
| 63 | +Add the following to your `devlocal.py` file: |
| 64 | + |
| 65 | +```python |
| 66 | +SENTRY_FEATURES["organizations:migrate-azure-devops-integration"] = True |
| 67 | +``` |
| 68 | + |
| 69 | +<Alert title="Feature Flag" level="info"> |
| 70 | + |
| 71 | +This is a temporary measure until we fully migrate to the new Azure DevOps integration and remove references to the old one. |
| 72 | + |
| 73 | +</Alert> |
| 74 | + |
| 75 | +Follow our [documentation on installing and configuring the Azure DevOps integration](https://docs.sentry.io/organization/integrations/source-code-mgmt/azure-devops/) to finish installation and use the integration. |
0 commit comments