If you run into an issue while installing Jira Сards , Addon or the Confluence plugin, this article can help.
Suggestions for Jira Cards
Message / issue |
Possible causes |
Steps to resolve the issue |
Jira URL is not valid / Enter Jira base URL |
1. Your Jira is on a private network / your company firewall blocks external network connections / You are using SSO with your Jira. 2. You use a proxy. 3. There is an issue with your SSL certificate (self-signed certificates are not supported). |
1. Add our NAT Gateway IP addresses to your whitelist. Our servers will connect to your network via the static IP addresses. 2. Configure a reverse proxy allowing us access. Be sure to fill in the Jira URL field in the account settings with the address that we can access (the address may differ from the actual address of your restricted Jira). You may also want to prolong the timeout value on your proxy server. 3. Check the SSL certificate that is active on the Jira server. This tool might be helpful: enter your Jira URL and see the results of the connection check. Example: the certificate may be correct (the Certificate in green) but the server certificate chain may be incomplete (Key exchange in yellow) therefore our system gets a response that the certificate needs to be updated. |
Application link in your Jira is configured incorrectly |
1. You have missed some steps in the link or webhook configuration. 2. You have installed Jira Addon instead of configuring the link for Jira Cards. |
1. Try and start from scratch making sure to follow the steps. If you chose to create the webhook manually try creating it automatically. 2. Install the Jira Cards integration following this step-by-step instruction. |
Unexpected behavior during installation |
You use Jira versions 6.4 or lower. |
Our cards will not work with these versions due to this Jira bug. Please update your Jira to the latest version. |
The Edit card option returns blank window |
You use Jira ver. 7.6 and higher. | Due to security reasons, Atlassian may not allow the content to be embedded in iFrames, which might also affect pop-up windows for editing your Jira cards. You may use these instructions as a workaround. |
Unable to add Jira cards |
You have created a manual webhook and have not saved the set up information. | Check if the field Jira URL is filled out in the Account Settings. Be sure to click Connect. |
The Edit icon is not displayed |
1. You use Jira server versions 7.6 or higher. 2. Your profile is not allowed to edit the Jira issue in question. |
1. Edit icon may not be displayed for Jira Server starting from 7.6 due to a security update in this version. 2. Check if you can access the edit mode having opened the issue on the Jira side. |
Your app link asks for more values than just URL, Consumer Key, Consumer Name, Public Key. |
You're looking at the Outgoing Authentication tab of the configuration menu. |
|
You get the message: You are not logged in and do not have the permissions required to act on the selected issue as a guest. Please log in |
|
Log into Jira in another browser tab. If you're working in the Miro desktop app we recommend switching over to the Miro browser version at miro.com. |
Some custom fields are not shown in the Convert to Jira Issue/Edit Jira Issue menu The Select fields to display on cards does not show custom fields of your Jira |
Some of the Screens configured for the projects of your Jira instance shield the fields from Miro. | Go to Project settings > Screens > Default Screen Scheme and check if the needed fields are allowed. |
You cannot choose the reporter field when editing/creating a Jira card |
|
|
Some of the Jira cards on the board are grayed out | The Jira System Admin that set up the integration lost access to the issues. |
|
Suggestions for Jira Addon
Message / issue |
Possible causes |
Steps to resolve the issue |
You get the message: You are not logged in and do not have the permissions required to act on the selected issue as a guest. Please log in | Unfortunately, due to the way our plugin uses cookies Jira will not allow you to log in from this page. | Log into Jira in another browser tab. |
During or after the configuration of the Jira Addon you are unable to proceed to the next page at some step | Something in your cookies or cache stops the process. | Clear your browser's memory for the domain atlassian.com and try again. |
After clicking the Install button on the add-on page you might see the following error: |
A momentary loss of connection. |
In this case, simply retry to install a minute later. |
After the successful installation, your Jira users that are not registered with Miro are seeing the Miro login menu instead of the attached board. | Jira policies block some of the plugin functionalities. | Unfortunately, this behavior is caused by the most recent Jira API update and cannot be amended at the moment. |
The Addon does not remember your authorization and keeps asking to log in every time. | Your browser does not allow to save third-party cookies. | As a solution, follow the instruction on how to enable the cookies in your browser. This mostly happens with Mozilla and Safari due to their new security policies. For Safari this solution can also help. |
Suggestions for Confluence
Message / issue |
Possible causes |
Steps to resolve the issue |
You have view-only permission on this board and can't share or embed it |
You are not editor/owner of a board |
Please make sure that: 1. You are an editor or a board owner; |
After embedding a Miro board you see the message: |
Your browser does not allow to save third-party cookies.
|
To enable the embed, click the link in the message or follow the instruction on how to enable the cookies in your browser. This mostly happens with Mozilla and Safari due to their new security policies.
|
The embedded board shows the error message "Your session has expired" |