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

対象: Jira システム管理者
プラン: すべての Miro プラン (Jira サーバー/データセンター統合用 OAuth 1.0)
プラットフォーム: ブラウザ、デスクトップアプリ (セットアップ手順用)

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

このガイドでは、OAuth 1.0 および OAuth2.0 を使用して、Jira サーバーと Jira データセンター用の 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 チームに対して 1 つの Webhook が作成されます。

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

Webhook を手動で作成したい場合、または作成する必要がある場合は、次の手順に従ってください。

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 側で Webhook を作成できるように Jira システム管理者に送信してください。

Miroから取得したURLを使用してJiraでWebhookを作成する手順は以下のとおりです。また、Jira Server および Jira Cloudの公式Atlassianドキュメントも参照できます（この資料は主にServer/Data Centerに焦点を当てています）。

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

Jira のシステム Webhook 設定
Events セクションの Issue の下で、updated および deleted イベントを選択します。
作成をクリックして Webhook を保存します。

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

これで webhook が作成され、設定されました。Miro のボード上の Jira カードは、Jira で変更があった際に自動的に更新されます。

組織が組織レベルの Jira 設定を使用している場合、webhook の設定はチームレベルの接続とは異なります：

- 組織全体の単一Webhook: 組織レベルでJiraを接続すると、組織全体で1つのWebhookが登録されます。これにより、チームごとに個別のWebhookを設定する必要がなくなります。

- Webhook数の削減: 以前はチームごとに1つのWebhookを持っていた組織（場合によっては数十個）が、組織レベルの設定に切り替えることで、これらが単一のWebhookに統合され、Jiraインスタンスへの負荷が軽減されます。

- チーム用のオーバーライドは組織のWebhookを使用: チームがグローバルな組織接続を利用する際、組織レベルで作成された同じWebhookを共有します。

注意: チームレベルのWebhookにJQLフィルター（例として特定のプロジェクト用）が設定されていた場合、組織レベルのWebhookもすべてのJQLフィルターを反映するか、まったくフィルターを適用しない必要があります。組織レベルの設定に移行する前に、JQLの要件を確認してください。

組織管理者設定で接続が設定された後、接続済みインスタンスの下にWebhook URLが表示されます。手動Webhookをコピーし、Jira環境へ貼り付けてください。