この記事では、Jira カードのインテグレーションがどのように構築されているかに関する最もよくある質問に対する回答を掲載しています。
Jira-Miro の認証はどのように行われますか？
ヘルプセンターの記事をご参照ください
- Jira Server（オンプレミス）
- Jira Data Center（オンプレミス）
-
Jira Cloud
Jira Cards の設定ページから選択してください。
Jira と Miro 間で転送されるデータは保護されていますか？
Miro では、TLS セキュリティー プロトコルを使用しています。送信前に HTTP メッセージを暗号化し、受信時にメッセージを解読します。Enterprise プランでは、相互 TLS もサポートしています。
相互 TLS をサポートしていますか？
はい、詳細はこちらをご覧ください。
Miro は、顧客の Jira データを保持しますか？
はい、Miro はボードに追加されたカードのデータを保持します。
保管期間はどのくらいで、データはどのように保護されますか？
OAuth 1.0 の場合（Jira サーバーまたはデータセンター）、Jira Cards プラグインの設定プロセス中に Webhook が設定されていると、データは更新されます。保管期間に制限はありません。一般的な Miro のセキュリティー プロトコルのみが適用されます。
Miro から取得できる情報を制限する方法はありますか？
Atlassian のドキュメンテーションには、情報をいくつかのフィールドに制限する方法についての記載はありませんでした。
認証時、通常使用時など、Jira と Miro 間のデータの流れを図で示すことはできますか？
詳細については、こちらの Jira 開発者の記事をご覧ください。Atlassian ドキュメンテーションに従って Miro のインテグレーションを実装しています。
トークンの取り扱いはどのように行っていますか？
OAuth 1.0：アクセストークンのみが使用されます。アクセストークンは無効にされない限り 5 年間有効です（このポリシーは Atlassian 側で定義されているためカスタマイズするオプションはありません。Web UI を使用して、Jira 側でトークンを取り消すことができます）。新しいトークンが発行されるとインテグレーションの動作が停止し、再接続が必要になる点に注意してください。
OAuth 2.0：アクセストークンは 1 時間有効です。リフレッシュトークンは 90 日間有効です（90 日間インテグレーションを使用しない場合は、再認証が必要になります）。
顧客全員の Jira アクセスに 1 つのアクセストークンを使用していますか？
Jira カードをインポート、作成、編集する予定のすべての Miro ユーザーは、各自の Jira 認証情報を接続する必要があります。上記の操作はすべて、各自の Jira 認証情報でのみ実行できます。
リクエストトークン、アクセストークン、秘密鍵、その他の OAuth の秘密/認証情報はどのように保護されていますか？
インテグレーション中は、アクセストークンのみが使用されます。これらはデータベース内で安全に保管され、サーバー側でのみ使用されます。
OAuth 1.0 の場合（Jira Server および Jira Data Center）、authToken は Webhook にのみ使用されます。これは OAuth が使用する実際の認証トークンではありません。リクエストは暗号化された接続で送信されます。秘密鍵は自動生成され、チームごとに紐付けられます。
インテグレーションでは、どのようなエンドポイントを使用していますか？
POST /rest/api/2/issue - 新しい課題を作成
PUT /rest/api/2/issue/id - 課題を更新
GET /rest/api/2/user/picker?query=xx
GET /rest/api/2/myself
GET /rest/api/2/filter/favourite
GET /rest/api/2/issue/picker
GET /rest/api/2/serverInfo
GET /rest/api/2/issue/$key
GET /rest/api/2/issue/createmeta
GET /rest/api/2/issue/$key/editmeta
GET /rest/api/2/priority
GET /rest/api/2/issuetype
GET /rest/api/2/mypermissions
OAuth 1.0 の場合（Jira サーバーとデータセンター）には、さらに以下を使用します：
POST /rest/webhooks/1.0/webhook
カードは Jira のデータセンターと連携していますか？
はい。Miro は Atlassian の承認を受けており、既に多くのお客様がデータセンターで Jira カードを使用しています。インストール手順は同じです。
どの IP を使用して Jira システムと通信していますか？
Miro の固定 IP アドレスの一覧は、こちらです。
これらは、Jira システムと通信するためにだけ使用されるアドレスですのでご注意ください。Miro アプリの IP は動的であり、Miro のボード上のすべての機能（Jira カードに関連するものを含む）が正常に動作するように、Miro のドメインを許可リストに追加してください。
Jira を Miro と統合し、セキュリティーレベルが「非公開」に設定されている Jira 課題を Miro 側でブロックできますか？
いいえ、それはできません。Jira のセキュリティーレベルは Miro と連動しません。
Jira サーバーを使用している場合、Miro を Jira に接続できますか？
Miro はオンラインツールのため、Jira インスタンスがインターネットに公開されている場合にのみ接続できます。
複数の Jira インスタンスを同時に接続できますか？
はい。ただし、Jira インスタンスの接続は初期リンクの確立を意味し、アクティブな接続は現在使用中の接続済みインスタンスを指します。アクティブな接続は、Jira Cards アプリを開いたときにどのインスタンスからカードがインポートされるか、およびユーザーがどのインスタンスに対して認証されているかを定義します。ユーザーごとにアクティブな接続は同時に1つだけ存在します。OAuth 2.0 を使用する場合、ユーザーは既に認証済みの任意のリンク済みインスタンスに紐づく Jira カードを編集できます。その他の認証プロトコルでは、チーム全体が1つのアクティブなインスタンスを共有し、そのインスタンスからのみカードをインポートして操作できます。組織レベルの設定を複数定義し、チームレベルでアクティブな接続を切り替えることができます。
サーバーからクラウドへの移行プロセスはどうなりますか？
クラウドへの移行中に Jira ベースの URL が変更されることは避けられないため、Miro 側で変更しなければインテグレーションは中断されます。サポートが必要な場合は、Miro のサポートまでご連絡ください。
Miro は、チームごと、プロジェクトごと、または Miro のインスタンスごとに Webhook を作成しますか？
設定で「Automatic Webhook」を有効にすると、Webhook の作成は自動で行われます。Jira でチームレベルの認可を使用している場合、Miro はチームごとに Webhook を作成します。組織レベルの認可を使用している場合は、Miro は組織ごとに Webhook を作成します。
Jira カードプラグインは、Next-Gen プロジェクトをサポートしていますか？
はい、サポートしています。
現在、Miro 側で Next-Gen プロジェクト用の Jira カードを作成する場合、エピックのリンク/フィールドがないことにご注意ください。
カスタム Jira フィールドはサポートされていますか？
はい、基本的なタイプのカスタムフィールドはほとんどすべてサポートしています。複雑なデータタイプのフィールドがある場合、ボード上で Jira カードを更新または作成する際にサポートされず、予期しない動作を引き起こす可能性があります。
別の Jira インスタンスに切り替えた場合、既存の Jira カードはどうなりますか？
現時点では、Jira 課題を 1 つのプロジェクトから別のプロジェクトに移動した場合、Miro 側では更新されなくなります。
対応策として、Jira 課題の URL をコピーし（Ctrl/Cmd+C）、Miro のボードに貼り付ける（Ctrl/Cmd+V）ことをお勧めします。そうすることで、Jira カードは新しい値を表示し、自動的に更新されます。
ボードを Miro の別のチームに移動した場合、ボード上の Jira カードはどうなりますか？
Jira カードはボードに残りますが、誰も変更することはできません（移動先のチームに同じ Jira インスタンスが設定されている場合でも）。
カードをクリックすると、メッセージが表示されます：「Jira カードが別のアカウントからインポートされました」。カードを編集可能にしたい場合は、再度ボードにインポートしてください。
Jira カード インテグレーションに追加費用はかかりますか？
Jira カードは、すべての有料プランと Education プランで追加費用なく利用できます（Starter、Business、Education、Enterprise プラン）。
ユーザーはボード上のすべての Jira カードにアクセスできますか？
Jira カード インテグレーションに対する権限により、ユーザーはアクセス権のある Jira プロジェクト内でのみカードを作成および編集できます。
Miro のボード上のすべてのウィジェットはボードにアクセスできるすべてのユーザーに表示されるため、Jira の認証情報を持っていない、または適切な認証情報を持っていないユーザーでも、（タイトルやその他いくつかのフィールドが表示された）折りたたまれた状態の Jira カードを閲覧できますが、カードを展開して詳細を確認したり変更したりすることはできません。
Atlassian は Jira Server のサポートを終了しましたか？
はい。Atlassian は 2024 年 2 月をもって Jira Server のサポートを終了しました。
Miro プランナー／Jira Cards は Jira のカスタムフィールド（カスタム課題タイプ、およびカスタム依存関係）をサポートしていますか？
はい、両方ともサポートされています。Jira に カスタム課題タイプ および カスタム依存関係 のフィールドが設定されており、かつ その Jira インスタンスに Miro プランナーが認証されている場合、これらのカスタムフィールドはプランナーで利用可能になります。
Miro は Jira Data Center の OAuth 2.0 をサポートしていますか？
はい。詳細は OAuth 2.0 を使用して Jira Data Center に接続する をご覧ください。
Jira の課題をテーブルやタイムラインにどのようにインポートできますか？
1つまたは複数の Jira Cards を直接テーブルやタイムラインにドラッグ＆ドロップできます。現時点ではこれが唯一の方法です。
テーブルのどのフィールドが Jira と連携しますか？
Jira のシステムフィールド：
- タイトル
- 説明
- 終了日（Jira の Due Date）
- 担当者
- ステータス
カスタム Jira フィールド: - 「Jira フィールドを追加」で追加した任意のカスタムフィールドと、次の自動マッピングされるフィールド：開始日、見積もり。 テーブルにカスタムフィールドを追加するには、テーブル上部のプラス（+）ボタンをクリックして、Jira フィールドを追加を選択します。同期したい任意のカスタムフィールドを選択してください。
テーブルのどのフィールドが Jira に同期されないのですか？
セルをクリックすると、どのフィールドが Jira に同期されるか確認できます。同期されるフィールドには Jira のロゴが表示されます。その他のフィールドはすべて Miro にのみ保存され、Jira には同期されません。
上記のサポートされている 5 つの Jira フィールドのうち、テーブルやタイムラインでフィールドを編集できないのはなぜですか？
そのフィールドが Jira の編集画面に表示されていない可能性があります。
編集画面にそのフィールドがあるかどうかを簡単に確認する方法：
Miro で該当の Jira カードのサイドパネルを開きます。サイドパネルにそのフィールドが表示されているか確認してください。表示されていない場合は、Jira の編集画面にそのフィールドを追加する必要があります。
稀に、Jira では編集可能でも Jira の編集画面に表示されないフィールドがあります。この場合、Miro 上ではそのフィールドを編集できません。
編集できないフィールドがStart dateまたはEstimateですか？該当する場合は：
Jira にそのフィールドが存在しないか、編集画面に表示されていない可能性があります（前の項目を参照してください）
Start date や Estimate は Jira のカスタムフィールドのため、マッピングの問題が発生している場合があります。
これらのフィールドは次のルールでマッピングします：
- 開始日: We check for fields named: Start Date , StartDate, Target Start
- 工数見積: We check fields named: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Start date または Estimate フィールドが上記のいずれの名前にも当てはまらない場合、編集が機能しない理由の一つと考えられます。
Miro の Table または Timeline で Start Date や Estimate を編集すると、動作しない、または Jira の別のフィールドが更新されるのはなぜですか？
現在、Jira の Start Date と Estimate フィールドは自動マッピングに依存しています。これらは Jira 上のカスタムフィールドであるため、Jira の設定内で前述の条件に一致する複数のフィールドが存在する場合があります。
上記のフィールド名の順序に従って、最初に一致したフィールドを選択します：
例えば、Jira チケットに Story Points と Story point estimate の両方のフィールドがある場合、上のリストに従って最初に一致するのは Story Points です。したがって、テーブル内の Estimate フィールドの変更は Jira の Story Points フィールドを更新し、Story point estimate は更新されません。
現時点では、この問題に対する回避策はありません。もしこの問題が発生する場合は、より高度なフィールドマッピング機能の開発に役立てるため、サポートチームへフィードバックをお送りください。
なぜ 2 つの異なるインスタンスから Jira カードを Table または Timeline にインポートできないのですか？
現在、テーブル/タイムラインにつき 1 つの Jira インスタンスのみをサポートしています。Jira カードがテーブル/タイムラインにインポートされると、そのテーブル/タイムラインは当該の Jira インスタンスにリンクされます。
すべての Jira レコードが削除されても、元の Jira インスタンスへのリンクは残ります。別の Jira インスタンスからカードをインポートするには、新しいテーブル/タイムラインを作成する必要があります。
テーブルやタイムラインで Jira レコードの Status および Assignee フィールドが表示または編集できないのはなぜですか？
現在、Jira の Status および Assignee フィールドはテーブルおよびタイムラインではサポートされていません。期待値を管理し、混乱やデータ損失のリスクを避けるため、これらのフィールドはテーブルとタイムライン上で無効化しています。Jira 上では Status および Assignee フィールドとその内容は存在しますが、テーブルやタイムラインには表示されません。
これらのフィールドは、Jira カードのサイドパネルで直接編集できます。テーブルやタイムラインから行をキャンバスにドラッグすると、Jira カードが再表示されます。
詳細はこちら：