他のアプリケーションにリンクする
アプリケーション リンク (アプリ リンクとも呼ばれます) によって、複数のアトラシアン製品全体でリンクのセットアップ、情報の共有、特定のリソースまたは機能に対するアクセス権の提供を実現できます。Jira を他のアプリケーションにリンクすることで、これらのシステムの情報を Jira プロジェクトや課題に含められます。
たとえば、Jira を Confluence にリンクしている場合は、課題の作成時または編集時に wiki ページへのポインターを含められます。別の一般的なユース ケースは、Bitbucket Data Center と Jira をリンクさせることです。これによって、Jira 課題に対応するブランチ、コミット、プル リクエストを表示できます。アトラシアン製品に加えて、外部のアプリにもリンクできます。たとえば、アプリケーション リンクを介して ZenDesk や Salesforce のデータを共有可能にするアプリを使用できます。
アプリケーション リンクを表示する
アプリケーション リンクを表示するには、次の手順に従います。
[管理] > [アプリケーション] の順に移動します。
[アプリケーション リンク] を選択します。次のページが表示されます。
アプリケーション: リンクされたアプリケーションの名前とそのバージョン。外部アプリケーションの場合は、常に [汎用アプリケーション] と表示されます。
方向: 通信の方向。[受信]、[送信]、[双方向] のいずれかが表示されます。アトラシアン製品の場合は双方向通信を設定する必要がありますが、一部の外部アプリケーションでは双方向通信は不要です。
ステータス: 接続の状態。外部アプリケーションの場合は、常に [アトラシアン以外] と表示されます。
アクション: リンクに対して実行できるアクション。
- リモートに移行 – アプリケーション リンクの設定全体を開きます。
- プライマリとして選択する – 同じタイプのアプリ（たとえば、複数の Jira インスタンス）へのリンクが複数ある場合に、既定のインスタンスを指定します。
- 削除 – Jira からアプリケーション リンクを削除します。
OAuth 2.0 接続の場合は、さらに OAuth 認証情報が表示されます。
OAuth 2.0 を使用して Jira Data Center を他のアトラシアン製品にリンクする
OAuth 2.0 とアプリケーション リンクを使用して、Jira Data Center を他の Data Center またはクラウドベースのアトラシアン製品 (Confluence Software Cloud など) に接続することができます。OAuth 2.0 を使用してアトラシアン製品間の接続を確立する手順は以下のとおりです。
ローカル アプリ (リンク元のアプリ) で受信 OAuth 2.0 リンクを設定します。
リモート アプリ (リンク先のアプリ) で受信 OAuth 2.0 リンクを設定します。
ローカル アプリ (リンク元のアプリ) で送信 OAuth 2.0 リンクを設定します。
リモート アプリ (リンク先のアプリ) で送信 OAuth 2.0 リンクを設定します。
設定中、ローカル アプリとリモート アプリの間で情報を交換します。受信リンクと送信リンクの両方を編集できます。
受信 OAuth 2.0 リンクを設定するには (ステップ 1 および 2):
受信リンクの設定は、プロセスの最初の手順です。次の手順を実行すると、クライアント ID とクライアント シークレットを取得できます。これらの認証情報は、リンクされるリモート アプリ側で送信リンクを設定するために重要です。
[管理] から [アプリケーション] を選択し、次に [アプリケーション リンク] を選択します。
[アプリケーション リンク] で [リンクを作成] を選択します。
[Application type (アプリケーション タイプ)] として、[アトラシアン製品 (OAuth 2.0 経由)] を選択します。
リンクするアトラシアン製品のアプリケーション URL を入力します。
URL を確認し、[続行] を選択します。
リダイレクト URL を入力して受信リンクを作成します。
Data Center から Data Center への接続を設定するときは、リダイレクト URL をリモート アプリの送信画面から取得する必要があります。Data Center から Cloud への接続では、リダイレクト URL は非表示になり、自動的に入力されます。
他の管理者に設定を依頼している場合は、リンク先のアプリ側でリモート リンクが定義されるまで待つことが必要になる場合があります (送信リンクの作成)。その場合、最初はプレースホルダーを使用しておき、リモート アプリ側からリダイレクト URL を受け取ってから編集することをお勧めします。
[Permission (権限)] ドロップダウン メニューから [Read (読み取り)] を選択します。
[続行] を選択します。
認証情報を保存またはコピーします。
リンクするアプリ (リモート アプリ) 側で 1～6 の手順を繰り返します。プロセスの最後に、必ず認証情報をコピーして保存してください。
以上で、受信リンクが設定できました。次に、送信 OAuth 2.0 リンクを設定します。
送信 OAuth 2.0 リンクを設定するには (ステップ 3 および 4):
- [Incoming link details (受信リンクの詳細)] 画面で [Configure outgoing (送信の設定)] を選択します。送信リンクの設定ページにリダイレクトされます。
リンクされる (リモート) アプリの設定中に受け取ったクライアント ID とクライアント シークレットを入力します。
Confluence Data Center を任意の Atlassian Data Center 製品に接続する場合は、スコープを読み取りと定義します。
リンクされる (リモート) アプリの受信リンク設定のリダイレクト URI を使用します。
設定を保存して、双方向通信モードを設定します。
OAuth 2.0 リンクを編集するには:
- [管理] から [アプリケーション] を選択し、次に [アプリケーション リンク] を選択します。
[アクション] に移動します。リンクに対して実行できるアクションが表示されます。
- リモートに移行 – このオプションを使用するとアプリケーション リンクの設定全体が開き、アプリの URL にリダイレクトされます。
- 資格情報を表示 – ここでは、受信リンクのクライアント ID とクライアント シークレットを確認できます。
受信リンクを編集 - ここでは受信リンクを編集できます。リダイレクト URL を更新するには、この操作を行う必要があります。
送信リンクを編集 - ここでは送信リンクを編集できます。
テスト接続 - ここでは、送信リンクの OAuth 2.0 構成が正しいかどうかを確認できます。
- 削除 – このオプションを使用して、Jira からアプリケーション リンクを削除します。
OAuth 1.0 によってアトラシアン製品または外部アプリケーションにリンクする
他のアトラシアン製品にリンクする際は、通信に OAuth 1.0 を使用します。
また、このオプションによって、OAuth 1.0 を使用する外部アプリケーションにリンクできます。OAuth 2.0 を使用するために統合をアップグレードできないユーザーには、このオプションが用意されています。
OAuth 1.0 によって他のアトラシアン製品または外部アプリケーションにリンクするには、次の手順に従います。
アプリケーション リンクで [リンクを作成] を選択します。
リンク タイプとして [アトラシアン製品] を選択します。
アトラシアン製品または外部アプリケーションの URL を入力します。
ウィザードのステップに従います。Jira とリンク先の製品の間でリダイレクトされるので、双方向接続を承認します。
OAuth 2.0 によって外部アプリケーションにリンクする
双方向で OAuth 2.0 によって Jira を外部アプリケーションにリンクできます。Jira をクライアント (送信リンク) またはプロバイダー (受信リンク) として機能させます。
Jira を OAuth 2.0 クライアント (送信リンク) として設定する
このシナリオでは Jira は OAuth クライアントとして機能して、外部アプリケーションからデータをリクエストします。
次の場合に選択します。
Google や Microsoft などの外部メール プロバイダーとの統合を設定して、ユーザーがメールから課題やコメントを作成できるようにする必要がある。
DVCS アカウントによって GitLab を開発ツールと統合する。
詳細については「送信リンクを設定する」をご確認ください。
Jira を OAuth 2.0 プロバイダー (受信リンク) として設定する
このシナリオでは、Jira は OAuth プロバイダーとして機能するため、外部アプリケーションからそのデータにアクセスできるようになります。
次の場合に選択します。
OAuth 1.0 を現在使用している内部統合があり、それを OAuth 2.0 に更新してセキュリティを強化する。OAuth 2.0 の実装に役立つ詳細を記載しています。
詳細については「受信リンクを設定する」をご確認ください。
Microsoft を新しいプロバイダーとして追加するには、Microsoft Azure の OAuth キーとシークレットが必要です。これらの生成方法をご確認ください。