双方向 Webhook を設定

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分

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

    始める前に

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

    このタスクについて

    Jira スポークの双方向 Webhook を設定する手順については、このビデオをご覧ください。

    トークンを作成

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

    始める前に

    必要なロール：admin

    手順

    1. ナビゲーションフィルターで、token_verification.list と入力します。
      トークン検証テーブルにレコードが表示されます。
    2. [新規] をクリックします。
    3. フォームの各フィールドに入力します。
      表 : 1. トークン検証フォーム
      フィールド 説明
      名前 トークンを識別する一意の名前です。例：Jira トークン
      説明 トークンの説明です。
      トークン 認証トークンです。このトークンは暗号化され、URL に埋め込まれます。

    タスクの結果

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

    ServiceNowに JiraWebhook を登録

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

    始める前に

    必要なロール：管理者

    手順

    1. 移動先 すべて > Jira Webhook > Jira Webhook レジストリ.
    2. [新規] をクリックします。
    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. 移動先 すべて > フローデザイナー > デザイナー.
    2. [サブフロー] をクリックします。
    3. デフォルトサブフローの Process Jira Webhooks のコピーを作成します。
    4. 要件に応じてサブフローをカスタマイズし、公開します。サブフローを作成および使用する方法の詳細については「サブフローの構築」を、またデフォルトのルーティングポリシーおよびサブフローがサポートするフィールドについては、「Jira スポーク」を参照してください。
    5. 移動先 Jira Webhook > Jira WebHook ルーティングポリシー.
    6. [新規] をクリックします。
    7. フォームのフィールドに入力します。
      表 : 3. 意思決定フォーム
      フィールド 説明
      ラベル ルーティングポリシーを識別する一意のラベルです。
      デフォルトの回答 この回答がデフォルトの回答かどうかを指定するオプションです。 デフォルトの回答は、条件が満たされない場合に適用されます。
      1. [ルックアップ] アイコン (ルックアップアイコン) をクリックします。
      2. ドキュメントリストから必要なサブフローを選択します。
        注:
        [テーブル名] がフロー [sys_hub_flow] であることを確認します。
      条件 Jira で必要なイベントが発生したときに満たされる条件。「」を参照してください。 Jira Webhook サポートされているフィールドの詳細については、を参照してください。
      回答 指定された条件が満たされるとトリガーされるサブフローです。
    8. [送信] をクリックします。
      注:
      これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。

    タスクの結果

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