Jiraソフトウェアクラウドとの統合

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：13分

    • ソフトウェア資産管理アプリケーションを Atlassian Jira Software Cloud と統合すると、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用できます。

    注:
    現在、この統合はプロファイルごとに 1 つのサイト統合のみをサポートしています。
    • インストールされている Jira スポークのバージョンが 4.1.0 以降の場合、次のいずれかの方法を使用して、 Jira を ServiceNow インスタンスと統合できます。
    • インストールされている Jira スポークバージョンが 4.1.0 より前の場合は、ベーシック認証の使用方法で Jira を ServiceNow インスタンスと統合します。
    重要:
    必要なユーザーまたは API 権限のみにアクセス権を付与することで、セキュリティリスクを最小限に抑え、情報を保護します。
    表 : 1. 最小限のユーザー権限
    責任を担います。 Jira Software Cloud アプリケーションで必要なユーザーロール 認証スコープ
    サブスクリプションをダウンロード アクセス権限 Jira
    • read:application-role:jira
    • read:group:jira
    • read:user:jira
    • read:アバター:jira
    ユーザーアクティビティのプル
    • Jiraグローバル権限の管理
    • 問題を含むプロジェクトのプロジェクト参照権限。

      問題レベルのセキュリティが構成されている場合は、問題を表示するための問題レベルのセキュリティ権限。
    • read:user:jira
    • read:issue-details:jira
    • read:audit-log:jira
    • read:アバター:jira
    • read:field-configuration:jira
    • read:issue-meta:jira
    サブスクリプションを再利用 サイト管理者、つまり site-admin グループのメンバー
    • read:group:jira
    • write:group:jira

    ベーシック認証の使用

    API キーを使用して ソフトウェア資産管理 アプリケーションと Jira を統合し、 ServiceNow 要求を認証します。

    ServiceNow インスタンスを複数の Jira インスタンスと統合できます。この統合に対して、接続および資格情報エイリアスレコードを作成し、Jira インスタンスごとに接続レコードを作成します。

    Jira アカウント API トークンを作成する

    Jira で API トークンを作成して、要求を認証します。

    始める前に

    Jira 必要なロール: 「最小限のユーザー権限 」表を参照してください。

    手順

    1. [Atlassian API トークン] に移動します。
    2. [API トークンの作成] を選択します。
    3. API トークンの名前を入力し、 [作成] を選択します。
    4. API トークンをコピーして保存します。
      トークンは後で使用します。

    接続および認証情報レコードの構成

    デフォルトの接続および資格情報エイリアスレコードを構成し、ServiceNow からの要求を認証します。

    始める前に

    必要なロール：admin

    手順

    1. 次のように移動する。 All (すべて) > 接続 & 認証情報 > 接続 & 資格情報エイリアス.
    2. スポークに付属している Jira のエイリアスレコードを開きます。
    3. [新しい接続および資格情報の作成] 関連リンクを選択します。
    4. フォームのフィールドに入力します。
      表 : 2. 接続と資格情報を作成
      フィールド 説明
      接続 URL https://<provider-domain-name>.atlassian.net 形式のJiraインスタンスの URL。
      ユーザー名 ユーザーのメールアドレスを入力します。
      API キー Jira用に生成した API トークンを入力します。
    5. [Create (作成)] を選択します。

    OAuth 認証の使用

    OAuth を使用して ソフトウェア資産管理 アプリケーションを Jira アカウントと統合し、 ServiceNow 要求を認証します。

    Jira アカウントでの OAuth 2.0 統合の作成

    Atlassian 開発者コンソールで OAuth 2.0 統合を作成して、要求を認証します。

    始める前に

    Jira 必要なロール: 「最小限のユーザー権限 」表を参照してください。

    手順

    1. Atlassian 開発者コンソールにログインします。
    2. [自分のアプリ] で、 [作成] を選択し、 [OAuth 2.0 統合] を選択します。
    3. フォームで、統合の名前を入力し、[ 作成] を選択します。

      統合が作成され、アプリ ID の値が表示されます。

    4. [認証] を選択します。
      1. [アクション] の下の [追加] を選択します。
      2. [コールバック URL] には、ServiceNowインスタンスの URL を https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do の形式で入力します。
        例: https://example.service-now.com/oauth_redirect.do。
      3. [変更内容を保存] を選択します。
    5. [設定 (Settings)] を選択します。
    6. [認証の詳細] で、[クライアント ID] と [クライアントシークレット] の値をコピーします。
    7. 選択 権限 > Jira API > 構成.
    8. [ 詳細なスコープ ] タブを選択します。
    9. [ スコープの編集] を選択して、次のスコープを追加します。
      • read:application-role:jira
      • read:group:jira
      • read:user:jira
      • read:アバター:jira
      • read:audit-log:jira
      • read:issue-details:jira
      • read:field-configuration:jira
      • read:issue-meta:jira
      • write:group:jira
      要件に応じて他のスコープを構成できます。

    Jiraインスタンスのクラウド ID 値を取得する

    Jiraクラウドインスタンスのクラウド ID の値を取得します。この値は、ServiceNow インスタンスの接続レコードを構成するときに必要です。

    始める前に

    Jira 必要なロール：admin

    手順

    1. Atlassian Administration にログインします。
    2. 必要な組織に対して [ 選択 ] ボタンを選択します。
    3. [製品] タブを選択します。
    4. 製品 ページで、Jira 製品行の 製品の管理を選択します。

      新しいウィンドウでは、URL は次の形式です: https://admin.atlassian.com/o/<orgID>/products/jira-software/<Cloud-Id>。

    5. 後で使用するためにクラウド ID の値をコピーします。

    Jiraソフトウェアクラウド統合プロファイルの作成

    統合プロファイルを作成して、ソフトウェアサブスクリプションを追跡し、 Atlassian Jira Software Cloud のライセンスを最適化します。

    始める前に

    Jira統合プロファイルを作成するには、ServiceNow Store から ソフトウェア資産管理 - SaaS ライセンス管理 プラグイン (sn_sam_saas_int) を要求します。

    統合プロファイルが Jira ユーザーアクティビティの更新サブフローを介してユーザーアクティビティを取得および更新できるようにするには、 com.glide.transform.json.max-partial-length システムプロパティ の値を32768 に設定します。

    Atlassian 必要なロール:サイトアドミン

    ServiceNow 必要なロール:admin または sam_integrator

    重要:
    [Application Manager] ページでオプション機能をインストールする際には、この統合の [Jira スポーク] チェックボックスをオンにする必要があります。必要な SaaS アプリケーションの選択の詳細については、「 SaaS ライセンス管理の要求」を参照してください。

    このタスクについて

    ソフトウェア資産ワークスペースを使用している場合、コア UI でJira統合プロファイルを作成するオプションは非アクティブです。

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      Core UI (コア UI)
      1. 次のように移動する。 All (すべて) > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. [Jira 統合プロファイル] を選択します。
      ソフトウェア資産ワークスペース
      1. 次のように移動する。 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. ドロップダウンリストから [Jira ] を選択します。
      4. [Continue (続行)] を選択します。
    2. フォームのフィールドに入力します。
      表 : 3. 統合プロファイルフォーム
      フィールド Value (値)
      表示名 任意の名前。たとえば、Jiraデータ連携です。
      ステータス 統合プロファイルのステータス。
      • 統合プロファイルを公開していない場合、このフィールドは自動的に [ドラフト] に設定されます。
      • 統合プロファイルを既に公開している場合、このフィールドは自動的に [公開済み] に設定されます。
      プロファイルタイプ Jira 予約。このフィールドは、自動的に入力されます。
    3. 各プロセスの [ ベンダー構成 ] フィールドで指定された必要なユーザーロールまたは API 権限を確認して、セキュリティリスクを最小限に抑え、 SaaS ライセンスを最適化します。
      注:
      詳細については、「 最小限のユーザーアクセス許可 」テーブルを参照してください。
      1. [サブスクリプションのダウンロードサブフロー] セクションで、[ サブフロー ] フィールドが [Jira サブスクリプションのダウンロード] に設定されていることを確認します。
        注:
        [ サブスクリプションをダウンロード ] チェックボックスはデフォルトでオンになっており、オフにすることはできません。
      2. [アクティビティサブフローを計算] セクションで、[ サブフロー ] フィールドが [Jira ユーザーアクティビティの更新] に設定されていることを確認します。
        注:
        [ ダウンロードアクティビティ ] チェックボックスはデフォルトでオンになっています。これをクリアすると、アクティビティのスケジュール済みジョブ SAM - Refresh <displayname> Activity は作成されません。
        [ ユーザーアクティビティを分析 ] フィールドで、ユーザーアクティビティを分析する開始日時を選択することもできます。デフォルトでは、現在の日付の 60 日前までのユーザーアクティビティを分析し、このプロファイルを作成したときから個々のユーザーが実行したイベントを表示できます。
        注:
        ソフトウェア資産管理 は、プロファイルの作成日に関係なく、ユーザーアクティビティの分析を開始した時点からのイベントをプルします。
        この値は、ソフトウェア再利用ルールの [前回のアクティビティしきい値] フィールドで変更できます。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。
      3. [サブスクリプションサブフローの再利用 (Reclaim Subscription Subflow)] セクションで、[ サブフロー ] フィールドが [Jira サブスクリプションの再利用 (Jira Reclaim Subscription)] に設定されていることを確認します。
        注:
        [ サブスクリプションを再利用 ] チェックボックスはデフォルトでオンになっています。サブスクリプションを再利用しない場合は、このチェックボックスをオフにします。これをクリアすると、削除候補は作成されますが、サブスクリプションの再利用サブフローがトリガーされないか、再利用プロセスが開始されません。
    4. [Save (保存)] をクリックする。
      ドラフトの統合プロファイルが作成されます。

      [接続と資格情報] フィールドが表示され、自動的に sn_jira_spoke に設定されます。Jira。

    5. Jira製品へのアクセス権を持つグループを指定します。
      ServiceNowインスタンスでこれらのグループを指定すると、これらのグループ内のユーザーのみのデータを取得し、ライセンスを管理できます。
      1. 新しいタブで、 Atlassian 管理ポータルを開きます。
      2. サイトアドミンアカウントにログインします。
      3. 必要な組織に対して [ 選択 ] ボタンを選択します。
      4. [製品] タブを選択します。
      5. 製品 ページで、Jira 製品行の 製品の管理を選択します。
      6. Jiraソフトウェアにアクセスできるグループのリストを表示します。
        後で使用するために、この情報をメモします。
      7. ServiceNowインスタンスに戻り、次に移動します: Jira > Jira グループ.
      8. [グループ Jira ] フォームで、[ グループの追加 ] 関連リンクを選択します。
        [ Jira グループを追加] ダイアログボックスが開きます。
      9. [利用可能] リストで、 Jira 製品にアクセスできるグループを選択します。
        ヒント:
        [利用可能] リストには、Atlassian アカウントに関連付けられているすべてのグループが含まれます。Jira製品にアクセスできるグループのみを選択します。
      10. 右矢印ボタンを選択して、グループを [利用可能] リストから [選択済み] リストに移動します。
      11. [OK] を選択します。
    6. 統合プロファイルフォームで、[ 接続を検証 ] を選択して、この統合の接続と資格情報の詳細を確認します。

      接続を検証すると、Download Subscriptions API と Calculate Activity API は検証されますが、Reclaim Subscriptions API は検証されません。

    7. 接続を確認したら、[ 公開] を選択します。
    8. 公開の確認 ダイアログ ボックスで、 OK を選択します。
      注:
      統合プロファイルの公開後に [ ダウンロードアクティビティ ] チェックボックスをオフにすると、次のイベントが発生するため、接続を再検証してから統合プロファイルを再公開する必要があります。
      • 統合プロファイルフォームの [ ステータス ] フィールドが [ドラフト] に変わります。
      • [ 接続を検証] ボタンがフォームに表示されます。
      • 現在の SAM - Refresh <displayname> Activity ジョブが削除されます。

    次のタスク

    統合が接続されると、 ServiceNow インスタンスでソフトウェアモデル、再利用ルール、ソフトウェアサブスクリプションが自動的に作成され、毎日更新されます。

    一意の接続を持つ複数の統合プロファイルを設定する場合は、子エイリアスを作成して、統合プロファイルごとに異なる構成と設定を管理します。詳細については、「子エイリアスを作成して複数の統合プロファイルを設定する」を参照してください。

    ユーザーサブスクリプションを再利用するために、自動的に生成されたすべての再利用ルールを確認します。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。

    自動生成されたソフトウェアモデルのソフトウェアエンタイトルメントを作成して、使用済みソフトウェアを所有ソフトウェアに対して追跡します。
    調整は、サブスクリプションでもスケジュール済みジョブとして、またはオンデマンドで実行されます。調整結果は、 ライセンスワークベンチ (クラシックアプリケーションソフトウェア資産管理 ) または ライセンス使用状況ビュー (ソフトウェア資産ワークスペース) で表示できます。これらの結果を使用して、ライセンスコンプライアンスの状況を判断し、コンプライアンス違反を修正します。