Jira カードの設定と無効化（OAuth 1.0） – Miro Help Center

利用可能な対象：Jira Cloud、Jira Server（オンプレミス）、Datacenter（LDAP 保護も）
設定者：プロジェクトの管理者権限がある Miro のチームの管理者と Jira システムの管理者

⚠️ 技術的な問題が発生した場合、起こり得る問題と解決方法についての記事をご覧ください。

️💡 Jira カードについての詳細は、Jira カードの FAQ と Jira カードの WebHook の設定方法に関する記事をご覧ください。

Jira で Miro の設定

✏️️ ️Jira のメニューは、使用している Jira バージョンによって異なる場合がありますが、一般的なフローは同じです。以下の手順は、Atlassian サポートでも確認できます。

ステップ 1 - アプリケーションリンク

まず、アプリケーションリンクを作成し、設定します。

Jira の設定 > 製品 > インテグレーション > [アプリケーションリンク] > [リンクを作成

] に移動します。Jira のバージョンによって、Jira インターフェイスが異なる可能性があることにご注意ください
[直接アプリケーションリンク] を選択し、アプリケーション URL フィールドに https://miro.com/ と入力します。
重要：URL はこの正確な形式で入力する必要があります。[続行] をクリックします。

リンクの作成
次のメニューで、[続行] をもう一度クリックするだけです。
[レビューリンク] メニューで、URL が正確に https://miro.com/ であることを再度確認し、選択したアプリケーション名を入力します。スクロールダウンして、一番下の [受信リンクの作成] ボックスをオンにします。残りのフィールドをスキップし、[続行] をクリックします。
ここに、Miro の値のフィールドが表示されます。値を取得するには、Miro にログインし、チームの設定 > [アプリとインテグレーション] > [Jira カード] に移動します。
アプリリストに Jira カードがない場合は、セクションの上部にスクロールし、[アプリをインストール] をクリックし、Miro マーケットプレイスからアプリをインストールしてください。リストに Jira カードが表示されたら、クリックして開きます。
プラグインタブが開き、ステップ 1 が表示され、必要な値を取得することができます。
Jira カードの値をコピー

値をコピーし、Atlassian Review Link メニューに追加します。
1 ～ 2 秒間処理メッセージが表示されます。

リンク作成の最終ステップ

これにより、Atlassian 側の手順は完了します。このリンクは、アプリケーションリンクのリストに表示されます。

ステップ 2 - 接続

Miro の Jira カードの設定に戻り、2 つのオプションのうちの 1 つを選択します。手動または自動で作成します。手動で選択する場合は、オプションのチェックを外してください。詳細については、こちらの記事をご覧ください。プラグインが大幅に更新された際にリセットする必要がないよう、自動 Webhook を使用することを強くお勧めします。

最後に、Jira の URL を入力し、[接続] をクリックします：

Jira カードの接続

Jira の URL を取得するには、Jira インスタンスのベース URL をコピーしてください。Miro では以下の形式を利用できます：

https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/

Jira の URL が受け入れられない場合は、こちらの記事をご覧ください。また、接続を確立するために Miro が Jira に対して十分なアクセス権があることも確認してください。

これで Miro のチームに Jira インスタンスが接続されました。

⚠️ Jira Server は、2024 年 2 月に廃止されます。ただし、以下の手順は Jira Data Center でも同様に機能します。

https://your-jira-server/plugins/servlet/applinks/listApplicationLinks に移動します。「アプリケーションリンク」が選択されていない場合は、クリックします。Jira Server アプリケーションリンク
[リンクを作成する] をクリックします。「Atlassian product」を選択し、アプリケーション URL「https://miro.com」を入力します。[続行] をクリックします。アプリケーション URL の設定
「アプリケーションをリンクする」ダイアログボックスに移動します。アプリケーション名（Miro Jira カードなど）を追加し、アプリケーションタイプに「汎用アプリケーション」を選択します。
「リンクを作成している」の下に Jira アプリケーション URL が表示され、[このアプリケーションへ] の下に https://miro.com が表示されます。[続行] をクリックします。リンクアプリケーションの詳細の設定
リンクの設定は処理されます。完了すると、Jira Server の「アプリケーションリンク」エリアに新しいリンクが表示されます。Jira Server で設定したアプリケーション
次に、アプリケーションの詳細を設定する必要があります。アプリケーションの詳細を編集するには、アプリケーションの鉛筆アイコンをクリックします。
[構成] ダイアログボックスで、[受信認証] オプションをクリックします。消費者キー、消費者名、公開キー、オプションで説明を入力します。この情報は、[アプリとインテグレーション] のチームの設定の Miro にあります。Jira Server で受信認証の詳細を設定する
Miro の Jira アプリケーションリンクの詳細
[受信認証] オプションの最後までスクロールし、[保存] をクリックします。検証ステータスが確認され、この Jira Server は、Jira カードで使用するために Miro で使用できるようになりました。Miro 側で「Jira Server」と「OAuth 1.0」を選択することを忘れないでください。

ユーザー認証

インテグレーションが接続されたら、各エンドユーザーは個人の Jira プロフィールを接続して適切なアクセス権を確立する必要があります。これにより、Miro 側の各ユーザーのアクセスが、Jira インスタンス側と全く同じになります。エンドユーザーが Jira カードを初めてインポートまたは編集しようとする場合、個人のユーザー資格情報を使用して Jira へログインするよう求められます。

これでホワイトボードにタスクをカードとして追加することができます。Jira で行われた変更はすべて、ボード上の Jira カードに反映されます。

✏️ ユーザーが Jira 資格情報を持っておらず、カードが追加されたボードへのアクセス権を持っている場合、カードのタイトル、課題の種類、優先度、担当者、Jira カードに表示されるように設定されているすべての属性が表示されます。ただし、許可しない限り、カードを展開して、他の属性を表示したり、カードを編集したりすることはできません。ユーザーが Jira 資格情報を接続しない場合、担当者のアバターが表示されず、カードの全体像も異なるものとなります。

複数の Miro のチームに Jira の 1 つのインスタンスを使用（オプション）

カードはチームレベルでインストールされるため、Enterprise プランを使用し、複数のチームがある場合、接続したいチームごとにステップ 2 を繰り返す必要があります。既存のアプリケーションリンクは、そのすべてのチームに使用されます。
チームを Jira インスタンスに接続すると、Jira WebHook では、接続した特定の Miro チームに対して、新しい Webhook が作成されます。Webhook を作成すると、更新リクエストのチャネルを確立できます。

⚠️ 複数のチームを接続する場合は、Jira Webhook ページに移動し、新しく作成された各 WebHook を編集して固有の名前を付けることをお勧めします。そうしないと、混乱する可能性があります。

複数の Jira インスタンスを 1 つの Miro のチームに接続することはできません。

プラグインのアンインストール

[チーム] の設定 > [アプリとインテグレーション] > [Jira カード] に移動し、ステップ 2 の Jira の URL を無効にします。その後、[チーム用にアンインストール] をクリックします。

Jira カードのアンインストール

💡 Jira カードの使用方法に関する主要記事もぜひご覧ください。

このセクションの記事