MURAL’s Azure DevOps integration allows for Azure DevOps work items to be imported directly into MURAL as sticky notes. From there, you can use MURAL together with Azure DevOps for planning work, mapping dependencies with other teams, and creating visual representations of work items.
This article walks you through the setup required in MURAL and in Azure DevOps. You can see our Azure DevOps user guide here.
Contents
FAQ.
Enable the Azure DevOps integration
There are two parts to enabling this integration. One happens in MURAL, and the other in your Azure DevOps organization. Remember, only company admins can enable this integration in MURAL, and only Enterprise accounts need to enable it on their company dashboard.
If you are on a Free, Team+, or Business plan, the integration is automatically enabled. If you are on a Business plan with SSO (single sign-on) enabled, reach out to MURAL customer support to enable the integration.
MURAL company admin setup (required for Enterprise accounts only)
To get started with this integration, you’ll need to enable it from your company dashboard.
To enable the integration in MURAL:
Click your avatar on the mural dashboard to open the user options menu.
Select Company dashboard.
Click Integrations in the left sidebar.
Scroll down and click the Enable Azure DevOps integration checkbox.
Click Save changes.
Note: This integration is in private beta. If you don’t see the option to enable Azure DevOps integration on your Integrations page, you’ll need to have your MURAL account added to the private beta. Please reach out to your MURAL support contact. |
Azure DevOps admin setup
In addition to enabling this integration in MURAL, you’ll need to enable third-party application access directly in Azure DevOps.
To enable the integration in Azure DevOps:
Navigate to the Organization settings for your Azure DevOps organization.
Click Policies in the left sidebar.
Toggle the Third-party application access via OAuth option to ON.
Now that you’ve enabled Azure DevOps in MURAL and your Azure DevOps organization, you’re ready to use the integration! Here’s the Azure DevOps integration user guide to share with your team.
FAQ
Here are answers to some frequently asked questions about Azure DevOps:
How does authentication with Azure DevOps work?
Each user will authenticate with their Azure DevOps credentials when connecting to an Azure DevOps organization. We will then access Azure DevOps on their behalf using a token that is generated by the OAuth process. This means that we are relying on Azure DevOps permissions to determine what work items the user has access to. Said another way, we will only be able to show the user the work items in Azure DevOps that they have access to.
What scopes are used for authentication with Azure DevOps?
The integration uses these scopes:
Scope | Description |
Work items (read and write) | Grants the ability to:
|
Project and team (read) | Grants the ability to read projects and teams. |
Graph (read) | Grants the ability to read user, group, scope, and group information. |
These scopes are also referred to as vso.project and vso.work_write. See this document for more information about scopes.
Where is Azure DevOps data stored when I import work items?
Any data that is imported onto a mural is stored with MURAL. For example, if a work item is imported as a sticky note with the work item title, state, and type, then that data will be stored with MURAL. In the future, there may be options to import additional information about a work item onto a mural, which would also be stored with MURAL.
In what geographic location is data stored?
Data is stored in the United States unless your organization is using data residency. See this page for more information.
The Azure DevOps integration is unavailable if your workspace’s data is stored in a region outside of the United States.
Is data transferred from Azure DevOps to MURAL encrypted in transit?
Data is retrieved from the Microsoft API using SSL (Secure Sockets Layer) encryption.
Is data encrypted at rest in MURAL’s database?
Yes. See this page for more information about MURAL’s data encryption.
What is MURAL building next for this integration?
We will continue adding features to make it easier to plan work in Azure DevOps with MURAL. We’re focused on use cases like team sprint planning and organization PI (program increment) planning.
Have a specific idea? Tell us about it on MURAL’s community forums.
Is the integration supported on Azure DevOps Server?
No. The integration is only supported on Azure DevOps Services (cloud) and will not work with Azure DevOps Server (on premises, previously known as TFS (Team Foundation Server)).