この記事では、Jira カードのインテグレーションがどのように構築されているかに関する最もよくある質問に対する回答を掲載しています。
Jira-Miro の認証はどのように行われますか？
詳細はヘルプセンターの記事をご覧ください
- Jira サーバー（オンプレミス）
- Jira データセンター（オンプレミス）
-
Jira クラウド
Jira カードの設定ページから選択します。- OAuth 2.0（3LO）
Jira と Miro 間で転送されるデータは保護されていますか？
Miro では、TLS セキュリティー プロトコルを使用しています。送信前に HTTP メッセージを暗号化し、受信時にメッセージを解読します。また、Enterprise プランでは相互 TLS もサポートしています。
相互 TLS をサポートしていますか？
はい、こちらの詳細をご覧ください。
Miro は、顧客の Jira データを保持しますか？
はい、Miro は、ボードに追加されたカードのデータを保持します。
保管期間はどのくらいで、データの保護はどのように行われますか？
OAuth 1.0 の場合。（Jira サーバーまたはデータセンター）また、Jira Cards プラグインの設定プロセス中に Webhook が設定されている場合、データは更新されます。保管期間に制限はありません。一般的な Miro のセキュリティー プロトコルのみが適用されます。
Miro から取得する情報を制限できますか？
Atlassian のドキュメントには、情報をいくつかのフィールドに制限する方法についての記載は見つかりませんでした。
Jira と Miro の間のデータのフローを図で示すことはできますか？
この Jira Developers の記事に詳細情報があります。Miro インテグレーションは Atlassian のドキュメンテーションに従って実装されています。
トークンの取り扱いはどのように行われますか？
Oauth 1.0：アクセストークンのみが使用されます。アクセストークンは5年間有効ですが、取り消されない限り（このポリシーはAtlassian側で定義されており、カスタマイズするオプションはありません）。Jira側でWeb UIを使用してトークンを取り消すことができます。新しいトークンが追加されるとインテグレーションが動作しなくなり、再接続が必要です。
OAuth 2.0：アクセストークンは1時間有効で、リフレッシュトークンは90日間有効です（インテグレーションを90日間使用しない場合は再認証が必要です）。
すべての顧客のJiraアクセスに単一のアクセストークンが使用されていますか？
すべてのMiroユーザーは、Jiraカードのインポート、作成、編集を行うために個々のJira認証情報を接続する必要があります。上記のすべての操作は、個々のJira認証情報に基づいてのみ実行できます。
リクエストトークン、アクセストークン、秘密鍵、その他の OAuth 秘密/認証情報はどのように保護されていますか？
インテグレーション時には、アクセストークンのみが使用されます。それらはデータベース内で安全に保管され、サーバー側でのみ使用されます。
OAuth 1.0 の場合。（Jira サーバーとデータセンター）認証トークンは 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 システムと通信していますか？
私たちの静的 IP アドレスのリストは、こちらでご覧いただけます。
これらは Jira システムとの通信にのみ使用されるアドレスですのでご注意ください。Miro アプリの IP は動的であり、Miro のボード上のすべての機能（Jira カードに関連するものを含む）が正常に動作するように、Miro のドメインを許可リストに追加してください。
Jira を Miro と統合しながら、セキュリティレベルを「非公開」に設定した Jira 課題を Miro でブロックすることはできますか？
いいえ、それはできません。Jira のセキュリティレベルは Miro と関連付けられていません。
Jira サーバーを使用している場合、Miro と Jira を接続できますか？
Miro はオンラインツールですので、Jira インスタンスが公共のインターネットに公開されている場合にのみ接続可能です。
同時に複数の Jira インスタンスを接続できますか？
はい。ただし、Jira インスタンスとの接続は最初のリンクを確立することですが、アクティブな接続とは現在使用中のリンクされたインスタンスを指します。アクティブな接続は、Jira カードアプリを開いたときにどこからJiraカードがインポートされ、どのインスタンスにユーザーが認証されているかを定義します。特定のユーザーに対して、一度にアクティブな接続は1つだけです。OAuth 2.0 を使用する場合、ユーザーは既に認証されたリンクされたインスタンスに関連する任意のJiraカードを編集できます。他の認証プロトコルでは、チーム全体がアクティブなインスタンスを共有し、そこからのみカードをインポートし、操作できます。組織レベルの設定を複数定義し、チームレベルでアクティブな接続を切り替えることができます。
サーバーからクラウドへの移行プロセスはどうなりますか？
クラウドへの移行中に Jira ベースの URL が変更されることは避けられないため、Miro 側で変更しなければインテグレーションは中断されます。サポートが必要な場合は、Miro サポートにお問い合わせください。
Miro は、チームごと、プロジェクトごと、または Miro のインスタンスごとに Webhook を作成しますか？
Miro の設定で自動 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 カードを Miro ボード上で閲覧できますが、カードを展開して完全に確認したり変更したりすることはできません。
Atlassian は Jira Server のサポートを終了したのですか？
はい。Atlassian は 2024 年 2 月をもって Jira Server のサポートを終了しました。
Miro プランナー／Jira カードは Jira のカスタムフィールド、カスタム課題タイプやカスタム依存関係をサポートしていますか？
はい。両方サポートされています。カスタム課題タイプとカスタム依存関係のフィールドが Jira に設定されており、かつ Miro プランナーがその Jira インスタンスの認証を受けていれば、これらのカスタムフィールドはプランナーで使用可能です。
Miro は Jira データセンター用の OAuth 2.0 をサポートしていますか？
Jiraの課題をテーブルとタイムラインにインポートするにはどうすればよいですか？
Jiraカードをテーブルまたはタイムラインに直接ドラッグアンドドロップすることで、1つまたは複数の課題をインポートできます。現在、この方法のみが利用可能です。
テーブルのどのフィールドがJiraにリンクしていますか？
システムJiraフィールド：
- タイトル
- 説明
- 終了日（Jiraでは期日）
- 担当者
- ステータス
カスタムJiraフィールド：
- 開始日
- 工数見積もり
セルをクリックして、どのフィールドが Jira に同期されるか確認できます。同時に Jira ロゴが表示されるフィールドが同期対象です。他のすべてのフィールドは Miro にのみ保存され、Jira には同期されません。
なぜ上記の 5 つの Jira フィールドをテーブルやタイムラインで編集できないのですか?
そのフィールドが Jira の編集画面上に存在しない可能性があります。
フィールドが編集画面上にあるかどうかを簡単に確認する方法：
Miro で、Jira カードのサイドパネルを開きます。サイドパネルにフィールドが表示されているか確認してください。フィールドが表示されていない場合は、Jira の編集画面にフィールドを追加する必要があります。
稀にフィールドがJiraで編集可能だが、Jiraの編集画面に表示されないケースがあります。この場合、Miroではこれらのフィールドを編集できません。
編集できないフィールドが開始日または見積もりですか？ その場合は次のことを確認してください：
そのフィールドがJiraに存在しないか、編集画面に欠けている可能性があります（上記のポイントを参照）。
開始日や見積もりは、これらがJiraのカスタムフィールドであるため、マッピングの問題がある可能性があります。
これらのフィールドを以下のロジックに基づいてマッピングしています：
- 開始日：以下の名称のフィールドを確認します：Start Date、StartDate、Target Start
- 見積もり：以下の名称のフィールドを確認します：Story Points、Story point estimate、Story Point、StoryPoints、StoryPoint
- 開始日または見積りフィールドが上記の名称に該当しない場合、編集が機能しない理由の可能性があります。
Miroのテーブルやタイムラインで開始日や見積もりの編集が機能しない、またはJiraで間違ったフィールドが更新されるのはなぜですか？
現在、Jiraでの開始日および見積もりフィールドは、自動マッピングに依存しています。これらはJiraのカスタムフィールドであるため、設定によっては上記の基準に一致する複数のフィールドが存在する場合があります。
上記のフィールド名の順序に従って、最初に一致するフィールドを選択します。
例えば、Jiraのチケットに"Story Points"と"Story point estimate"の両方のフィールドがある場合、上記のリストに従って最初の"Story Points"と一致します。したがって、テーブルで見積もりフィールドを変更しても、Jiraでは"Story Points"フィールドが更新され、"Story point estimate"が更新されるわけではありません。
今のところ、これを回避する方法はありません。この問題が発生した場合は、サポートチームにフィードバックを送り、さらなるフィールドマッピング機能の開発において、皆様のニーズをよりよく理解することができるようにしてください。
なぜ2つの異なるインスタンスからJiraカードをテーブルやタイムラインにインポートできないのですか？
現在、1つのテーブルやタイムラインにつき1つのJiraインスタンスのみをサポートしています。Jiraカードがテーブルやタイムラインにインポートされると、そのテーブルやタイムラインは特定のJiraインスタンスにリンクされます。
たとえすべてのJiraレコードを削除しても、元のJiraインスタンスへのリンクは残ります。別のJiraインスタンスからカードをインポートするには、新しいテーブルやタイムラインを作成する必要があります。
なぜテーブルやタイムラインでJiraレコードのステータスやアサインフィールドを表示または編集できないのですか？
現在、Jiraのステータスおよびアサインフィールドはテーブルとタイムラインでサポートされていません。期待値を管理し、混乱と潜在的なデータ損失を避けるため、これらのフィールドをテーブルとタイムラインで無効化することにしました。Jiraのステータスとアサインフィールドおよびその内容は存在しますが、テーブルやタイムラインには表示されません。
これらのフィールドは、Jiraカードのサイドパネルで直接編集できます。テーブルまたはタイムラインから行をキャンバスにドラッグするだけで、Jiraカードが再表示されます。
詳細情報: