OAuth を使用するようにアプリケーション リンクを更新する
バージョン 5.2 以降、Application Links プラグインでは OAuth 認証のみがサポートされます。信頼済みのアプリケーションおよびベーシック アクセス認証タイプは現時点で廃止予定で、サポートを終了しています。
When you first upgrade to an Atlassian server application that bundles version 5.2 (or later) of the Application Links plugin, you may need to update your application links. See the Application Links version matrix. This page has detailed instructions for how to update application links.
更新が必要なリンクは、アプリケーションの管理領域の [アプリケーション リンクの設定] ページの 非推奨 バッジで確認できます。ほとんどの場合、リンクは自動的に更新できます。
アプリケーション リンクが意図したように動作しない場合、「アプリケーション リンクのトラブルシューティング」ページを参照して問題を解決してから先に進みます。
最適な更新パスの選択
以降で説明する自動更新パスを推奨しますが、次の表で条件を確認して、ご利用のアプリケーション リンクに最適な更新パスを選択することもできます。
| 更新パス (クリックして手順を確認) | リンクのステータス | リンクでの信頼済みアプリまたはベーシック アクセス認証の使用有無 | リンクでの OAuth 認証の使用有無 | リモート アプリケーションにシステム管理権限でログインしているかどうか |
|---|---|---|---|---|
| 1. 自動更新 (推奨) | 非推奨 |  |  | |
| 2. 手動更新 | 非推奨 | | | |
| 3. 非推奨の自動削除 | 非推奨 | | | |
| 4. 非推奨の手動削除 - 新しいプラグイン バージョン | 非推奨 | | | |
| 5. 非推奨の手動削除 - 古いプラグイン バージョン | 非推奨 | | | |
パス 1: OAuth 認証への自動更新 (推奨)
自動更新を行うことを強く推奨します。自動更新パスは、アプリケーション リンクの両端に OAuth 認証を追加し、新しい接続が適切に動作していることを確認して、リンクの任意の信頼済みアプリケーションまたはベーシック アクセス認証タイプを無効化します。
アプリケーション リンクの自動更新は、リモート アプリケーションのシステム管理権限を持つアカウントを使用してローカル アプリケーションにログインしている場合にのみ行える点にご注意ください。このようなアカウントがない場合、次のいずれかを行えます。
- 自動更新を行えるよう、システム管理権限を一時的に取得する
- 条件を満たすアカウントを保持しているユーザーを社内で見つけ、自動更新を依頼する
- このページの手動の更新パスに従う
ダイアログの [更新] をクリックします。
これで完了です。おつかれさまでした。
パス 2: 非推奨から OAuth 認証に手動で更新
自身のアカウントでリモート アプリケーションでのシステム管理権限を一時的に取得し、自動更新パスを利用することを強くおすすめします。これが不可能な場合、このセクションで説明している手動の更新パスをご利用ください。
手動の更新パスでは、アプリケーション リンクの両端に手動で OAuth 認証を追加し、リンクの任意の信頼済みアプリケーションまたはベーシック アクセス認証を無効化します。
このパスは、リモート アプリケーションでのシステム管理権限を持たないアカウントでローカル アプリケーションにログインしていて、そのようなシステム権限を得られない場合に利用できます。
Begin in the local application
まず、リンクのこちら側の終端に OAuth 認証を追加します。
Go to the 'Configure Application Links' page in the admin area of the local application.
更新が必要なリンクの横に 廃止予定 マークが表示されます。
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
リンクの "remote" 終端に OAuth 認証を追加します。表示されている UI に一致する手順の列を選択します (いずれも同じ結果になります)。
Application Links バージョン 5.2 以降を使用しているアプリケーションの場合
リモート アプリケーションの管理領域の [アプリケーション リンクを設定] ページに移動します。
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.
Application Links プラグインの 5.2 よりも前のバージョンを使用しているアプリケーションの場合
アプリケーションの管理領域の [アプリケーション リンクを設定] ページに移動します。
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.
[更新] をクリックします。
ダイアログを閉じます。
これを完了すると、リンクに廃止予定バッジが表示されます。これは予期される挙動です。
次に、リンクの "remote" 終端で任意の信頼済みアプリまたはベーシック アクセス認証を無効化します。引き続き [アプリケーション リンクを設定] ページにいることを確認したら、再び、表示している UI と一致する手順の列を選択します (いずれも同じ結果になります)。
Application Links プラグインのバージョン 5.2 以降を使用しているアプリケーションの場合
ダイアログの [更新] をクリックします。
Application Links プラグインの 5.2 よりも前のバージョンを使用しているアプリケーションの場合
[設定] ダイアログで [送信認証] > [信頼済みアプリケーション] タブの順にクリックします。
[無効化] をクリックします。
[ベーシック アクセス] タブでも [無効化] をクリックします。
[受信認証] についても、手順を実行します。
[無効化] をクリックします。
[ベーシック アクセス] タブでも [無効化] をクリックします。
ダイアログを閉じます。
完了すると、リンクに対して 接続済み バッジが表示されます。
ローカル アプリケーションに戻る
更新するリンクの横に 廃止予定 バッジが表示されます。
リンクの "local" 終端で任意の信頼済みアプリまたはベーシック アクセス認証を削除する必要があります。
ダイアログの [更新] をクリックします。
リンクに対して 接続済み バッジが表示されます。これで完了です。
パス 3: OAuth のみが使用されるよう、廃止予定の認証を自動的に削除する
アプリケーション リンクで OAuth がすでに動作している場合、リンクを更新すると、リンクに存在する任意の信頼済みアプリケーションまたはベーシック アクセス認証が対象に含まれます。
リモート アプリケーションのシステム管理権限を持つアカウントを使用してローカル アプリケーションにログインしている場合、リンクは自動的に更新できます。このようなアカウントがない場合、次のいずれかを行えます。
- 自動更新を行えるよう、システム管理権限を一時的に取得する
- 条件を満たすアカウントを保持しているユーザーを社内で見つけ、自動更新を依頼する
- このページの手動の更新パスに従う
ダイアログの [更新] をクリックします。
これで完了です。おつかれさまでした。
パス 4: 新しいバージョンを使用するときに、廃止予定の認証を手動で削除
Application Links プラグインのバージョン 5.2 以降を使用しているアプリケーションの場合
アプリケーション リンクで OAuth がすでに動作している場合、リンクを更新すると、リンクの両端に存在する任意の信頼済みアプリケーションまたはベーシック アクセス認証が対象に含まれます。
自身のアカウントでリモート アプリケーションでのシステム管理権限を一時的に取得し、自動更新パスを利用することを強くおすすめします。これが不可能な場合、このセクションで説明している手動の更新パスをご利用ください。
Begin in the local application
ローカル アプリケーションの管理領域の [アプリケーション リンクを設定] ページに移動します。
ダイアログの [更新] をクリックします。
次の警告が表示されます。
以降の説明を参考に、廃止予定のすべての認証タイプをリモート アプリケーションから削除します。
Now, in the remote application
再び、リモート アプリケーションの管理領域の [アプリケーション リンクの設定] ページに移動します。
ダイアログの [更新] をクリックします。
パス 5: 古いバージョンを使用するときに、廃止予定の認証を手動で削除
Application Links プラグインの 5.2 よりも前のバージョンを使用しているアプリケーションの場合
アプリケーション リンクで OAuth がすでに動作している場合、リンクを更新すると、リンクのリモート側の終端に存在する任意の信頼済みアプリケーションまたはベーシック アクセス認証が対象に含まれます。
自身のアカウントでリモート アプリケーションでのシステム管理権限を一時的に取得し、自動更新パスを利用することを強くおすすめします。これが不可能な場合、このセクションで説明している手動の更新パスをご利用ください。
Begin in the local application
ローカル アプリケーションの管理領域の [アプリケーション リンクを設定] ページに移動します。
[設定] ダイアログで [送信認証] > [信頼済みアプリケーション] タブの順にクリックします。
[無効化] をクリックします。
[ベーシック アクセス] タブでも [無効化] をクリックします。
[受信認証] についても、手順を実行します。
[無効化] をクリックします。
[ベーシック アクセス] タブでも [無効化] をクリックします。
ダイアログを閉じます。
Now, in the remote application
再び、ローカル アプリケーションの管理領域の [アプリケーション リンクの設定] ページに移動します。
[設定] ダイアログで [送信認証] > [信頼済みアプリケーション] タブの順にクリックします。
[無効化] をクリックします。
[ベーシック アクセス] タブでも [無効化] をクリックします。
[受信認証] についても、手順を実行します。
[無効化] をクリックします。
[ベーシック アクセス] タブでも [無効化] をクリックします。
ダイアログを閉じます。これで完了です。