Jira Data Center Integration

We are excited to offer the ability to create Jira issues directly from Brightidea submissions! This allows you to transfer ideas for project management and implementation or link ideas to existing issues for improved cross-system tracking. Explore the guide below to get started.

 

Enablement within Brightidea

After your CSM has enabled Jira Data Center Integration within your Brightidea, you can proceed with the setup process by following the steps below:

• Navigate to a specific Initiative within the system that you would like to integrate. 
  •  Note: The Initiative must have View Idea 3 enabled
•  Under Site Setup > Ideas > Integrations

• • Enable Jira Integration for This Activity- Allow admins to create and link Jira issues from List and Steps view within this Initiative. Enabling this setting will make a Jira Issues widget available for optional placement on View Idea 3. The widget must be positioned manually and will then show a list of linked Jira issues along with commands to create new issues and additional links.
  • End-user Access to Jira Integration- By default, the Jira integration widget is visible only to Admin roles. Enabling this option allows end-users to view and/or interact with the widget. To use the full capabilities, users will need to authorize their personal Jira account.
    • Note: This setting enables end users to potentially interact with the widget. Whether or not they can is based on individual user permissions and roles. All end users will be able to view the widget for Submissions to which they have access. Permission to both view and edit a Submission is required to interact with the widget.
• Once the changes under Site Setup are saved, navigate to an Idea within that Initiative. 
• Enable the Widget Editor, then add the Jira widget to the desired location on the Idea page.

• End-users who can interact with the widget in Brightidea will need permission within Jira/Atlassian to view the ticket in Jira when they click the Jira link in Brightidea.

Enablement of Data Center 

• Within your Jira Data Center instance, navigate to Settings > Applications > Application Links
• Select Create Link
• For Application Type, select External Application.
• For Direction, select Incoming.
• Enter a Name for the application link.

• The redirect URL format is https://{Brightidea Domain}/_jiraDataCenter/authenticate

• For Permissions, select Write.
• Save the new application link.

 

Creating the Connection in Brightidea  

• Within your Brightidea instance, navigate to System Setup > Ideas > Jira Data Center 

• Input the Jira URL, Client ID, and Client Secret from your Jira Data center application link.
  • Redirect URL: The redirect URL to include in your application link. This field cannot be modified.
  • Jira URL: The base URL to your Jira Data Center instance
  • Client ID: The client ID from the application link that was created in Jira. 
    • Ensure that the Jira URL ends in .com and not “/” 
  • Client Secret: The client secret from the application link that was created in Jira
     

Additional Configuration and Connections: 

After the integration configuration in the backend is confirmed, users will need to authorize Jira before they can create Ideas through the integration. This will only happen once the current authorization token has expired. Tokens expire every 90 days.

Authorizing Jira

• To authorize/reauthorize Jira, navigate to an Idea from either the Steps or List views, or an Idea Board.
• From the Steps or List views, right-click and/or select Actions.

• Select Create or Link Jira Issue

 

• Select Authorize in Jira 

• Accept the Jira permissions request.

• Close the Brightidea Successful Authorization confirmation page.

• Right-click and select Create Jira Issue or Link Jira Issue

• Select your Jira Project and the Issue Type

• Once you select Create Jira Issue, the issue will be generated within your Jira instance.