Jira
Overview
Jira, by Atlassian, is a widely-used project and issue management platform. When integrated with Rely.io, it can provide additional dimensions of insights, such as customer-facing incidents, security tickets, and ongoing projects. Leveraging Jira data within Rely.io can help in achieving better incident management and project tracking.
Rely.io fetches data directly from Jira, including Projects, Issues, Users, and Groups, ensuring regular synchronization on an hourly basis. Additionally, to achieve real-time data updates, this plugin supports webhooks as outlined in Step 3 of this guide.
Installation Guide
Step 1: Generate a Jira API Token (official docs here).
Log into your Jira Cloud account.
Navigate to
Account settings
→Security
→API tokens
.Click
Create and manage API tokens
.Name your token, for example, "Rely.io Integration", and click
Create
.Copy and securely store the API token generated.
Step 2: Add Jira to Rely.io Settings
Open Rely.io and navigate to
Settings
→Data Sources
.Click
Add Data Source
and chooseJira
.A form will appear for the Jira Cloud integration:
Plugin Name: Assign a name for the Jira data source collector.
Jira API Token: Paste the token you generated in Step 1.
Jira Username Email: Enter the email address associated with the Jira API Token (should match the email used in Jira settings on Step 1.
Webhook Token: This token authenticates webhook requests from Jira to Rely.io. If you want to enable webhook implementation, securely store this token for use in Step 3, as you won't be able to view it again in the future. You can also generate a new token and paste it in this field.
Click Create
to finalize the integration.
Step 3: Configure Webhooks in Jira
Go to Jira administration → System → Webhooks.
Click Create a Webhook.
Fill in the details:
Name: Set a name like "Rely.io Integration Webhook".
URL: Get the webhook URL from Rely.io. Go to Rely.io Data Sources, select the Jira plugin and click "View details". The URL format should be
https://magneto.rely.io/api/v1/webhooks/jira?plugin_id=<plugin_identifier>
.Secret: Use the webhook token generated in Step 3.
Under Events, select the following checkboxes:
Issue related events: Issue created, updated, deleted.
User related events: User created, deleted, updated.
Project related events: Project created, updated, deleted
Click Create at the bottom of the page.
After you submit your form, an entity discovery run will be kickstarted that can take a few minutes. By the end of this discovery run:
New blueprints will be added to your data model
Entities representing Jira Projects, Users, Issues and Groups, will be added your software catalog
These entities will be hourly updated to ensure they remain in sync with their external counter-parts
With webhooks enabled the changes in Jira will be immediately available in your software catalog.
Only issues 30 days old will be added to your data model from the moment you setup this integration.
Last updated