AppLinks を使用して Atlassian 製品にリンク

Application Links (sometimes called app links) is a bundled app that allows you to set up links, share information, and provide access to certain resources or functionality across multiple Atlassian products. We recommend using OAuth authentication for application links because of the greater security inherent with that protocol. We no longer recommend the Trusted Applications and Basic authentication types.

Jira を他のアトラシアン製品にリンクすることで、それらの製品の情報を直接 Jira のプロジェクトや課題に含めることができます。たとえば、Confluence に Jira をリンクしている場合、Jira 課題を作成または編集するときに Confluence ページのリンクへのショートカットを含めることができます。Bitbucket Data Center と Jira をリンクすることで、Jira のストーリーに対応するブランチやコミット、プル リクエストを表示できます。

We recommend using apps to link Jira to products such as Salesforce or Zendesk. For products that don't have a supported Jira integration, you can create a custom application link.

はじめる前に

Cloud から Data Center インスタンスへのリンク

If you’re looking to integrate Atlassian Cloud and Data Center products that live in your network, you can avoid allowlisting incoming connections and IP ranges (required when linking from cloud products) by using application tunnels. Learn more about application tunnels

複製されたサイトへのリンク

サイトとそのクローン (ソース サイトからエクスポートされ、別のサイトにインポートされた Jira サイト) 間のアプリケーション リンクの作成はサポートされていません。この問題を回避する方法は次の通りです。

• Change the Data Center ID if one of the sites is Jira Data Center, or

• Perform a cloud-to-cloud migration instead

アプリケーション リンクを作成

1. Jira 管理者権限を持つユーザーとして Jira にログインします。

2. Choose > Products. Select Application Links in the left menu.

3. [リンクを作成] を選択します。

4. 次からリンクの種類を選択します。

   • Tunneled application link: This link reuses an existing application tunnel to forward the traffic to your network. Application tunnels can only be used to link to Atlassian Data Center products.

   • Direct application link: This link connects to Atlassian products or external applications directly. It needs to be able to reach them, which might require opening your network for incoming connections. When adding the Cloud URL, use the https://instance.atlassian.net. If the https:// is not used, the link will not be completed.

5. Select Continue to review connection details. Here are some options you’ll see on this screen:

• If you check The data center have the same set of users..., then this link will be configured using OAuth (with impersonation) authentication.

• If you are not an admin on both data centers you won't be able to set up a 2-way (reciprocal) application link. If you want to go ahead and create a 1-way link anyway, clear the I am an administrator on both instances checkbox.

6. ウィザードによってリンクの設定を完了します。リンク先のアプリに Application Links プラグインがない場合は、OAuth 認証によってリンクをセットアップする追加情報が必要です。

When you complete the wizard, the Application Links plugin will create the link between your applications using the most secure authentication method that is supported between the two applications. See the Application Links User Guide for more information.

新しいリンクは [アプリケーション リンクの設定] ページに表示されます。このページでは次を実行できます。

• Edit the settings of the application link (for example, to change the authentication type of the link) using the Edit () icon.

• 同じタイプのアプリ (たとえば、複数の Jira データ センター) へのリンクが複数ある場合における既定のインスタンスは

• ata centers) using the Make Primary link. See Making a primary link for links to the same application type for more information.

OAuth 認証

アトラシアンのアプリケーション リンクでは、 OAuth 認証と偽装を伴う OAuth 認証の両方のタイプが用意されています。

OAuth 認証

OAuth 認証はユーザーがリモート アプリケーションにログインするようにリダイレクトします。その後、ユーザー用に生成されたトークンが、ローカル アプリケーションから生成されたリクエストの認可に使用されます。リクエストを処理するリモート アプリケーションは、そのリモート アプリケーションにログインしたユーザーのアカウントのアクセス権限を使用します。

一般的なシナリオには以下が含まれます。

• 一連の同じユーザーを共有しない 2 つのアプリケーション間にアプリケーション リンクをセットアップする場合。

• You want to continue using a link to an application that now allows public sign-on and the link was previously configured with a shared userbase. You can update your application link by changing OAuth (impersonation) to OAuth when editing the application link.

See OAuth security for application links for more information.

偽装を伴う OAuth

偽装機能を持つアトラシアンの OAuth を使用することで、ユーザーはアトラシアン アプリケーション間の緊密な連携を簡単に活用することができます。

• ユーザーは他のアプリケーションで自動的に認証され、リクエストの認可を求められません。

• ユーザーには、自身が表示権限を持つ情報のみが表示されます。 

偽装認証は、現在ログイン中のユーザーに代わりリクエストを行います。

アトラシアンの偽装を伴う OAuth は、アトラシアンのアプリケーション間のアプリケーション リンクにのみ使用できることにご注意ください。また、2 つのアプリケーションが同じユーザーベース (通常は LDAP を使用した外部ディレクトリで管理) を共有する場合にのみ使用します。

一般的なシナリオは以下のとおりです。

• You've set up an application link but your users still have to authenticate regularly. This can occur when the application link has been configured to not share the same userbase. If those applications do share the same userbase, you can update your application link by selecting OAuth (impersonation) when editing the application link.

See OAuth security for application links for more information.

開発者ツールへのリンク

Jira と Bitbucket Data Center、Fisheye、Crucible、または Bamboo のインスタンス間に新しいアプリケーション リンクを作成すると、2-legged (2LO) および 3-legged OAuth (3LO) が既定で有効になります。2LO は、開発パネルの要約に含まれる、これらのアプリからの情報に必要です。3LO は、ユーザーが詳細ダイアログの情報にアクセスする前に、他のアプリでユーザー認証が済んでいることを確認するために使用されます。

トラブルシューティング