Bitbucket を Jira とリンクする

このページの内容

このセクションの項目

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

See Jira integration for a description of all the integrations you get when Bitbucket Data Center and Server is linked with Jira Software.

You can also use Jira Software for delegated user management. See External user directories.

This page describes how to link Bitbucket to Jira Software.

Link Bitbucket with Jira Software

このページの内容

You can integrate Bitbucket with one or more instances of Jira Software by means of 'application links'. You set up application links either:

  • during the Bitbucket install process, using the Setup Wizard, or 
  • at any time after installation, as described below.

To link Bitbucket to a Jira Software server:

  1. Click Application Links (under 'Settings') in the Bitbucket admin area.
  2. Enter the URL for the Jira Software instance you want to link to and click Create new link.
  3. Complete the application link wizard to connect Bitbucket to your Jira Software server. You must make use of the automatic link-back from Jira Software to Bitbucket to get full integration (you'll need system administrator global permission for that).

注意:

  • Atlassian only recommends using OAuth authentication for application links, because of the greater security inherent with that protocol. We no longer recommend the Trusted Applications and Basic Access authentication types.
  • When Bitbucket 4.0 or later is linked with Jira Software 6.2 or later, you won't see the Source tab at the bottom of the View Issue screen any more. 

  • Bitbucket only begins scanning commit messages for issue keys on the first push after you created the application link to Jira Software – the scan may take a short time.
  • The following system plugins must be enabled in Bitbucket. These are bundled and enabled by default in Bitbucket 4.0 (and later):

    • Atlassian Navigation Links Plugin (com.atlassian.plugins.atlassian-nav-links-plugin) 
    • Bitbucket Dev Summary Plugin (bitbucket-jira-development-integration-plugin).

See Link Atlassian applications to work together for more details.

Update an existing link to use OAuth

You may need to update an existing application link to use OAuth authentication when:

  • you upgrade an Atlassian application to a version that uses version 5.2, or later, of application links. See the Application links version matrix.
  • the existing link uses Trusted Applications authentication, but your team can't see summary information from a developer tool such as Bitbucket Server in the Development panel in Jira Software issues.
  • an existing application link uses OAuth, but your team can't see the details dialogs for the Development panel in Jira Software issues.
  • you use a plugin that requires the OAuth authentication type.

Here's how to do that in Jira Software, but the process is much the same for other Atlassian server products:

Begin in the local application

Go to the 'Configure Application Links' page in the admin area of the local application.

You may see a DEPRECATED lozenge beside links that need to be updated.

Click the pencil icon on the right to edit the configuration for the link you are updating.

In the 'Edit' dialog, set the local authentication for the link under 'Connections':

次のいずれかを選択します。

  • OAuth where both applications have different userbases.
  • OAuth (impersonation) if both applications share the same userbase, typically managed with an external directory using LDAP.

Make sure that that the authentication matches for the local and remote ends of both the incoming and outgoing directions.

Click Save changes.

Now, in the remote application

Go to the 'Configure Application Links' page in the admin area of the remote application. Choose the instructions column here that matches the UI you see (they both achieve the same result):

Click the pencil icon on the right to edit the configuration for the link you are updating.

In the 'Edit' dialog, set the local authentication for the link under 'Connections':

次のいずれかを選択します。

  • OAuth where both applications have different userbases.
  • OAuth (impersonation) if both applications share the same userbase, typically managed with an external directory using LDAP.

Make sure that that the authentication matches for the local and remote ends of both the incoming and outgoing directions.

Click Save changes.

更新するアプリケーション リンクの [編集] をクリックします。

In the 'Configure' dialog, click Outgoing Authentication and then the OAuth tab:

Now, select Enable 2-Legged OAuth, assuming that the applications have different userbases.

Optionally, select Enable 2-Legged OAuth with impersonation, if both applications share the same userbase, typically managed with an external directory using LDAP.

[更新] をクリックします。

Now, click  Incoming Authentication  and then the OAuth tab:


Now, select Enable 2-Legged OAuth, assuming that the applications have different userbases.

Optionally, select Enable 2-Legged OAuth with impersonation, if both applications share the same userbase.

[更新] をクリックします。

注意:

  • Users who can see summarized data in the Jira Software Development panel may not have permission to see all the information that contributed to those summaries and that is visible in the details dialogs (for example, for branches, commits and pull requests). That is, the details dialogs respect the access permissions that users have in the connected applications.

  • Your team members must have the 'View Development Tools' permission in Jira Software to see the Development panel for an issue.

  • Application links between Jira Software and Atlassian developer tools (Bitbucket Server, Bamboo, Crucible, Fisheye) must have Trusted Applications and Basic Access authentication disabled.

  • If you run an application on port 443, you must use a valid SSL certificate (which is not self-signed) to get the full functionality available.

See OAuth security for application links for more details.

Restrictions for Jira Software integration

  • The display of details for Jira Software issues, for example when viewing a pull request, relies on the Jira 5.0 REST API. Issue details are not displayed when Bitbucket is integrated with Jira Software versions earlier than 5.0.
  • Transitioning issues requires OAuth authentication. If only Basic Access authentication is used for the application link, users will be able to view issue details, but will not be able to transition issues.
  • Jira Software permissions are respected, so a user who is not permitted to transition an issue will not see the transition buttons in Bitbucket.
  • If Bitbucket is linked with multiple Jira Software instances and the projects happen to have the same key, only the issue from the instance marked as PRIMARY will be displayed. See Making a primary link for links to the same application type.

Link Bitbucket with Jira Software Cloud

There are port restrictions, and other considerations, when linking Bitbucket with Jira Software Cloud. 

Your local server must use a valid SSL certificate, and it must be accessible on port 80 or 443. For more information, see this Atlassian Cloud documentation.

If you have a internet-facing firewall, make sure to allow the IP range used by Atlassian to reach your internal network. For up-to-date information on that, see Atlassian cloud IP ranges and domains.

Troubleshoot integration with Jira Software

There are a few situations where the integration of Bitbucket with Jira Software can produce an error or may not function as expected:

Unable to see the Development panel within an issue

You must have the 'View Development Tools' permission in Jira Software to see the Development panel. See Managing Global Permissions.

You don't have permission to access the project

If you don't have permission to access the project within Jira Software then Bitbucket will be unable to display issues.

The Jira Software server is of an unsupported version

Bitbucket can integrate with Jira 4.3.x, or later. Some features require higher versions of Jira Software to function properly. See Integrate with Atlassian applications for details.

The issue key is invalid

Bitbucket doesn't check for invalid issue keys, such as 'UTF-8'. An error will result if Bitbucket tries to connect to an issue that doesn't exist. See this issue:  STASH-2470 - Getting issue details... STATUS

The issue keys are of a custom format

Bitbucket assumes that issue keys are of the default format (that is, two or more uppercase letters ([A-Z][A-Z]+), followed by a hyphen and the issue number, for example TEST-123). By default, Bitbucket will not recognize custom issue key formats. See Using custom Jira issue keys with Bitbucket Server for details.

The application link is created with OAuth only without the option to create a link using Trusted Applications

Bitbucket allows a user with global permissions of "Administrator" to create an OAuth only application link. You need to log in with a user having "System Administrator" privileges to create an application link using Trusted Applications authentication.

Still having problems?

See Troubleshooting Jira Software Integration for more information specifically related to Jira Software and Bitbucket Server.

アプリケーション リンクを使用したアトラシアン製品の連携で問題がありましたか?

アプリケーション リンクに関するトラブルシューティング ガイド」をご用意しました。アプリケーション リンクをセットアップするうえでエラーや問題が発生している場合、こちらをご覧ください。

最終更新日: 2022 年 10 月 27 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する

このセクションの項目

Powered by Confluence and Scroll Viewport.