Jira との連携のトラブルシューティング

API キー接続のタイムアウトや IP 制限エラーなど、Jira Server や Jira Cloud を Test Manager に接続する際の接続や構成の問題に対する解決策です。

Jira Server に API キーを追加すると接続がタイムアウトしていました

解決策

Jira Server プラグインに Given configuration is invalid. Please check Server Url and API Key. org.apache.http.conn.ConnectTimeoutException: Connect to cloud.uipath.com:443 ... failed: Connect timed outと表示される場合、API キーが原因であることはめったにありません。このエラーは、ほとんどの場合、Jira Server ホストの送信ファイアウォールまたはプロキシが cloud.uipath.comへのポート 443 をブロックしていることを示します。

この問題を診断して解決するには、以下の手順を実行します。

1. Jira Server ホストから、curl -v --connect-timeout 10 https://cloud.uipath.com または telnet cloud.uipath.com 443を使用して、ポート 443 で cloud.uipath.comへのアウトバウンド接続を確認します。
2. 接続に失敗した場合は、Jira Server ホストからの送信 HTTPS トラフィックの cloud.uipath.com を許可するようネットワーク チームに依頼してください。
3. Jira プラグインの [ サーバー URL ] フィールドが https://cloud.uipath.com/{OrgName}/{TenantName}/testmanager_の形式であることを確認します。
4. API キーが Test Manager から正しくコピーして貼り付けられたこと、および有効期限が切れていないことを確認します。

注:

Jira Server (Jira Data Center) 接続でサポートされている認証方法は基本認証のみであり、変更することはできません。

Jira の「テスト」の課題タイプがテスト ケースではなく要件として同期されていました

解決策

Jira とのネイティブ連携では、要件と不具合の 2 種類の課題のみがサポートされています。Xray の「Test」や Zephyr の同等のものなど、テスト管理アドオンのカスタム課題タイプには Test Manager のテスト ケースへのネイティブ マッピングがないため、代わりに要件として同期されます。カスタムの課題タイプをテスト ケースとして同期するには、ネイティブ連携の代わりに Test Manager Connect を使用します。

Jira Cloud の同期が「Unauthorized for syncthis requirement (この要件を同期できませんでした)」で失敗する

解決策

Jira Cloud から Test Manager への同期が Requirement sync-status: Unauthorized for syncing this requirement. Please recheck your api-key.で失敗する場合、必ずしも API キーが原因であるとは限りません。このエラーは、UiPath 組織で IP 制限が有効化されている場合にも発生する可能性があります。

UiPath® Test Manager for Jira アプリは、Atlassian Forge の IP アドレスから要求を送信します。これらのアドレスが許可されていない場合、UiPath Platform は、Jira から Test Manager への要求が Test Manager に到達する前に、403 ステータス コードで拒否されます。Test Manager から Jira への同期は引き続き機能します。

この問題を解決するには次の手順を実行します。

1. Jira アプリの API キーが正しく、正しい Test Manager 接続に属していることを確認します。
2. Jira インスタンスにインストールされている UiPath® Test Manager for Jira アプリのバージョンと、Atlassian Marketplace に掲載されているバージョンを比較します。
3. バージョンが異なる場合は、Atlassian Marketplace に掲載されているバージョンをインストールし、他のバージョンをアンインストールします。
4. UiPath の組織管理者に、[ 管理] > [セキュリティ ] > IP 制限に移動し、Atlassian が ip-ranges.atlassian.com で公開するエグレス IP 範囲を追加するか、組織の IP 制限を除外するよう依頼してください。

注:

Atlassian は静的 IP アドレスを使用せず、IP 範囲をいつでも変更できます。許可リストを、Atlassian が公開した範囲と同期させてください。許可リストが古くなっている場合、同期が断続的に失敗することがあります。