This guide will walk you through the process of integrating Factory with Jira, enabling Droids to interact with your Jira boards and issues.

​
Prerequisites

  • Admin access to your Jira workspace
  • A Factory account with admin privileges

​
Integration Steps

1

Create a Jira Service Account

1

Create New User

  1. In your Jira workspace, create a new user.
  2. Name the user “Factory Droid”.
  3. Narrow the scopes to only the projects you want Factory to access.
2

Set Permissions

Configure the service account’s permissions to limit access to only the necessary Jira boards and projects.

2

Initiate Jira Integration in Factory

1

Access Integrations

Log in to your Factory account and navigate to Integrations.

2

Connect Jira

Click on “Connect Jira” to start the integration process.

3

Authorize Factory's Jira Application

1

Switch to Service Account

Before authorizing, switch to an incognito browser window and log in with the “Factory Droid” service account you created.

2

Authorize Application

Review the requested permissions and click “Authorize” to allow Factory access to your Jira workspace.

4

Confirm Integration

After authorization, you’ll be redirected back to the Factory platform. Verify that the integration status shows as “Connected”.

​
Alternative Setup Method

If you prefer not to use a browser for setup, you can integrate using an access token:

  1. Generate an API token for your Jira service account.
  2. Contact Factory support to provide instructions for setting up the integration using this token.

​
Verification

To ensure the integration is working correctly:

  1. Create a test issue in one of the authorized Jira projects.
  2. Use Factory to interact with this issue (e.g., comment on it or change its status).
  3. Verify that the changes are reflected in Jira.

​
Best Practices

  • Regularly review and audit the permissions granted to the Factory Droid service account.
  • Use Jira’s project-level settings to manage access efficiently.
  • Periodically rotate the API token if you’re using the token-based setup method.

​
Troubleshooting

If you encounter issues during integration:

  • Ensure you’re logged in as the service account when authorizing the integration.
  • Check Jira’s audit logs for any permission-related issues.
  • Verify that the service account has the necessary permissions for the intended projects.

For persistent problems, contact Factory support with specific error messages or screenshots.

Security and Compliance

Learn about Factory’s security measures and how we protect your data

GitLab Self-HostedLinear