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

利用可能なプラン：Jira Cloud、Jira Server（オンプレミス）、Datacenter（LDAP 保護もあり）
設定者：プロジェクトの管理権限を持つ Miro チーム管理者および Jira システム管理者

✏️ 次の OAuth1.0 認証方法は、2025 年 7 月 1 日以降、Miro でサポートされなくなります。OAuth1.0 は Jira で非推奨の認証プロトコルであり、使用しないでください。この変更は、セキュリティーのベストプラクティスに沿った推奨事項として、より広範なOAuth2.0への移行の一部です。ユーザーには、Miro のサービスとのサポートと互換性を継続するために、OAuth2.0 への移行をお勧めします。

Jira における Miro の設定

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

💡Jira カードについての詳細は、Jira カードに関するよくある質問と Jira カードの Webhook の設定方法の記事をご覧ください。

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

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

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

Jira の設定 > プロダクト > インテグレーション > アプリケーションリンク > リンクの作成

Jira インターフェイスは、Jira のバージョンによって異なる場合があります
ダイレクトアプリケーションリンク を選択し、https://miro.com/ を アプリケーション URL フィールドに入力します。
重要：URL をこの正確なフォーマットに入力する必要があります。続行をクリックします。

リンクを作成中
次のメニューで、続行をもう一度クリックするだけです。
レビューリンク メニューで、URL が依然として正確に https://miro.com/ であることを確認し、ご自身で選んだアプリケーション名を入力します。スクロールダウンして、一番下の[受信リンクの作成]ボックスをオンにします。残りのフィールドをスキップ<して続行をクリックします。
アプリケーション名フィールドの入力のみ必須です
ここに、Miro の値のフィールドが表示されます。値を取得するには、Miro にログインしてください。
- チームレベルでのインテグレーションには、チームの設定 > [アプリとインテグレーション] > [Jira カード] に移動します。
- 組織レベルの統合には、会社の設定 > アプリ > アプリを管理 > Jiraカード > 設定に進んでください。
  
  まだアプリリストに Jira カードがない場合は、セクションの上部までスクロールし、アプリをインストールをクリックして、Miro マーケットプレイスからアプリのインストールに進んでください。リストに Jira カードが表示されたら、クリックして開きます。
  
  プラグインタブが開き、ステップ 1 が表示されて、必要な値を取得することができます。
  Jira カードの値
  
  値をコピーして、Atlassian レビューリンク メニューに追加します。
1 ～ 2 秒間、処理メッセージが表示されます。

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

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

ステップ 2 - 接続

Miro の Jira カード設定に戻り、Webhook を手動で作成するか、自動で作成するか、2 つのオプションのどちらかを選択します。手動で選択する場合、オプションのチェックを外してください。詳細については、こちらの記事をご覧ください。プラグインが大幅に更新された際にリセットする必要がないよう、自動 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 に対して十分なアクセス権があることも確認してください。

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

⚠️ Atlassian は 2024 年 2 月をもって Jira Server のサポートを終了しますが、Miro は今後も繰り返し言及しサポートしていく予定です。

https://your-jira-server/plugins/servlet/applinks/listApplicationLinks にアクセスしてください。「アプリケーションリンク」が選択されていない場合は、クリックしてください。Jira サーバーアプリケーションリンク
リンクを作成する をクリックします。「Atlassian 製品」を選択し、 アプリケーション URL として "https://miro.com" を提供します。続行をクリックしてください。 アプリケーション URL の構成
「アプリケーションのリンク」ダイアログボックスに移動します。アプリケーション名（例：Miro Jira Card）を追加し、アプリケーションタイプに「汎用アプリケーション」を選択します。
「以下からリンクを作成しています:」の下に Jira アプリケーションの URL が表示され、「このアプリケーションへ:」の下に https://miro.com が表示されているはずです。続行をクリックします。リンクアプリケーションの詳細を設定
リンク設定が処理されます。完了すると、Jira Server の「アプリケーションリンク」エリアに新しいリンクが表示されます。Jira Server で設定されたアプリケーション
次に、アプリケーションの詳細を設定する必要があります。アプリケーションの詳細を編集するには、アプリケーションの鉛筆アイコンをクリックしてください。
構成ダイアログボックスで、受信認証オプションをクリックします。Consumer Key（コンシューマーキー）、Consumer Name（コンシューマー名）、公開鍵を入力し、必要に応じて説明を追加します。
- チームレベルでのインテグレーションの詳細は、チームの設定 > アプリとインテグレーション > Jira カード で確認できます。
- 組織レベルの統合については、Company settings > アプリ > アプリを管理 > Jiraカード > 設定から情報を入手できます。
  Jira Server で受信認証情報を設定する
  Miro の Jira アプリケーションリンクの詳細
受信認証オプションの最後までスクロールし、保存をクリックします。確認ステータスが確認され、Jira サーバーを Miro 内で Jira カードと共に使用することができるようになりました。Miro 側で「Jira Server」と「OAuth 1.0」を必ず選択してください。

ユーザー認証

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

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

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

複数の Miro チームに 1 つの Jira インスタンスを使用

カードはチームレベルまたは組織レベルでインストールできます。複数のチームがある場合は、組織レベルの設定を活用して、各チームの設定手順を繰り返すことを避けることができます。既存のアプリケーションリンクはすべてのチームに使用されます。

チームまたは組織を Jira インスタンスに接続すると、その Miro チームまたは組織用の新しい WebHook が Jira WebHook に作成されます。Webhook を作成すると、更新リクエストのチャネルが確立されます。

組織レベルの設定を指定すると、すでに接続されているチームは現在の設定を保持します。ただし、いつでも組織レベルの設定に切り替えることができます。

さらに必要に応じて、チームは組織レベルの設定をオーバーライドして、異なる Jira インスタンスに接続することができます。

複数のチームレベルの接続をデフォルトの組織レベルの接続に移行したい Enterprise のお客様は、アカウントチームにお問い合わせください。

⚠️ 複数のチームを個別に接続したい場合は、各チームの Webhook に固有の名前を付けることをお勧めします。Jira WebHooks ページに移動し、新しく作成された各 WebHook を編集してください。

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

プラグインの無効化

チームレベルのインテグレーションについては、チーム設定 > アプリとインテグレーション > Jira カード に移動してください。次に チームから削除 を選択します。

組織レベルでの統合について、Jira アプリの使用を制限するには、会社の設定 > アプリ > アプリの管理 > Jira カード に移動します。トグルをオフの位置に移動します。

⚠️ 組織の Jira を無効にすると、すべての Enterprise チームのユーザーは Jira カードを使用できなくなります。アプリ管理と制限について詳しくは、アプリ管理を参照してください。

詳細情報：Jira カードの使い方をご覧ください。

このセクションの記事