Jira カードと Jira アドオンで起こり得る問題

Jira カードアプリはインストールされていますが、Miro のチームが Jira に接続されていません。

インストールガイドに従ってください: Jira Cards の設定方法とアンインストール方法。 もしチームの管理者でない場合は、管理者に依頼してください。 

Jira へのリクエストが失敗しました: タイムアウトが発生しました / ホストが不明 / 接続が拒否されました

Jira はイントラネットでしかアクセスできません（間違った IP アドレスを使用して、Jira システムと通信しています）。

私たちの IP アドレス、ドメイン、およびサブドメインを許可リストに追加し、インテグレーションに必要なアクセス権限を提供してください。 

Jira Server を利用しており、古いバージョンの場合は、Miro へのアクセスを妨げるダーク機能がないか確認してください。

OAuth 1.0（Jira サーバーとデータセンター）にのみ適用されます。

Jira のアプリケーションリンクが正しく設定されていません

- リンクや Webhook の設定で一部の手順が実行されていません。

- Jira カード用のリンクを設定する代わりに、Jira アドオンをインストールしました。

Jira カード インテグレーションを最初からインストールしてみてください。 

Webhook を手動で作成することを選択した場合は、自動で作成してみてください。

OAuth 1.0 に適用されます。 (Jira サーバーとデータセンター) のみ。

Jira のインスタンスのアプリケーション リンクが正しく設定されていないか、トークンの有効期限が切れています。アプリのリンクを確認し、インテグレーションを再度接続してください。

- Jira のアプリケーション リンクが再設定された

- トークンの有効期限が切れている

- トークンが無効になっている

アプリケーション リンクが正しく設定されていることを確認し、Miro を Jira カードに再度接続してみてください。

高度に保護された Jira を使用している場合や、プロキシーを使用している場合は、 許可リスト に Miro の IP アドレス、ドメイン、サブドメインを追加して、インテグレーションに必要なアクセス権限を提供してください。 

Jira サーバーを利用していて、古いバージョンの場合、ダークフィーチャーが Miro へのアクセスを妨げていないかを再確認してください。

OAuth 1.0 に適用されます。（Jira サーバーとデータセンター）のみ。

アプリのリンクで、URL、Consumer Key（コンシューマーキー）、Consumer Name（コンシューマー名）、公開鍵以外の値を入力するよう求められる

設定メニューの送信認証タブが表示されています。

- 受信認証に切り替えてください。送信認証は設定不要です。

- この手順をスキップできない場合は、任意の一時的な値を追加してください。一時的な値を削除するには、アプリケーション リンク一覧ページで Miro カードのリンクを編集して、一時的な値を削除します。 

OAuth 1.0 に適用されます。（Jira サーバーとデータセンター）のみ。

Jira URL が無効です /
Jira ベース URL を入力してください /
無効なリクエストです。デシリアライゼーションエラー。

Jira がプライベート ネットワーク上にある / 会社のファイアウォールが外部のネットワーク接続をブロックしています。

当社の NAT ゲートウェイの IP アドレス（およびポート）を許可リストに追加してください。 
*nslookup を使って IP アドレスを確認すると、結果はロードバランサーのアドレスを返しますが、このアドレスは時間の経過とともに変化する可能性があります。

プロキシーを使用している / 外部と内部の Jira の URL が一致していない。

アクセス可能なアドレスで Jira URLフィールドを必ず入力してください。そのためには、リバースプロキシを構成して私たちがアクセスできるようにするか、 この Atlassian ガイドの手順に従ってください。このソリューションを用いると、外部の URL と内部の URL が異なる場合でも、インテグレーションが Jira と Miro の間を正常に接続し、リクエストを転送できるようになります。
プロキシサーバーのタイムアウト値を延長することも検討してください。エンドポイントのリストはここで見つけることができます。
Jiraカードに関するFAQ

SSL証明書に問題があります（自己署名証明書はサポートされていません）。

