Page Comparison

Welcome to Azure Sync for Jira Assets Sync: User Documentation 🫰

Begin your journey to streamline your asset management between Azure and Jira Service Management. This powerful integration syncs Azure resources seamlessly into your Jira environment, enhancing your asset tracking capabilities.

...

Getting Started

To make it happen, simply install Azure Sync for Jira Assets Syncon your Atlassian platform by following these simple steps:

• Search for application Azure Sync for Jira Assets Sync in the Atlassian Marketplace.

• Install Azure Sync for Jira Assets Sync into your Jira Software Cloud environment.

  • Ensure you have both Jira and Assets installed and ready to roll

First steps after installation

• Configure the Azure Sync for Jira Assets Sync app

  • Preparing Azure Connection Details

  • Configuring the Azure Sync for Jira Assets Sync App import

Configuration

Preparing Azure Connection Details

Get your Directory Tenant ID (Microsoft Entra ID)

• In your Azure portal, select All services > Microsoft Entra ID

• Scroll down the left bar to Manage, open the Properties and search for Tenant ID

• Save the Directory Tenant ID for future reference for usage in the import configuration

  

Get your Subscription ID

• In your Azure portal, search for Subscriptions

• Select the Subscription you would like to synchronize the Azure (Assets) data from

• Save the Subscription ID Id for future reference for usage in the import configuration

  

Register Access Application

You need to register an Application that will be used for the API-Gateway.

• In your Azure portal, select All services > Microsoft Entra ID

• Under the “Add” tab, click on App registration (or in the left bar open App registrations and Select New registration)

• Pick a name for your application. You can use something like "asset-azure-sync" as inspiration

• Leave other settings at default values

• Create the App registration

• Save the Application (client) ID for future reference for usage in the import configuration

  

Create Application Secret Key

• Go to the settings of the previous created application.

• Scroll down to Manage and Select Certificates & secrets

• Click New client secret

• Type description for the Key, choose an expiration and Add it

• Save the Key-Value for future reference for usage in the import configuration

...

Assign Application Role assignment

In your Azure portal, search for Subscriptions

• Select your subscription

• Select Access control (IAM) and click on the Role assignments tab

• Click Add (you need to have proper permission)

• Choose Role = Reader and search at the select for the Application name that you have created in steps above

...

Check Required Permissions

• Go to the settings of the previous created application (Microsoft Entra ID → App registration)

• Select API permissions (left bar)

• make sure that the chosen permission User.Read is visible

...

(Optional) The following steps are required for the app to fetch Azure Entra ID data (users, groups)

•  On the search bar, search for App registrations. Select the App registration that you have created

• Click API permissions and Add a permission

• Select "Microsoft Graph"

• Select "Application permissions"

• Select and add User and check "User.Read.All"

• Select following API permissions:

  • "Group.Read.All"

  • "Device.ReadWrite.All"

  • "DeviceManagementManagedDevices.Read.All"

  • "Application.ReadWrite.All"

...

• Click "Grant admin consent for “your specific subscription”.  

...

Configuring the

...

“Azure Sync for Jira Assets” App import

To import Azure data into Assets you will need all the data you have gathered in the steps above. Navigate to the Import section in the object schema configuration, click “Create import” and select Azure Sync for Jira Assets Sync.

...

After creating an import, it will be in “NOT CONFIGURED” state. You will first need to provide your Azure Connection Details to execute it. Click on the “three dots” and then “Configure app” to open configuration modal.

...

Fill the necessary fields and click “Save configuration”. After saving the configuration you can test the connection using the test connection button. You can also open the schema tree, and see the (empty) structure of Asset Object Types generated under the Root Object Type.

Settings

Azure Connection parameters:

...

Using the scheduler, you can automate imports. When enabled, the import will run automatically once a day, starting approximately 24 hours after the configuration is saved. Or you can take control with manual synchronization for precise adjustments on demand.

Performing the Import

Once you have configured your settings correctly, you should be ready to perform the import process effortlessly. Before the first execution, configured import will be in state “READY TO RUN” and “Import data” button will appear. To start the import manually, simply click on the button.

...

Finally, you can open the schema tree and browse through your imported Azure Resource Assets.

...

Imported Azure Data Types in Assets

...

Discover the list of Azure resources now available in Azure Sync for Jira Assets Sync by visiting our Resource Sync Feedback Hub. We'd love to hear your thoughts on what other resources you'd like to see added, so feel free to join the conversation and help us shape future updates!

Data Residency 🛡️

Azure Sync for Jira Assets Sync, built on the Forge platform, offers you the advantage of data residency control. With the latest Forge capabilities integrated, you can securely store your Azure connection data with confidence. This empowers you to align with your organization's data governance policies and ensures compliance with regional regulations. Your data remains safe and accessible, giving you peace of mind while using our app🔒.

Troubleshooting

Assets - Azure Integration requires both Jira and Assets to function. Also make sure all the specific permission in your Azure environment was set right.

Licence expiration

You might encounter an error (2) when starting the import (1). The first thing to check is whether your license is active, as it is the most common reason. The quickest way to verify this is in the import configuration dialog (3), where a message should appear in such case.

...

Multiple subscription import

In the current version, one import instance can only import resources registered under the specified subscription.

• To import asset data from multiple subscriptions, you need to create separate importer instances with distinct configurations for each subscription (or modify the existing one).

• To make the import functional for another subscription, it is necessary to update not only the Subscription ID but also make sure to set correct Application (Client) ID with its Application Secret Key to grant access to subscription resources.

Feedback and Support

Your invaluable feedback fuels the evolution of Azure Sync for Jira Assets Sync. Share your insights, and together, we'll cultivate a more refined and impactful user experience! 📊🌱

Our channels are always open to hear from you! If you encounter any challenges or have questions about Azure Sync for Jira Assets Sync, don't hesitate to reach out to us at our email: support@sykorait.com or via a ticket on our portal: https://support.sykorait.com. 📧

...