How to Set Up and to Uninstall Jira Cards

Available for: Jira Cloud and Jira Server (LDAP-protected too)
Set up by: Miro Team Admin/Jira System Admin with Project administrative permissions.

⚠️ If any technical issues arise please refer to our article about Possible Atlassian Issues and How to Resolve them.

Contents

1. Configuring Jira and Miro
   1.1 Configuring Jira plugin for a specific Jira project (optional)
   1.2 Using one Jira instance for several Miro Teams (optional)
2. Uninstalling the plugin

Configuring Jira and Miro

✏️ Please note that Jira menus may differ depending on the Jira version you are using. This instruction can be also found in Atlassian Support.

Step 1

First, create an application link and configure it.

1. Go to Jira Settings > Products > Integrations > Application links.

2. Enter https://miro.com and click Create new link.

Adding Miro site address to the Application links list

3. You will then see the following dialogue window. Double-check the URL or click Continue:

Configure Application URL window

4. In the Link applications window fill out Application name and Application type and click Continue.

Application name and Application type fields are required

You will see the message Application Link ‘Application name’ created successfully and it will appear on the list.

Step 2

Now authenticate the application using your Miro data.
1. In the appeared application click Edit:

The application link is now created and requires configuration

2. Open Incoming Authentication OAuth tab. Fill out four values: URL, Consumer Key, Consumer Name, Public Key.

Incoming Authentication window

To get the values, log in to Miro and go to the Account > Settings > Apps & Integrations > Installed Apps > Jira cards. 

Note that the Cards are installed on the team level, so if you are using our Enterprise plan you will need to choose one of your Company Teams (you can connect several teams to the same Jira instance), like so: Company Settings > Teams. Choose a Team from the list and go to Apps & Integrations > Jira cards.

Jira cards in the list of your Team Plugins

If you do not have Jira Cards on your Apps list yet, scroll to the Apps section top and click Add a new App and proceed to confirm. After you see the Cards on the list, click Install.

The plugin tab will open and you can see Step 1 to get the values required for the authentication in Jira:

Jira plugin menu, Step 1

3. Copy the Miro values, paste them into the Jira OAuth tab and hit Save. After Jira processes the values you will see the message that Miro is now authorized to process your Jira data, status Configured:

The successful configuration status

Step 3

For the third step please choose one of the two options: create a webhook manually or automatically. Depending on your choice unsign the option. Please see more information in this article. We strongly recommend using the automatic webhook so you do not have to reset it in case of big updates to the plugin.

Finally, enter your Jira URL in Step 2 of the plugin settings and click Connect:

Jira plugin page, Step 2

To get the Jira URL please copy the link of your Jira Dashboard:

We accept the following formats:

https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/

If your Jira URL is not accepted, please refer to this article.

Now you can add your tasks as cards on the whiteboard. All the changes made in Jira are reflected in Jira Cards on the board.

Configuring Jira plugin for a specific Jira project (optional)

1. Create a new user profile with Jira System Administrative rights - this will allow integrating our plugin.
2. Give this Admin Project permissions in the needed project only (or several chosen ones). This will define the issues access scope from which the cards on Miro boards can be created. The issues outside of the chosen project(s) will not be accessible to be added as cards.
3. Log into Jira with the new admin credentials and follow the configuration instruction as described above.

💡 Note that Jira Admin permissions are only required to create the webhook. Once the webhook is created, you can give the newly created Jira user other permissions level.

⚠️ It is only important to have the profile limited to the specific project(s) to keep the scope. If the Admin scope changes, this will immediately be reflected on the Miro side: if the Admin gains permissions in another project - more issues will be available in the picker on Miro side; if the Admin loses permissions in a certain project, the cards created from the issues in the said project will be grayed out and will stop receiving updates from the source issue.

Using one Jira instance for several Miro Teams (optional)

If you have multiple Miro Teams you can use one existing Application link to sync Miro and Jira. Please install the Jira Cards app to any of your teams and then simply paste the Jira base URL to the integration settings of your other Miro teams and click Connect.

Uninstalling Jira cards plugin

Go to your Account Settings > Apps & Integrations > Installed apps > Jira Cards and click Uninstall for team:

The enabled integration in the Integrations list

Then click Show settings and disable your webhook in Step2:

Disabling the Jira webhook saved in your team's settings

💡 Don't forget to take a look at the main article on how to use Jira cards!