利用可能なプラン:Jira Cloud、Jira Server(オンプレミス)、Datacenter(LDAP 保護も適用)
設定者:プロジェクト管理権限を持つ Miro チーム管理者および Jira システム管理者
✏️ 次の OAuth1.0 認証方法は、2025 年 7 月 31 日より Miro でサポートされなくなります。OAuth1.0 はJira の非推奨の認証プロトコルであり、使用しないでください。この変更は、セキュリティーのベストプラクティスに沿って推奨される OAuth2.0 への広範な移行の一環です。ユーザーには、Miro のサービスのサポートと互換性を確保するために、OAuth2.0 への移行を推奨します。
Jira での Miro の設定
⚠️ 技術的な問題が発生した場合、起こり得る問題と解決方法についての記事をご覧ください。
💡Jira カードについては、Jira カードの FAQ と Jira カードの WebHook の設定方法の記事をご覧ください。
✏️ Jira のメニューは、使用している Jira バージョンによって異なる場合がありますが、一般的なフローは同じであるべきです。 以下の手順は、Atlassian サポートでも確認できます。
ステップ 1 - アプリケーションリンク
まず、アプリケーションのリンクを作成し、設定します。
- Go to Jira の設定 > プロダクト > インテグレーション > アプリケーションのリンク > リンクの作成
Jira インターフェイスは、Jira のバージョンによって異なる場合があります。
-
ダイレクト アプリケーション リンク を選択し、アプリケーション URL フィールドに https://miro.com/ と入力します。
重要: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 に対して十分なアクセス権を持っていることを確認して、接続を確立できるようにしてください。
これで Miro チームに Jira インスタンスを接続しました。
⚠️ Atlassian は 2024 年 2 月に Jira Server のサポートを終了しましたが、Miro は今後も Jira Server 用の Jira カード インテグレーションをサポートし続けます。
-
https://your-jira-server/plugins/servlet/applinks/listApplicationLinksに移動します。「アプリケーション リンク」が選択されていない場合、それをクリックします。
Jira Server アプリケーションリンク
-
リンクを作成をクリックします。「Atlassian 製品」を選択し、アプリケーション URL「https://miro.com」を入力します。続けるをクリックしてください。
アプリケーション URL の設定
- 「リンクアプリケーション」ダイアログボックスに移動します。アプリケーション名(例:Miro Jira カード)を追加し、アプリケーションタイプには「汎用アプリケーション」を選択します。
"ここからリンクを作成しています:" の下に Jira アプリケーション URL が表示され、「このアプリケーションへのリンク先:」の下には https://miro.com が表示されます。続行 をクリックします。アプリケーションのリンク設定
- リンクの設定を処理します。完了すると、「アプリケーション リンク」エリアに新しいリンクが Jira サーバーに表示されます。
Jira Server で設定されたアプリケーション
- 次に、アプリケーションの詳細を設定する必要があります。アプリケーションの詳細を編集するには、アプリケーションの鉛筆アイコンをクリックしてください。
- 構成ダイアログボックスで、受信認証オプションをクリックします。Consumer Key、Consumer Name、公開鍵を入力し、必要に応じて説明を追加します。
- 受信認証オプションの最後までスクロールして、保存をクリックします。あなたの認証ステータスは現在確認されているはずで、この Jira サーバーは Miro 内で Jira カードと共に使用できるようになりました。Miro 側で「Jira Server」と「OAuth 1.0」を選択してください。
ユーザー認証
インテグレーションが接続されたら、各エンドユーザーは個人の Jira プロフィールを接続して適切なアクセス権を確立する必要があります。これにより、Miro 側の各ユーザーのアクセスが、 Jira インスタンス側と全く同じになります。エンドユーザーが Jira カードを初めてインポートまたは編集しようとする場合、個人のユーザー資格情報を使用して Jira へログインするよう求められます。
これでホワイトボードにタスクをカードとして追加することができます。Jira で行われた変更はすべて、ボード上の Jira カードに反映されます。
✏️ ユーザーが Jira 資格情報を持っておらず、カードが追加されたボードへのアクセス権を持っている場合、カードのタイトル、課題の種類、優先度、担当者、Jira カードに表示されるように設定されているすべての属性が表示されます。ただし、許可しない限り、カードを展開して、他の属性を表示したり、カードを編集したりすることはできません。ユーザーが Jira 認証情報を接続しない場合、担当者のアバターは表示されず、カードの一般的な外観も異なるものとなります。
複数の Miro チームに Jira の 1 つのインスタンスを使用
カードはチームレベルまたは組織レベルにインストールできます。複数のチームがある場合、組織レベルの設定を活用して、各チームごとに設定手順を繰り返すことを避けることができます。既存のアプリケーション リンクはすべてのチームで使用されます。
チームまたは組織を Jira インスタンスに接続すると、その Miro チームまたは組織に対して Jira WebHook に新しい Webhook が作成されます。Webhook を作成すると、更新リクエストのチャネルを確立します。
組織レベルの設定を指定すると、すでに接続されているチームは現在の設定を保持します。ただし、いつでも組織レベルの設定に切り替えることができます。
さらに、必要であれば、チームは組織単位の設定を上書きして、別の Jira インスタンスに接続することができます。
複数のチームレベルの接続をデフォルトの組織レベルの接続に移行したいという Enterprise のお客様は、アカウントチームにお問い合わせください。
⚠️ 複数のチームを個別に接続する場合は、各チームの Webhook に固有の名前を付けることをお勧めします。Jira Webhook ページに移動して、新しく作成された各 Webhook を編集します。
複数の Jira インスタンスを 1 つの Miro チームに接続することはサポートされていません。
プラグインの無効化
チームレベルのインテグレーションを行うには、チームの設定 > アプリとインテグレーション > Jira カード に移動します。次にチームから削除を選択します。
組織レベルのインテグレーションで Jira アプリの使用を制限するには、会社の設定 > アプリ > アプリの管理 > Jira カード に移動します。その後、トグルをオフの位置に移動します。
⚠️ 組織内で Jira を無効化すると、すべての Enterprise チームのユーザーが Jira カードを使用できなくなります。アプリ管理と制限について詳しく知りたい場合は、アプリ管理をご覧ください。
詳細情報:Jiraカードの使い方を参照してください。