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.
Jira Software を使用してユーザー管理を委任することもできます。「外部ユーザー ディレクトリ」を参照してください。
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
- インストール後の任意のタイミングで以下の説明に従って実行する
To link Bitbucket to a Jira Software server:
- Click Application Links (under 'Settings') in the Bitbucket admin area.
- リンク先の Jira Software インスタンスの URL を入力し、[新しいリンクを作成] をクリックします。
- 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).
注意:
- アトラシアンでは、アプリケーション リンクに OAuth 認証のみを使用することを推奨しています。これは、このプロトコル固有のセキュリティを活用できるためです。信頼済みアプリケーションによる認証や BASIC 認証タイプは、現在では推奨していません。
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 ナビゲーションリンクプラグイン (com.atlassian.plugins.atlassian-nav-links-plugin)
- Bitbucket Dev Summary Plugin (bitbucket-jira-development-integration-plugin).
詳細については、「アトラシアン アプリケーションをリンクして連携させる」を参照してください。
OAuth を使用するように既存のリンクを更新する
以下の場合は、OAuth を使用するように既存のアプリケーション リンクを更新する必要がある場合があります。
- you upgrade an Atlassian application to a version that uses version 5.2, or later, of application links. See the Application Links version matrix.
- 既存のリンクは信頼済みアプリケーションの認証を使用しているが、チームは Jira Software 課題の開発パネルで Bitbucket Server などの開発者ツールからの要約情報を表示できない場合。
- 既存のアプリケーション リンクが OAuth を使用しているが、チームは Jira Software 課題の開発パネルで詳細ダイアログを表示できない場合。
- OAuth 認証タイプが必要なプラグインを使用している場合。
ここでは Jira Software での方法を説明しますが、他のアトラシアン サーバー製品でもプロセスはほとんど同じです。
ローカル アプリケーションから開始
ローカル アプリケーションの管理領域の [アプリケーション リンクを設定] ページに移動します。
更新が必要なリンクの横に DEPRECATED というマークが表示される場合があります。
[編集] ダイアログの [接続] 配下でリンクのローカル認証を設定します。
次のいずれかを選択します。
- OAuth (両方のアプリケーションに異なるユーザーベースがある場合)
- OAuth (偽装) (両方のアプリケーションが同じユーザーベースを共有している場合。多くの場合は LDAP を使用して外部ディレクトリで管理されます)
入力および出力方向の両方で、ローカルおよびリモート エンドの認証が一致していることを確認します。
[変更を保存] をクリックします。
リモート アプリケーションでの操作
リモート アプリケーションの管理領域の [アプリケーション リンクの設定] ページに移動します。表示している UI と一致する手順の列を選択します (いずれも同じ結果になります)。
[編集] ダイアログの [接続] 配下でリンクのローカル認証を設定します。
次のいずれかを選択します。
- OAuth (両方のアプリケーションに異なるユーザーベースがある場合)
- OAuth (偽装) (両方のアプリケーションが同じユーザーベースを共有している場合。多くの場合は LDAP を使用して外部ディレクトリで管理されます)
入力および出力方向の両方で、ローカルおよびリモート エンドの認証が一致していることを確認します。
[変更を保存] をクリックします。
[設定] ダイアログで、[送信認証] をクリックして [OAuth] タブをクリックします。
[2-Legged OAuth の有効化] を選択します。ここでは、アプリケーションは異なるユーザーベースを持っていると想定しています。
両方のアプリケーションが同じユーザーベースを共有している場合 (一般に LDAP を使用して外部ディレクトリで管理されます)、必要に応じて [2-Legged OAuth (なりすまし機能あり) の有効化] を選択します。
[更新] をクリックします。
次に、[受信認証] をクリックしてから、[OAuth] タブをクリックします。
[2-Legged OAuth の有効化] を選択します。ここでは、アプリケーションは異なるユーザーベースを持っていると想定しています。
両方のアプリケーションが同じユーザーベースを共有している場合は、任意で [2-Legged OAuth (なりすまし機能あり) の有効化] を選択します。
[更新] をクリックします。
注意:
Jira Software の開発パネルの要約データを表示できるユーザーが、その要約に集約される、詳細ダイアログの各情報 (ブランチ、コミット、プル リクエストなど) の閲覧権限を持っていない場合があります。これは、詳細ダイアログが、接続されたアプリケーションでそのユーザーが持っているアクセス権限を尊重しているためです。
開発パネルを表示するには、チーム メンバーが Jira Software で "開発ツールの表示" 権限を持っている必要があります。
Jira Software とアトラシアン開発者ツール (Bitbucket Server、Bamboo、Crucible、Fisheye) 間のアプリケーション リンクでは、信頼済みアプリケーションによる認証および Basic 認証が無効化されている必要があります。
ポート 443 でアプリケーションを実行する場合、すべての機能を利用するには、有効な SSL 証明書 (自己署名証明書ではありません) を使用する必要があります。
詳細は、「アプリケーション リンク用の OAuth セキュリティ」を参照してください。
Jira Software との連携での制限事項
- 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.
- 課題のトランジションには OAuth 認証が必要です。アプリケーション リンクに Basic 認証のみが使用されている場合、ユーザーは課題詳細を表示できますが、課題をトランジションできなくなります。
- 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.
ローカル サーバーは有効な SSL 証明書を使用し、ポート 80 または 443 でアクセス可能である必要があります。詳細は、こちらの Atlassian Cloud 製品ドキュメントを参照してください。
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.
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:
課題内で開発パネルを表示できない
開発パネルを表示するには、Jira Software で "開発ツールの表示" 権限を持っている必要があります。「グローバル権限を管理する」を参照してください。
プロジェクトへのアクセス権限がない
If you don't have permission to access the project within Jira Software then Bitbucket will be unable to display issues.
Jira Software サーバーのバージョンがサポートされていない
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.
課題キーが無効
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
課題キーがカスタム形式
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.
アプリケーション リンクが OAuth でのみ作成され、信頼済みのアプリケーションを使用するリンクの作成オプションがない
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.
引き続きお困りの場合
Jira Software と Bitbucket Server に関連する詳細情報については、「Jira Software 連携のトラブルシューティング」を参照してください。
アプリケーション リンクを使用したアトラシアン製品の連携で問題がありましたか?
「アプリケーション リンクに関するトラブルシューティング ガイド」をご用意しました。アプリケーション リンクをセットアップするうえでエラーや問題が発生している場合、こちらをご覧ください。