Jira サーバーのアクティブな SSL 証明書を確認してください。このツールをお試しください：Jira の URL を入力し、接続チェックの結果を表示します。
例：証明書は正しいかもしれませんが（緑色の証明書）、サーバー証明書チェーンが不完全な場合があるため（黄色の鍵交換）、システムには証明書を更新する必要があるという応答が届きます。
こちらのサイトをご覧になり、解決してください。

Jira が SSO の対象になっています（受信認証が正しく設定されていませんというエラーが発生する場合もあります）。

SSO プロセスがインテグレーションの接続リクエストに適用されていないことを確認してください。 そのためには、以下のエンドポイントを SSO プロセスから除外する必要があります：

GET {JIRA_URL}/rest/api/2/serverInfo
(OAuth 1.0) POST {JIRA_URL}/plugins/servlet/oauth/request-token
(OAuth 1.0) POST {JIRA_URL}/plugins/servlet/oauth/access-token
(OAuth 2.0) POST {JIRA_URL}/plugins/servlet/oauth2/*

インストール中に予期しない動作が発生

Jira のバージョン 6.4 以下を使用している。

当社のカードはこれらのバージョンでは動作しません。 この Jira バグにより発生します。Jira を最新バージョンに更新してください。

アプリの認証に失敗しました。もう一度アプリの認証を試みてください。 

1. 一瞬の接続断です。接続を再度クリックしてください。

2. 認証手続き中に送信されたトークンの有効期限が切れています。キャッシュされたデータをクリーンアップし、新しい環境から始めてください。つまり、Jiraが新しいトークンを生成するように促してください。

OAuth 1.0 に適用されます。（Jira サーバーとデータセンター）のみ。

Jira エラー：「Miro の Webhook の作成権限がありません。」

Jira の管理者権限がありません。インテグレーションを設定できるよう、Jira の管理者に依頼して役割を管理者にアップグレードしてもらってください。

Jira へのリクエストに失敗しました：PKIX パスの構築に失敗しました：リクエストされたターゲットに対する有効な認証パスを見つけることができません

サーバー証明書に問題があります。
 
解決策として、IT 部門に連絡し、そちら側の証明書を確認するよう依頼してください（Web サーバーをリロードし、証明書が公開信頼されていることを確認するなど）。 

Miro 経由で Jira の認証ができません。
エラー: 例外
(例: io.netty.handler.timeout.ReadTimeoutException)

これは、Jira インフラストラクチャーの設定ミスが原因で発生する可能性があります。インフラストラクチャーの設定は HTTP/2 プロトコルのサポートを示していますが、それを使用しようとするとデータ転送は行われません。ウェブサーバーの設定ファイルで HTTP/2 の設定が、正しく設定されているか確認してください。

必要に応じて、サーバー設定で HTTP/2 サポートを一時的に無効化して、問題が解決されるまで下位互換性と中断することのないサービスを確実に提供します。

Jira カードが更新されない

OAuth 1.0 にのみ適用されます。（Jira サーバーとデータセンター）

手動の Webhook を使用しています。

インテグレーションを無効にし、自動 Webhook を使用して再度接続してください。自動 Webhook を使用してすべてが正常に機能している場合、手動の Webhook が正しく設定されていないことになります。

また、Jira カード用 WebHook の設定方法を参照してください。 

OAuth 1.0 および OAuth 2.0（Jira Server & Data Center）に適用されます。

自動Webhookを使用している場合、最初のトラブルシューティング手順はインテグレーションを再接続することです。それでも解決しない場合、Jiraカードが更新されない理由はいくつか考えられます。以下はその一例です。

- Miroのボードが別のチームにバックアップを介して移動またはダウンロードされた

- Jira側で1つのプロジェクトから別のプロジェクトにJira課題が移動された

- Jira課題があるプロジェクトにアクセス権がない

- （Enterpriseのみ）ボードの所有者が非アクティブ化されているか、制限付き無料ライセンスが適用されています

- (OAuth1.0 のみ) Jira カードが現在使用中のブラウザの同じ Jira インスタンスにありません。

OAuth 1.0 にのみ適用されます。（Jira サーバーとデータセンター）

Jira カードが突然更新しなくなった場合、再接続を試みると、Jira のアプリケーションリンクが正しく設定されていないことがあります。

認証エラーが発生したため、Miro が接続された Jira にリクエストを送信できない場合、エラーメッセージが表示されることがあります。これは、インテグレーションを設定したユーザーがトークンを無効にするあるいは Jira が何らかの理由で発行されたトークンの寿命が短く設定されている ために発生し、この時間が経過すると単純にトークンが無効になり、新しい有効な認証トークンを取得するために再接続が必要になります。

カードの編集オプションが空白のウィンドウを返す

OAuth 1.0 にのみ適用されます。（Jira サーバーおよびデータセンター）

Jira のバージョン 7.6 以上を使用しています。

セキュリティー上の理由により、Atlassian が、iFrames にコンテンツを埋め込むことを許可しない場合があります。これは、Jira カードの編集を行うポップアップ ウィンドウにも影響することがあります。これらの指示を回避策として使用できます。

Jira カードを追加できません

OAuth 1.0 に適用されます。（Jira サーバーとデータセンター）のみ。

手動の Webhook を作成し、設定情報が保存されていません。

Jira URL フィールドが Miro 設定 内で入力されているか確認してください。必ず接続 をクリックしてください

編集 アイコンが表示されない

OAuth 1.0 に適用されます。（Jira サーバーとデータセンター）のみ。

Jira のサーバーバージョン 7.6 以上を使用している。

このバージョンでは、セキュリティー更新のため、編集アイコンが表示されない場合があります。

プロフィールでは、当該 Jira 課題を編集することはできません。

Jira 側で課題を開き、編集モードにアクセスできるか確認してください。

あなたには次のメッセージが表示されます: ログインしていないため、選択した課題に対してゲストとして操作するのに必要な権限がありません。ログインしてください。

インテグレーションのクッキーの使用方法により、このページから Jira にログインできない場合があります。

別のブラウザータブで Jira にログインしてください。
ご使用のブラウザーでサードパーティーのクッキーが許可されていることを必ず確認してください。

Jira が SSO の対象になっているため、IdP は、iFrames 経由の認証を許可していません。

Miro のデスクトップアプリで作業している場合は、miro.com で Miro のブラウザーバージョンに切り替えることをお勧めします。

特定のプロジェクトを選択すると、Miro の Jira カードを変換 / 作成するオプションが表示されない：

- 課題タイプのフィールドにデータがない

- 変換 / 作成 ボタンが非アクティブ

Jira のプロジェクトにアクセス権がありません。アクセス権を取得できるか確認してください。

Jira 課題を作成できない 新しい Jira カードを変換/作成しようとした場合: 

Jira 課題を作成する権限がありません。

Jira の管理者に連絡し、Jira 側で必要な権限を付与するよう依頼してください。本来の表示はこのようになります:

一部のカスタムフィールドが、Jira 課題に変換 / Jira 課題を編集メニューに表示されない

Jira 課題を作成できない。 必要なフィールド（...）がサポートされていませんというエラーが Miro 内で Jira 課題を作成すると表示される

ボードの Jira カードピッカーで、フィールドが有効になっていません。

このガイドの手順に従って、アプリ内の Jira ピッカーを使用してカスタムフィールドを設定してください。

カードに表示するフィールドの選択で、Jira のカスタムフィールドが表示されない場合、Jira インスタンスのプロジェクトに設定されたスクリーンの一部が、Miro に対してフィールドを隠している可能性があります。

プロジェクト設定 > スクリーン > デフォルトのスクリーンスキームに移動し、必要なフィールドが許可されているか確認してください。

Miro は、複雑なデータタイプのフィールドをサポートしていません。

Miro は、基本的なカスタムフィールドをサポートしていますが、複雑なものはサポートしていません。 Jira カードフィールドを設定し、サポートされていないフィールドを削除してください。

Jira カードの編集 / 作成時に、報告者 を選択できません。

Jira の作成メタデータに 報告者 フィールドはありません。選択されたプロジェクトの Jira の 作成画面で、このフィールドは利用できません。

プロジェクト設定 > 画面 に移動し、報告者 フィールドが作成画面にあるか確認してください。

選択したプロジェクトの課題に報告者を設定するのに必要な権限がありません。

Jira の管理者にアクセスレベルを確認してもらい、選択したプロジェクトの報告者フィールドを設定 / 変更する権限があることを確認してもらってください。そのためには、Jira にログインし、設定 > 課題 > 権限スキーム に移動し、報告者の変更フィールドを確認します（リストにない場合はアプリケーションアクセス：ログインしているユーザーを追加してください）。

監査証跡では報告者のフィールドは編集できず、その課題の作成者に設定されています。

通常このフィールドは編集できないようになっています。

一部のフィールドは、編集モードのカードで表示されるが、ボードの Jira カードには表示されない

Miro が、Jira の更新情報を受信していません。

• 別のネットワークに切り替える
• インテグレーションを再接続する

OAuth 1.0 に適用されます。（Jira サーバーとデータセンター）のみ。

Jira を利用できません エラーが Jira カードアプリ設定に表示されます

1. チームの管理者にインテグレーションを無効にし、再度接続するよう依頼してください。

2. Jira は保護されているため（ファイアウォール、セキュリティー ブロッカーなど）、Miro からはアクセスできません。

Jira カードが、Miro と Jira の間で同時に同期している場合、Jira は Webhook を送信できることになります。 そのためボード上で更新情報を確認することができます。

解決策として、IT 部門とこの問題について話し合い、Miro が適切に許可されているか再度確認してもらうことをお勧めします。 

Jira Server をご利用で、古いバージョンの場合、ダークフィーチャーがMiroへのアクセスを妨げていないことを再確認してください。

OAuth 1.0 に適用されます。（Jira サーバーとデータセンター）のみ。

Jira Webhook の問題Jira カードのアプリ設定のエラー

- Jira 側で Webhook を変更 / 削除した場合、
- Miro は、Jira から「不正なリクエスト」のレスポンスを受け取ります。

Ctrl + V（Windows の場合）/Cmd + V（ Mac の場合）を使用してボードに Jira 課題のリンクを貼り付けると、Jira カードには変換されず、URL として貼り付けられる

ボードがまだ読み込み中です。大容量のボードや、大きな画像や PDF ドキュメントがあるボードで発生することがあります。 

ボードを開いた後少なくとも 10 秒、完全に読み込むまで待ってください。その後、再度リンクを貼り付けてみてください。

ボード上の Jira カードに詳細情報が表示されない

カードの詳細を見るには、カードをクリックして展開を選択し、ボードのサイドバーにカードの詳細を表示します。 

利用可能なスプリントを検索しようとすると、「一致するスプリント 0 件中 0 件」と表示される

1. アクティブなスプリントや将来のスプリントがない（すべてクローズ/完了した）場合に発生します。 

2. Jira のフィルターにプロジェクトが含まれていません。ボードフィルターの JQL に必要なプロジェクトを追加してください。そうすれば、Jira と Miro の両方でスプリントが表示されます。

OAuth 1.0 にのみ適用されます。（Jira サーバーとデータセンター）

SSL 接続が失敗しました

このエラーは、Miro がユーザーの Jira にアクセスできないことを意味します。

Miro チームの管理者に連絡し、Jira カード設定の Jira のベース URL フィールドに接続できるアドレスが記載されているかどうか確認してください。

Jira のグローバルレベルで「ユーザーの閲覧」権限が設定されていることを確認してください。 グローバル権限の管理方法についてはこちらをご確認ください。