Link to other applications

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Application links is a bundled app that allows you to link Bitbucket Data Center and Server to other Atlassian products or external applications. Thanks to this, they can exchange information or give access to certain resources or functionalities.

You can also link Bitbucket to external applications using either OAuth 1.0 or OAuth 2.0. These integrations are typically used for internal integrations and require that your application is compatible with application links. We’ve created such an integration with Jenkins – you can use it to connect to this application or take as an example of how to create your own integrations.

To view application links:

  1. Go to Administration > Applications.

  2. Select Application links. You’ll see the following page: 

  1. Application: Name of the linked application and its version. For external applications, it always shows Generic application.

  2. Direction: Communication direction, either Incoming, Outgoing, or Two-way. For Atlassian products, you should configure two-way communication, but some external applications won’t need it.

  3. Status: Connection status. For external applications, it always shows Non-Atlassian.

  4. Actions: Actions you can do on your links, such as edit or delete. For OAuth 2.0 connections, you can additionally view your OAuth credentials.

Link to Atlassian products or external applications using OAuth 1.0

To link to other Atlassian products or external applications:

  1. In application links, select Create link.

  2. Select Atlassian product as the link type. This option also works for external applications. This is the original application links mechanism – we’ve left it under this option so users can still use their OAuth 1.0 integrations.

  3. Enter the URL of your Atlassian product or external application.

  4. Follow the steps in the wizard. You’ll be redirected between Bitbucket and the product you’re linking to to authorize the two-way connection.

We’ve created an integration plugin that lets you connect Bitbucket to Jenkins using OAuth 1.0. You can also use this plugin as an example of how you can make your other 3rd party applications compatible with application links. For details, see Make your 3rd party application compatible with application links.

Link to external applications using OAuth 2.0

You can also link Bitbucket to external applications using OAuth 2.0.

Configure Bitbucket as an OAuth 2.0 provider (incoming link)

In this scenario, Bitbucket acts as an OAuth provider, allowing the external application to access its data.

For more information, see Configure an incoming link.

Configure Bitbucket as an OAuth 2.0 client (outgoing link)

In this scenario, Bitbucket acts as an OAuth client, requesting data from the external application.

For more information, see Configure an outgoing link.

We’ve added support for this scenario for future use. Currently, none of the functionalities in Bitbucket use the OAuth 2.0 client role.

Last modified on Feb 24, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.