Jira ユーザーストーリー統合の構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • Jira 統合オプションを構成するには、次の手順を実行します。

    始める前に

    必要なロール:スキャンエンジンアドミン (sn_se.scan_engine_admin)

    • 統合を有効にするには、 スキャンエンジン と統合する Jira プロジェクトの詳細が必要です。Jira ボードのプロジェクト設定から、次の情報を見つけてメモします。
      • プロジェクトキー
      • 作業アイテムタイプ
      • ドメイン名
        注:
        ドメイン名は Jira URL から取得できます。たとえば、URL が companyname.atlassian.net/jira の場合、ドメイン名は companyname です。
    • Jira プロジェクトに接続するには、API トークンも必要です。
      1. https://id.atlassian.com/manage-profile/security/api-tokens URL に移動します。
      2. [ API トークンの作成] を選択し、トークンの名前を入力して、[ 作成] を選択します。
      3. トークンが作成されたら、それをコピーして保存します。

        ServiceNow 接続プロセスで必要になります。

    手順

    1. sys_auth_profile_basic.list に移動し、[新規] を選択してベーシック認証レコードを作成します。
    2. 定義する 名前 は、簡単に識別できる名前で始まることを確認してください。
    3. ユーザー名が現在ログインしているユーザーのメールアドレスと一致することを確認してください。
      注:
      シームレスな統合と認証のために、現在ログインしているユーザーのメールを常に Jira ユーザー名と同期します。また、Jira で作業アイテムを作成できるユーザーごとに基本認証レコードを作成する必要があります。
    4. 以前に取得したトークンを [パスワード] フィールドに貼り付けます。
    5. 移動先 すべて > 影響 > 設定 (Configuration) > スキャンエンジンのプロパティをクリックし、[ ユーザーストーリー統合 プロパティ] タブを選択します
    6. 統合タイプとして [Jira] を選択します。
    7. Jira プロジェクトから取得した情報を次のフィールドに入力します。
      • プロジェクトキー
      • ドメイン名
      • 作業アイテムタイプ
    8. [ 更新 ] を選択して接続を確定します。

    Jira 統合スクリプトのベストプラクティス

    次のベストプラクティスは、Jira 統合スクリプトを作成するためのガイドラインです。

    • ServiceNow 統合とは異なり、Jira 統合では検出結果ごとにフィールドマッピングスクリプトが 1 回実行されます。ソースインスタンスと宛先インスタンスは、この統合には適用されません。
    • [プロジェクトキー] フィールドと [ドメイン名] フィールドで、ペイロードの送信先の Jira プロジェクトが決まります。
    • スクリプトをビルドするときは、grFinding 変数からフィールドを抽出して結果からのデータを使用します。
    • Jira プロジェクトに表示する説明とサマリーを作成できます。これらは、作業アイテムタイプのコア要素になります。Jira プロジェクトの他のフィールドを使用することもできますが、使用可能なフィールドを知るには Jira API を理解する必要があります。
    • 使用できる一般的なフィールドは次のとおりです。
      • サマリー
      • 説明
      • プロジェクト
      • issueType

      これらは、次の形式を使用して設定できます。

      payload = {
        'fields':{ 
         'summary': text to display in the title, 
         'description': a description of the work item, 
         'project': { 'key': the project key}, 
         'issuetype': { 'name': a work item type: Epic, Story, Bug, Task, Sub-Task} 
        } 

    Azure DevOps 統合で使用できる事前定義された変数がいくつかあります。

    ペイロード Jira プロジェクトに入力するフィールドマッピング。
    grFinding 要求を送信する検出結果の Glide レコード。
    workItemType Jira 統合用に選択された作業アイテムタイプ。
    キー Jira 統合用に作成されたプロジェクトキー。