Jira スポーク用双方向 Webhook の設定

ServiceNow コールバック URL で Jira を登録するための Webhook を設定します。

始める前に

• 統合ハブ サブスクリプションの要求
• Jira スポークの有効化
• 必要なロール：admin

トークンを作成

JiraWebhook URL に埋め込むトークンを作成します。

始める前に

必要なロール：admin

手順

1. ナビゲーションフィルターで、token_verification.list と入力します。
   トークン検証テーブルにレコードが表示されます。
2. [新規] をクリックします。
3. フォームの各フィールドに入力します。

   表 : 1. トークン検証フォーム

   フィールド	説明
   名前	トークンを識別する一意の名前です。例：Jira トークン
   説明	トークンの説明です。
   トークン	認証トークンです。このトークンは暗号化され、URL に埋め込まれます。

タスクの結果

JiraWebhook URL に埋め込むトークンが作成されます。

ServiceNowに JiraWebhook を登録

ServiceNowにJiraWebhook を登録して、Jiraでイベントが発生したときにServiceNowアプリに通知します。

始める前に

必要なロール：admin

手順

1. 次のように移動する。 All (すべて) > Jira Webhook > Jira Webhook レジストリ.
2. [New] をクリックします。
3. フォームのフィールドに入力します。

   表 : 2. Jira Webhook レジストリフォーム

   フィールド	説明
   名前	レコードを一意に識別する名前です。例：Jira webhook
   説明	レコードの説明です。
   トークン	認証トークンです。このトークンは暗号化され、URL に埋め込まれます。例：Jira トークン
   パス	JiraWebhook パスです。デフォルトでは、このパスは api/sn_jira_spoke/jira_webhook_callbacks/wh_entry に設定されています。

4. フォームヘッダーを右クリックし、 [保存] をクリックします。
5. [コールバック URL] をクリックします。
   Webhook コールバック URL が表示されます。
6. Webhook コールバック URL をコピーして記録します。

タスクの結果

JiraWebhook がServiceNowインスタンスに登録されます。

Jira でのコールバック URL の追加

JiraAtlassian アカウントで Webhook コールバック URL を指定して、Webhook を作成します。

始める前に

必要なロール：admin

手順

1. JiraAtlassian アカウントにログインします。
2. Atlassian アカウント に Webhook を作成します。
3. [URL] フィールドに Webhook コールバック URL を入力します。
   Webhook を作成する手順については、Atlassian Developer Portal ドキュメントを参照してください。

タスクの結果

コールバック URL は Jira Atlassian アカウントに追加されます。要件に応じてルーティングポリシーとサブフローを作成できます。新しいルーティングポリシーとサブフローの作成の詳細については、「双方向 Webhook をカスタマイズ」を参照してください。

双方向 Webhook をカスタマイズ

要件に応じて、Webhook ルーティングポリシーとサブフローを作成します。

始める前に

必要なロール：admin

このタスクについて

Jira WebHook ルーティングポリシーモジュールのデフォルトのルーティングポリシーは、[Jira Webhook の処理] サブフローをトリガーし、Jira で特定のイベントが発生すると ServiceNow アプリに通知します。 デフォルトのルーティングポリシーとサブフローがサポートするフィールドについては、「Jira スポーク」を参照してください。カスタムサブフローで他のフィールドを使用し、ルーティングポリシーの条件をカスタマイズするには、次の手順を実行します。

手順

1. 次のように移動する。 All (すべて) > Flow Designer (フローデザイナー) > デザイナー.
2. [サブフロー] をクリックします。
3. デフォルトサブフローの Process Jira Webhooks のコピーを作成します。
4. 要件に応じてサブフローをカスタマイズし、公開します。サブフローを作成および使用する方法の詳細については「サブフローのビルド」を、またデフォルトのルーティングポリシーおよびサブフローがサポートするフィールドについては、「Jira スポーク」を参照してください。
5. 次のように移動する。 Jira Webhook > Jira WebHook ルーティングポリシー.
6. [New] をクリックします。
7. フォームのフィールドに入力します。

   表 : 3. 意思決定フォーム

   フィールド	説明
   ラベル	ルーティングポリシーを識別する一意のラベルです。
   デフォルトの回答	この回答がデフォルトの回答かどうかを指定するオプションです。 デフォルトの回答は、条件が満たされない場合に適用されます。 [ルックアップ] アイコン () をクリックします。 ドキュメントリストから必要なサブフローを選択します。 注: [テーブル名] がフロー [sys_hub_flow] であることを確認します。
   条件	Jiraで必須イベントが発生したときに満たされるべき条件です。「」を参照してください。 Jira Webhook サポートされているフィールドの詳細については、を参照してください。
   回答	指定された条件が満たされるとトリガーされるサブフローです。

8. [送信] をクリックします。
   注:

   これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。

タスクの結果

ルーティングポリシーとサブフローが作成されます。