Integrating with self-hosted tools using OAuth
The info on this page is only for integrating Jira Software Cloud with on-premise/server tools.
OAuth credentials allow you to integrate your Jira Software Cloud site with self-hosted development and build tools like Bitbucket Server and Jenkins. This means you won’t need to open your firewall or install a third-party add-on to associate development or release information with Jira issues.
This is a system-to-system integration, and isn’t associated with any Jira user. This means it will continue to work regardless of any changes to your user-base.
In the future, this mechanism will support more data types, such as development information from Bitbucket Server or GitHub Enterprise.
You must be a site admin for Jira Cloud, as well as an admin for the tool you wish to integrate with.
Create OAuth credentials in Jira Cloud
Navigate to Jira home > Jira settings > Apps.
Select OAuth credentials.
Select Create credentials.
App name - The name of the tool. This will display in your list of credentials.
App logo - A URL to the tool’s logo, which will be used as an icon in the list of credentials.
Server base URL - A URL to the tool you're integrating with, used for future actions from the Jira issue view.
After OAuth credentials are created in Jira, they must be copied to the tool you wish to integrate with.
At a high level, this is how it works:
- You create OAuth credentials in Jira for your tool.
- You copy these credentials to the tool you want to integrate with.
- The credentials must be referenced in a plugin or script, which triggers Jira-related data to be sent back to Jira.
By using OAuth, you get the following benefits:
- Your Jira instance is secure, because the tool you integrate with doesn't have complete control over your Jira Cloud instance.
- Your Jira data is secure, because the tool you integrate with doesn't have any read access to Jira Cloud. The only data that is exchanged is the issue-related information that is sent from the other tool to Jira.