Atlassian IDE Connectors : Configuring your JIRA Options in Eclipse

Created by Sarah Maddox [Atlassian], last modified by Jacek Jaroczynski [Atlassian] on Mar 04, 2015

Before reading the information below, please make sure that you have installed the Atlassian Connector for Eclipse, as described in the Installation Guide.

On this page:

Adding a Task Repository

  1. In Eclipse Mylyn, open the 'Task Repositories' view:
    • Click 'Window', 'Show View', 'Other'.
    • Open the 'Tasks' or 'Mylyn' category and select the 'Task Repositories' view.
  2. Click the 'Add Task Repository' icon.
  3. The 'Add Task Repository' screen appears, as shown below:

  4. Now you can select and configure one or more of the task repositories and configure them to match your server(s), as described below.

    Once you have set up a repository, it will appear in the Eclipse 'Task Repositories' view, as shown in this screenshot:

Setting Up a JIRA Task Repository

  1. On the Eclipse 'Add Task Repository' screen, select the 'JIRA' task repository type and click 'Next'.
  2. The 'JIRA Repository Settings' screen appears, as shown below:


  3. Enter the following information:
    • Server — The location (URL) of your JIRA server.
    • Label — A descriptive name for your JIRA server, e.g. 'JAC'.
    • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
    • User ID — The username you use to connect to your JIRA server.
    • Password — Your password on the JIRA server, matching the above username.
    • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
      (info) If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
  4. If necessary, you can change the additional settings. If in doubt, leave these settings as set by default.
    • The 'Task Editor Settings' section is used to configure the markup language used by the task editor when Mylyn's WikiText extension is installed. By default, the Atlassian Connector for Eclipse will set the markup language to 'Confluence', so that WikiText recognises Confluence wiki markup as used by JIRA. See the Mylyn WikiText User Guide for more information.
  5. Click 'Finish' to save the changes.
  6. Eclipse Mylyn will prompt you to add a new query for the new JIRA repository. This is where you will choose your JIRA filter, to determine which issues appear in your task list. You can do this now or skip this step and do it later. You can also add more queries later.
  7. The new task repository appears in your Eclipse 'Task Repositories' view. Your JIRA issues will appear in your 'Task List' view.

(info) You can configure one or more JIRA repositories, i.e. you can connect to more than one JIRA server.

(info) If Validate Settings fails, please make sure Remote API is ON on the JIRA side.

SSL support

Atlassian Connector for Eclipse supports SSL connection out of the box so you can use https url to make communication more secure.

Default java keystore is used to read certificates. If you want to provide alternative certificates or use self-signed certificates, it is possible to point Eclipse and java to non-default keystore. For more information see following comments:

RELATED TOPICS

Working with JIRA Issues in Eclipse
Installation and Upgrade Guide for the Eclipse Connector