Jira Data Center の Webhook の設定方法 – Miro Help Center

対象: Jira システム管理者
プラン: すべての Miro プラン（Jira Server/Data Center 統合には OAuth 1.0 が必要）
プラットフォーム: ブラウザ、デスクトップアプリ（セットアップ手順用）

Miro ボード上のJira カードが常に最新の状態を保つために、Jira からデータが変更されるたびに Miro にメッセージが送信される必要があります。これらの Jira イベントは、Webhook を介して Miro に送信されます。

このガイドは、OAuth 1.0 と OAuth2.0 を使用して Jira Server と Jira Data Center 用の Webhook を作成する 2 つの方法を提供します。

Webhook を自動的に作成する

Jira カードのインテグレーションを設定する場合、Jira Server または Jira Data Center に接続する際は、Webhook を自動的に作成するオプションを有効のままにできます。これは推奨メソッドです。

✏️ Webhook の自動作成には、Jira のシステム管理者としてログインしている必要があります。

Jira カードの設定、ステップ 2：「Webhook を自動的に作成する」が有効になっています

Webhook が自動で作成された後、この Webhook に一意な名前を付けるために Jira WebHooks ページにアクセスして編集することをお勧めします。特にいくつかの Miro チームを Jira インスタンスに接続する予定がある場合には重要です。

✏️ OAuth2.0 接続では、Miro 側の接続は会社レベルで設定されます。すべての Miro チームに対して一つの Webhook が作成されます。

✏️ Miro チームレベルでの OAuth 1.0 接続では、チームごとに Webhook が作成されます。Miro 会社レベルでは、すべてのチームに対して一つの Webhook が作成されます。

Webhook を手動で作成することを希望する場合、または必要がある場合は、以下の手順に従ってください。

Miro から Webhook URL を取得します

Miro の Jira カード設定 (Jira Server/Data Center 接続時のステップ 2) で、Webhook を自動的に作成する オプションのチェックを外します。
組織のJira URLをコピー & ペーストし、接続して設定を保存をクリックします。

Jira カード設定、ステップ 2：「Webhook を自動的に作成する」が無効になっている
Jira で接続を許可してください。
これらのステップの後、Miro が Webhook URL を提供します。
Miro によって提供された Webhook URL

✏️ もしあなたが Jira システム管理者でない場合、Miro によって提供された Webhook URL をコピーして、Jira システム管理者に送り、以下の手順で Jira 側に Webhook を作成してもらってください。

Jira での Webhook 作成

以下は、Miroから取得したURLを使用してJiraにWebhookを作成する手順です。Jira ServerおよびJira Cloudの公式 Atlassian ドキュメントも参照できますが、この文書はサーバーやデータセンターに重点を置いています。

JiraでWebHooksページに移動するには、Jira管理 > システム > 詳細 > WebHooksと進みます（Jiraのバージョンによって正確なパスは若干異なることがあります）。また、/plugins/servlet/webhooksをJiraインスタンスのURLに追加して直接リンクを使用できることが多いです（例：https://YourJiraInstanceName/plugins/servlet/webhooks）。
WebHookの作成をWebHooksページの右上隅でクリックします。
Webhookの説明的な名前を入力します（例：「MiroインテグレーションWebhook」）。
Webhookのステータスを有効に設定します。
Miro の設定からコピーしたWebHook URLを URL フィールドに貼り付けます。

Jiraのシステム Webhook 設定
イベントセクションの課題の下で、更新済みと削除済みのイベントを選択します。
作成をクリックして、Webhook を保存します。

Jira WebHook イベント設定
Jira で Webhook を作成した後、Miro の Jira カード設定のステップ 2に戻り、Jira URLが正しく入力されていることを確認し、接続をクリックします。

これで、Webhook が作成および設定されました。Miro のボード上の Jira カードは、Jira で変更が行われると自動的に更新されます。