Wiki source code of JIRA
Last modified by Vincent Massol on 2026/08/04 21:49
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Everything the JIRA Macros and the JIRA Scripting API display comes from a JIRA instance the wiki connects to. An administrator decides which instances may be reached and under which account, in the "JIRA" section of the wiki administration, following [[Configure a JIRA Server>>doc:documentation.extensions.admin.jira.configure-server.WebHome]]. | ||
| 2 | |||
| 3 | Only a JIRA Server or JIRA Data Center instance can be reached. Jira Cloud is not supported, because the JIRA Macros read the issue search and chart endpoints that only Server and Data Center expose. | ||
| 4 | |||
| 5 | An instance is defined once and given a free-form id. Page authors then designate it by that id rather than by its URL, which has two consequences worth understanding. The URL exists in a single place, so moving JIRA to another address means editing one configuration entry instead of every page holding a Macro. And credentials can be attached to the instance, which is what makes issues that are not public displayable at all. | ||
| 6 | |||
| 7 | A URL written directly in a Macro is not necessarily read anonymously: the wiki compares it, ignoring a trailing slash, with the URL of every defined instance, and reuses that instance's credentials when one matches exactly. Relying on that is fragile, because a URL that differs in its scheme, its host name or a trailing path segment matches nothing and silently falls back to an anonymous connection. | ||
| 8 | |||
| 9 | Instance definitions are stored per wiki, so each wiki of a farm has its own list and its own credentials. | ||
| 10 | |||
| 11 | The account configured for an instance is the account every reader of every page is served from. There is no per-reader authentication: the wiki does not know each reader's JIRA identity and never asks for it. Giving an instance a powerful account therefore exposes, to anyone able to view a wiki page, every issue that account can read. Conversely, an account that may not read one issue targeted by a Macro makes the page show an error, as described in [[JIRA Connection Errors>>doc:documentation.extensions.admin.jira.connection-errors.WebHome]]. | ||
| 12 | |||
| 13 | Defining instances is the only configuration the JIRA Macros need. Converting a JIRA URL pasted in the WYSIWYG editor is the exception: it comes from a separate extension whose plugin must be [[declared in the editor configuration>>doc:documentation.extensions.admin.jira.activate-paste-plugin.WebHome]]. | ||
| 14 | |||
| 15 | Authentication itself is pluggable. Basic authentication, in which a username is paired with a password or an API token, is the scheme shipped with the extension; a developer can add another one, and it then appears in the same administration section alongside it. |
