Skip to main content
Skip table of contents

RY for Jira Configuration

Quick Information

  • The JIRA app is free,

  • It lets you create links to requirements from JIRA issues.

You've probably already done it:

Go to the cog → Applications

Click Applications → Application Links, when the link is set up, it should look like this:

Configure the applink

Use the sever's url including the base path. For example:

  • If your dashboard is http://confluence.local:1990/confluence/#all-updates

  • Then your baseurl is http://confluence.local:1990/confluence/

Set your credentials in Confluence

Set your credentials in Jira

What are credentials used for?

The user is used to send the queue messages between Jira and Confluence. When you modify requirements, we update their text in Jira; When you modify issue titles, we update the link title in Confluence.

What permissions are needed?

  • The user doesn't have to be an administrator,

  • It needs to be the same user on both sides. Usernames can be different if you use OAuth, but when you authorize the other side, the associated account must be the same as saved in the properties.

  • It needs to have VIEW permissions on the spaces with requirements in Confluence,

  • It needs to have EDIT permissions on the issues with links, in Jira.

If I don't like providing credentials, how should I do?

  • It is not like we ask for a password. We just ask for a username. If we had been evil, we could have used any administrative user from the database to synchronize the queue, and you wouldn't have seen it. We ask for a username is because we are not malevolent.

  • It doesn't pose any extended security risk, since the only data we modify are Requirement Yogi tables.

  • It solves a lot of issues. Before using a queue, we used to send the information to Jira synchronously. Unfortunately, there were situations where we couldn't ask for OAuth approval (when saving a page) and this resulted in the message not being sent to Jira, and issues being different than the data in Confluence. Since implementing the queue, we've had zero support cases about synchronization. The queue is solving the authentication very effectively, with the drawback that we need a user to ensure the authentication is satisfying.

This was introduced in version 2.2, so head to our release notes if you have more questions.

After adding your credentials, make sure you have "Entity links" between the Jira project and the Confluence space.

Configure an Applink between a project and a space

If you want your users to be comfortable, you need to tell which Confluence space matches your Jira project. This is a native feature of Jira and Confluence, it helps us display the correct default requirements in the various dialogs. If spaces and projects are not linked together, it doesn’t have further consequences than proper suggestions to users.

Go to the project administration, click "Configure project links"

Click on “create project link and choose your confluence URL and project.

More options?

All settings can be found in the administration

→ Issues

→ Issue Features

→ RY Requirement Linking

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.