Atlassian Jira integration

Domino can integrate with Atlassian Jira so users can interact with Jira from inside a Domino project. For Jira integration to work, you must configure an application link between Domino and Jira. After you configure this, users with a Domino account and a Jira account can link them with OAuth.

Requirements

  • System administrator access to Domino.

  • Jira account with admin permissions.

  • Jira Cloud and Jira Server version 7.1.6+.

Configure Jira integration

  1. In the Domino Admin application, go to Advanced > Feature Flags.

  2. Set ShortLived.JiraIntegrationEnabled to true.

  3. In the Domino Admin application, go to Advanced > Jira Configuration.

  4. In Jira URL, enter the URL for your Jira service, then click Add Configuration.

    Added Jira configuration

    Warning
    The Incoming Consumer Key, Incoming Consumer Name, and Public Key won’t be visible after you move away from this page. You will need the details from this page in subsequent steps so take note of this information.
  5. Click the link to restart the services.

  6. Log in to your Atlassian Jira account. You must have admin privileges on this account.

  7. Click the gear icon to open Settings.

  8. Click Products.

    Jira product settings

  9. Under the Integrations section, click Application Link.

  10. Enter your Domino URL and click Create New Link A window opens with your URL pre-filled.

  11. Ignore the warning and click Continue.

  12. Enter the application name that was generated previously.

  13. Leave the rest of the fields empty. If your deployment requires that they be filled, enter placeholder values.

  14. Required: Scroll down and select the Create incoming link checkbox, then click Continue.

    Jira Domino form

  15. Click Continue.

  16. Enter the Consumer Name, Consumer Key and Public Key that you saved previously.

Remove linked Jira projects

You can remove Jira projects that are linked to Domino.

  1. In the Domino Admin application, go to Advanced > Jira Configuration. All projects that have a Jira ticket linked to them are listed.

  2. For the linked project, click Unlink.

  3. Click Unlink to confirm.

Remove Jira integration

You can edit or remove the Jira integration.

  1. In the Domino Admin application, go to Advanced > Jira Configuration.

  2. Unlink all Jira-linked projects.

  3. Click Delete Configuration.

  4. If you want to make changes to the configuration, you must configure a new integration.