This addon creates an input action in the HipChat user interface for inserting JIRA issues into the chat window
The action opens a dialog that provides several convenient ways for quickly finding or creating a JIRA issue.
You can install Insert JIRA Issue for HipChat by going here
The addon’s configuration screen is pictured below.
For the addon to work properly, you will need to add at least one JIRA server to the JIRA servers list. This is done by adding a Server Name and Server Base Url to the configuration form, then clicking the Add JIRA Server button.
For the addon to communicate with JIRA you will need to create an Incoming Application Link on your JIRA server. Follow these steps.
After everything is configured, you are ready to start using the add-on. To begin, go to a room where you have added the integration. You should see a plus button next to the input box close to the bottom of the chat window where you would normally enter your chat texts.
Click on the plus sign to display the “Insert JIRA Issue” action
After clicking on the action, a modal dialog will appear.
The first time a user opens the dialog, they will be prompted to authenticate with JIRA using OAuth. This redirects them to their JIRA server to give the add-on permission to view and create issues on their behalf. OAuth allows a user to log directly into JIRA without having to share their credentials with the add-on.
After a user has successfully authenticated they can use all of the features of the add-on. These include Recently Viewed issues, Search for issues, and Create New Issue.
This will display the user’s most recently viewed issues.
This allows the user to search JIRA using jql, an issue key, or plain text.
This is a simple form for creating issues directly from HipChat. You can specify Project, Issue Type, Version/s, Component/s, Summary, and Description. If you have a required field that is not one of the fields, the form will not work.
The add-on does not capture or store any personally identifiable information of individual users.
The add-on does store information sent by HipChat when the add-on is originally installed. This may include basic customer information such as hipchat domain that can identify an organization.
The add-on stores JIRA server urls that may contain names that identify organizations.
All information stored by the add-on is used exclusively for uninterrupted operation of the provided services. At this time we don’t use it for performing any kind of analytics.
We will not share any information with 3rd parties unless compelled by a legal court order.
The Insert JIRA Issue for HipChat add-on proxies JIRA data from your JIRA server to a user’s web browser. All communication between a user and the add-on are done using https. All communication between the add-on and a JIRA server depend on the protocol that the JIRA server is running (http or https).
The add-on uses OAuth to communicate with JIRA so it does not access or store JIRA usernames or passwords.
The add-on stores users’ JIRA OAuth credentials in a permanent datastore in the Microsoft Azure cloud service in the US West region (For information on Microsoft Azure’s security, see the Azure Trust Center).
Note that the OAuth credentials can be invalidated by individual users from their JIRA profile screen. Alternatively, a JIRA administrator can remove the Application Link that the add-on requires to communicate with JIRA. This would effectively invalidate all OAuth tokens used by the add-on for that JIRA server.