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

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

始める前に

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

トークンを作成

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

始める前に

必要なロール：admin

手順

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

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

   フィールド	説明
   名前	トークンを識別する一意の名前です。例：Jira トークン
   説明	トークンの説明です。
   トークン	認証トークンです。このトークンは 受信 Webhook 要求を認証するために使用されます。

タスクの結果

トークン 作成 は、受信 Webhook 要求を認証するために 使用されます。

ServiceNowに JiraWebhook を登録

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

始める前に

必要なロール：admin

手順

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

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

   フィールド	説明
   名前	レコードを一意に識別する名前です。例：Jira webhook
   説明	レコードの説明です。
   トークン	認証トークンです。このトークンは、受信 Webhook 要求を認証するために 使用されます。
   パス	JiraWebhook パスです。デフォルトでは、このパスは api/sn_jira_spoke/jira_webhook_callbacks/wh_entry に設定されています。

4. フォームヘッダーを右クリックし、[保存] をクリックします。
5. コールバック要求を認証する方法を選択し、いずれかのオプションを選択します。

   コールバック URL タイプ	説明
   トークンベースのコールバック URL	簡易認証のために URL で静的トークンを使用します。
   HMAC ベースのコールバック URL	セキュリティと改ざん防止認証を強化するために、ハッシュベースのメッセージ認証コード (HMAC) を使用します。

   選択内容に基づいて、トークンベースのコールバック URL または HMAC ベースのコールバック 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 ドキュメントを参照してください。

   注:

   Webhook の登録時に HMAC ベースのコールバック URL を選択した場合は、ServiceNow インスタンスから作成されたシークレットトークンを Webhook の [シークレット] フィールドに入力します。

   
4. Webhook をトリガーする関連イベントを選択します。

タスクの結果

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

双方向 Webhook をカスタマイズ

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

始める前に

必要なロール：admin

このタスクについて

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

手順

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

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

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

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

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

タスクの結果

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