Wiki source code of Configure a JIRA Server
Last modified by superadmin on 2026/10/14 18:25
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Define a JIRA instance in the [[JIRA administration>>doc:documentation.extensions.admin.jira.WebHome]], giving it the id page authors pass to the JIRA Macros and the Scripting API, and the credentials the wiki reads non-public issues with. | ||
| 2 | 1. Log in as a user having administration rights on the wiki. | ||
| 3 | 1. Go to the wiki administration and click "JIRA" to open the "JIRA Instance Definitions" section.((( | ||
| 4 | {{image reference="jira-admin.png" size="large" alt="The JIRA Instance Definitions section of the wiki administration, showing an instance with its id, URL and authentication type"/}} | ||
| 5 | ))) | ||
| 6 | 1. Click "Add JIRA instance". | ||
| 7 | 1. Fill the "Id" field with the name page authors will use to designate this instance, for example ##xwikiorg##. | ||
| 8 | 1. Fill the "JIRA URL" field with the base URL of the instance. | ||
| 9 | 1. Select "No authentication" in the "Authentication type" field to read only public issues, or "Basic auth" to read issues as a given JIRA account. | ||
| 10 | 1. Fill the "Username" and "Password" fields under "Authentication system configuration" when you selected "Basic auth". On Jira Cloud, enter the account email address as the username and an API token as the password. Data Center personal access tokens cannot be used: they require bearer authentication, which the extension does not send. | ||
| 11 | 1. Click "Save". | ||
| 12 | 1. Insert a ##jira## Macro in a page with its ##id## parameter set to the id you chose. The issues of that instance are displayed.((( | ||
| 13 | {{image reference="jira-admin-result.png" size="large" alt="A wiki page displaying the JIRA issues returned by a jira Macro that designates the instance by the id xwikiorg"/}} | ||
| 14 | ))) |
