この記事では、Jira カードのインテグレーションがどのように構築されているかに関する最もよくある質問に対する回答を掲載しています。
Jira カードの詳細については、以下の記事もご覧ください。
| 質問 | 回答 |
|---|---|
セキュリティ |
|
| Jira-Miro の認証はどのように行われますか？ | 使用されるプロトコルは、OAuth 1.0 です。 現在、Atlassian はこのプロトコルのみをサポートしています。OAuth 2.0 認証コードの付与（3LO）は、現在、開発者のプレビュー中です。 |
| Jira と Miro 間で転送されるデータは保護されていますか？ | Miro では、TLS セキュリティ プロトコルを使用しています。送信前に HTTP メッセージを暗号化し、受信時にメッセージを解読します。Enterprise プランでは、相互 TLS もサポートしています。 |
| 相互 TLS をサポートしていますか？ | はい、詳細はこちらをご覧ください。 |
| Miro は、顧客の Jira データを保持しますか？その場合、保管期間はどのくらいで、データの保護はどのように行われますか？ | はい、Miro は、ボードに追加されたカードのデータを保持します。 また、Jira Cards プラグインの設定プロセス中に Webhook が設定されている場合、データは更新されます。保管期間に制限はありません。一般的な Miro のセキュリティ プロトコルのみが適用されます。 |
| Miro から取得できる情報を制限する方法はありますか？例えば、「タイトル」と「ステータス」だけを表示したい場合を想定して、Miro のユーザーに対して、「説明」や「添付ファイル」などの他のフィールドにアクセスできないようにすることは可能でしょうか？ | Atlassian のドキュメンテーションには、情報をいくつかのフィールドに制限する方法についての記載はありませんでした。 |
| 認証時、通常使用時など、Jira と Miro 間のデータの流れを図で示すことはできますか？ | 詳細については、こちらの Jira 開発者の記事をご覧ください。Atlassian ドキュメンテーションに従って Miro のインテグレーションを実装しています。 |
| トークンの取り扱いはどのように行っていますか？ | トークンは、無効にならない限り 5 年間続きます。 このポリシーは Atlassian 側で定義されているため、トークンの有効期限を変更することはできません。Web UI を使用して、Jira 側でトークンを取り消すことはできます。 新しいトークンが追加されると、インテグレーションの動作が停止し、Miro 側で再接続する必要があります（インテグレーション設定時に [接続] ボタンをクリックしてください）。 |
| 顧客全員の Jira アクセスに 1 つのアクセストークンを使用していますか、それとも個々のユーザーに別々のトークンを使用していますか？ | Jira カードのインポート、作成、編集を行う予定のすべての Miro ユーザーは、個々の Jira 資格情報を接続する必要があります。上記のすべての操作は、個々の Jira 資格情報に代わってのみ行うことができます。 |
| リクエストトークン、アクセストークン、秘密鍵、その他の OAuth 秘密 / 資格情報はどのように保護されていますか？ | インテグレーション時には、アクセストークンのみが使用されます。これらは、データベース内で安全に保管され、サーバー側でのみ使用されます。 認証トークンは、Webhook にのみ使用されます。これは、OAuth によって使用される実際の認証トークンではありません。リクエストは、暗号化された接続を介して送信されます。秘密鍵は自動生成され、チームごとに関連付けられます。 |
| インテグレーションでは、どのようなエンドポイントを使用していますか？ | 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 サーバーや、ローカルでのみ利用可能な Jira インスタンスを使用している場合、Miro を Jira に接続できますか？ |
Miro はオンラインツールなので、Jira が公共のインターネットに公開されている場合にのみ、インテグレーションを設定できます。ここでの対応策はありません。 |
| 複数の Jira インスタンスを Miro のチームに接続できますか？ | いいえ、1 つのチームに 1 つの Jira インスタンスです。 |
| Miro は、チームごと、プロジェクトごと、または Miro のインスタンスごとに Webhook を作成しますか？ | はい、自動 Webhook を使用する場合はそうなります。Jira によるチーム認証時に Webhook が作成されるので、チームごとに Webhook が作成されます。 |
| Jira カードプラグインは、Next-Gen プロジェクトをサポートしていますか？ | はい、しています。 現在、Miro 側で Next-Gen プロジェクト用の Jira カードを作成する場合、エピックのリンク / フィールドがないことにご注意ください。 |
| カスタム Jira フィールドはサポートされていますか？ | はい、基本的なタイプのカスタムフィールドはほとんどすべてサポートしています。複雑なデータタイプのフィールドがある場合、ボード上で Jira カードを更新または作成する際にはサポートされず、予期しない動作を引き起こす可能性があります。 |
| 別の Jira インスタンスに切り替えた場合、既存の Jira カードはどうなりますか？ | カードは Miro のボードに残りますが（データの損失はありません）、更新は停止します。 |
| 1 つのプロジェクトから 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、Consultant、Education、Enterprise プラン）。 |
ユーザーが Miro のボードに移動し、Jira にログインした場合、ボード上のすべての Jira カードの詳細情報にアクセスできますか、それとも Jira 資格情報に従ってアクセスが許可されている情報にだけアクセスできるのでしょうか？
|
Jira カード インテグレーションに対するアクセス権限は、ユーザーがアクセス可能な Jira プロジェクト内でのみカードを作成し編集できることを保証します。 |