Configuration
-------------

NodeConductor can integrate with Atlassian JIRA to provide support to the end-users.

Expected structure for the JIRA project is as follows:

- Existing issue type: Support Request (must be default issue type for the project)
- Custom fields:

  * Impact, type: Text Field (single line)
  * Original Reporter, type: Text Field (single line)

Expected permissions:

+-------------------+------------------+
| Permission        | Permission code  |
+===================+==================+
| Add Comments      | COMMENT_ISSUE    |
+-------------------+------------------+
| Edit Own Comments | COMMENT_EDIT_OWN |
+-------------------+------------------+
| Browse Projects   | BROWSE           |
+-------------------+------------------+


WebHook Setup
-------------

It's possible to track updates of JIRA issues and apply them to NodeConductor immediately.

An instruction of JIRA configuration can be found at
https://developer.atlassian.com/jiradev/jira-apis/webhooks

WebHook URL should be defined as `http://nodeconductor.example.com/api/jira-webhook-receiver/`
and following events enabled:

* issue created
* issue updated
* issue deleted


Example Setup
-------------

1. Create support service
^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: http

    POST /api/jira/ HTTP/1.1
    Content-Type: application/json
    Accept: application/json
    Authorization: Token c84d653b9ec92c6cbac41c706593e66f567a7fa4
    Host: example.com

    {
        "name": "JIRA Support",
        "customer": "http://example.com/api/customers/eea999ddf31540aea6bd4f591aa353d1/",
        "backend_url": "https://jira.example.com/",
        "username": "username",
        "password": "password",
        "available_for_all": false
    }

2. Import support project
^^^^^^^^^^^^^^^^^^^^^^^^^

Make sure custom fields configured properly and "available_for_all" property is set to true.

.. code-block:: http

    POST /api/jira/a2f322fed8c444fab48547f595b34279/link/ HTTP/1.1
    Content-Type: application/json
    Accept: application/json
    Authorization: Token c84d653b9ec92c6cbac41c706593e66f567a7fa4
    Host: example.com

    {
        "backend_id": "SPT",
        "project": "http://example.com/api/projects/e63838e3e68f4fc4aa39617b7550cef3/",
        "impact_field": "Impact",
        "reporter_field": "Original Reporter",
        "default_issue_type": "Support Request",
        "available_for_all": true
    }

3. Perform support actions
^^^^^^^^^^^^^^^^^^^^^^^^^^

Please use a project created about to post issues.


Troubleshooting
---------------

If service settings has error message "JIRA CAPTCHA is triggered", you should perform following actions:

1. change email address of test user to something accessible.
   Do not put to the same as you already have in the same JIRA!
2. reset password (sends reset email)
3. use link
4. change email address back to bogus one