Software Cloud と Jira の統合

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

    • インスタンスを ServiceNow Software Cloud と Atlassian Jira 統合して、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用することができます。

    • インストールされているJiraスポークバージョンが 4.1.0 以降の場合は、次のいずれかの方法を使用してインスタンスとServiceNow統合Jiraできます。
    • インストールされているJiraスポークバージョンが 4.1.0 より前の場合は、方法でインスタンス基本認証の使用と統合JiraしますServiceNow。
    注:
    現在、この統合は、プロファイルごとに 1 つのサイト統合のみをサポートしています。

    基本認証の使用

    API キーを使用してServiceNowインスタンスとJiraをデータ連携し、ServiceNow要求を認証します。

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

    アカウント API トークンの作成Jira

    要求を認証するための API トークンを作成します Jira 。

    始める前に

    Jira 必要なロール：admin

    手順

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

    接続および資格情報レコードの構成

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

    始める前に

    必要なロール：admin

    手順

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

    OAuth 認証の使用

    OAuth を使用して ServiceNow インスタンスと Jira アカウントをデータ連携し、ServiceNow 要求を認証します。

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

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

    始める前に

    必要なロール：admin

    手順

    1. Atlassian Developer Console にログインします。
    2. [自分のアプリ] で [作成] をクリックし、[OAuth 2.0 統合 (OAuth 2.0 integration)] を選択します。
    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. [設定] をクリックします。
    6. [認証の詳細] で、[クライアント ID] と [クライアントシークレット] の値をコピーします。
    7. [権限] をクリックします。
      1. [詳細なスコープ] で、次のスコープを選択します。
        • read:application-role:jira
        • read:group:jira
        • read:user:jira
        • read:avatar:jira
        • read:audit-log:jira
        • read:issue-details:jira
        • read:field-configuration:jira
        • read:issue-meta:jira
        • write:group:jira
        要件に応じて他のスコープを構成できます。

    クラウド ID の値の取得

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

    始める前に

    必要なロール：admin

    手順

    1. Atlassian Administration にログインします。
    2. 必要な組織で [選択] をクリックします。
    3. Jiraソフトウェア製品から、「製品アクセスの管理」をクリックします。

      新しいウィンドウでは、URL の形式は https://admin.atlassian.com/s/<Cloud-ID>/apps です。

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

    ServiceNow インスタンスでのアプリケーションレジストリの作成

    OAuth 2.0 統合の作成中に生成された情報を使用して、インスタンスに ServiceNow アプリケーションレジストリレコードを作成します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > システム OAuth > アプリケーションレジストリー.
    2. [New (新規)] をクリックします。
      「 OAuth アプリケーションの種類は?」というメッセージが表示されます。
    3. [サードパーティ OAuth プロバイダーに接続します] を選択します。
    4. フォームに、これらの値を入力します。
      表 : 2. アプリケーションレジストリ
      フィールド 説明
      名前 アプリケーションレジストリレコードを識別する名前です。
      クライアント ID 開発者コンソールで Atlassian OAuth 2.0 統合が作成されたときに生成されたクライアント ID。
      クライアントシークレット 開発者コンソールで Atlassian OAuth 2.0 統合が作成されたときに生成されたクライアントシークレットです。
      デフォルトの権限許可タイプ トークンを確立するために使用される権限許可のタイプ。[認証コード] を選択します。
      認証 URL OAuth 認証コードのエンドポイントです。https://auth.atlassian.com/authorize を入力します。
      トークン URL OAuth サーバートークンエンドポイントです。https://auth.atlassian.com/oauth/token を入力します。
      リダイレクト URL OAuth コールバックエンドポイント。アプリケーションレジストリの保存中に URL が生成されます。
      リフレッシュトークン URL トークンを更新する URL です。https://auth.atlassian.com/oauth/token を入力します。
      注:
      このフィールドはフォーマットのレイアウトで非表示になります。フォームレイアウトを設定してこのフィールドを表示します。
    5. フォームヘッダーを右クリックし、[保存] をクリックします。
      [OAuth エンティティプロファイル] タブで、デフォルトの OAuth エンティティプロファイルレコードを作成します。
    6. [OAuth エンティティスコープ] で、次のエンティティスコープレコードを作成します。
      名前 OAuth スコープ
      read:application-role:jira read:application-role:jira
      read:group:jira read:group:jira
      read:user:jira read:user:jira
      read:avatar:jira read:avatar:jira
      read:audit-log:jira read:audit-log:jira
      read:issue-details:jira read:issue-details:jira
      read:field-configuration:jira read:field-configuration:jira
      read:issue-meta:jira read:issue-meta:jira
      write:group:jira write:group:jira
      offline_access offline_access

    タスクの結果

    アプリケーションレジストリレコードがインスタンスに ServiceNow 作成されます。

    の資格情報レコードの作成 Jira

    Jiraアカウント用の資格情報レコードを作成します。Jira スポーク接続および資格情報エイリアスでは、この資格情報を使用してアクションを許可します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 接続 & 資格情報 > 資格情報.
    2. [New (新規)] をクリックします。
      「 作成する資格情報のタイプは?」というメッセージが表示されます。
    3. [OAuth 2.0 資格情報] を選択します。
    4. フォームに、これらの値を入力します。
      表 : 3. OAuth 2.0 資格情報
      フィールド 説明
      名前 Jira スポークの資格情報レコードを識別する名前です。例：Jira OAuth 資格情報。
      OAuth エンティティ プロファイル アプリケーションレジストリレコードの構成時に作成されるデフォルトの OAuth エンティティプロファイルレコードです。
    5. [送信] をクリックします。

    の接続レコードの作成 Jira

    Jiraアカウントの接続レコードを作成します。接続および資格情報エイリアスでは、この接続を使用して Jira でアクションを実行します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 接続 & 資格情報 > 接続および資格情報エイリアス.
    2. スポークに付属しているエイリアスレコード Jira を開きます。
    3. 接続 タブで、新規 を選択します。
      空の HTTP(s) 接続フォームが表示されます。
    4. フォーム上で、以下のフィールドに記入します。
      表 : 4. HTTP(S) 接続
      フィールド 説明
      名前 接続レコードを識別する一意の名前を入力します。たとえば、「OAuth 接続」と入力します Jira 。
      認証情報 Jira 用に作成された資格情報レコードを選択します。たとえば、[OAuth 資格情報] を選択します Jira 。
      接続エイリアス [sn_jira_spoke] を検索して選択します 。Jira エイリアス。
      接続 URL インスタンスの URL を https://api.atlassian.com/ex/jira/<Cloud-ID> 形式で入力しますJira。

      クラウド ID の値の取得については、次を参照してください クラウド ID の値の取得。
    5. [属性] 関連リストで、次の値を入力します。
      1. [api_version] に値「2」を入力します。
      2. [server_type] に値「cloud」を入力します。
    6. [送信] を選択します。
    7. 移動先 すべて > 接続 & 資格情報 > 資格情報.
    8. スポーク用に作成した資格情報レコードを開きます Jira 。
      たとえば、OAuth 資格情報です Jira 。
    9. [OAuth トークンの取得] 関連リンクを選択します。
      新しいウィンドウで、システムはアカウントへのアクセスを要求します Atlassian 。
    10. [承認] を選択します。
      アカウントへのアクセス Atlassian が許可され、リフレッシュトークンが利用可能であることを示す確認メッセージがインスタンスに表示されます ServiceNow 。

    Jira Software Cloud 統合プロファイルを作成する

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

    始める前に

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

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

    Atlassian 必要なロール:site admin

    ServiceNow 必要なロール:

    • スポークのバージョン 5.0.1 ソフトウェア資産管理SaaS ライセンス管理 およびバージョン 3.0.4 Jira 以降では、ServiceNowsam_integrator と sn_jira_spoke.jira_admin または admin ロールが必要です。

    • スソフトウェア資産管理SaaS ライセンス管理ポークのバージョン 5.0.1 より前およびバージョン 3.0.4 Jira より前のスポークでは、ServiceNowsam_integrator または admin ロールが必要です。

    このタスクについて

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

    手順

    1. 統合プロファイルに移動します。
      インターフェイスアクション
      コア UI
      1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. [Jira 統合プロファイル] を選択します。
      Software Asset Workspace
      1. 移動先 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
      2. [New (新規)] を選択します。
      3. ドロップダウン リストから [Jira ] を選択します。
      4. [続行] を選択します。
    2. フォームのフィールドに入力します。
      表 : 5. 統合プロファイルフォーム
      フィールド 値
      表示名 任意の名前。たとえば、Jiraデータ連携です。
      接続と資格情報 sn_jira_spoke。Jira。このフィールドは、自動的に入力されます。
      ステータス 統合プロファイルのステータス。オプションは [ドラフト] と [公開済み] です。このフィールドは、自動的に入力されます。
      プロファイルタイプ Jira サブスクリプション。このフィールドは、自動的に入力されます。
    3. [ アクティビティサブフローの計算 ] フォームセクションで、[ ユーザーアクティビティの分析元] フィールドの値を選択します。
      [ユーザー アクティビティの分析元] フィールドで、ユーザー アクティビティを分析する日時を選択することもできます。デフォルトでは、現在の日付の 60 日前までのユーザーアクティビティを分析し、このプロファイルの作成以降に個々のユーザーが実行したイベントを表示できます。
      注:
      ソフトウェア資産管理 は、プロファイルの作成日に関係なく、ユーザーアクティビティの分析を開始した時点からのイベントをプルします。
      この値は、ソフトウェア再利用ルールの [前回のアクティビティしきい値] フィールドで変更できます。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。
      注:
      統合プロファイルを保存すると、[ ユーザーアクティビティの分析元] フィールドは読み取り専用になります。
    4. [保存] をクリックします。
      ドラフト統合プロファイルが作成されます。統合プロファイルは、[ Jira サブスクリプションのダウンロード]、[ユーザーアクティビティの更新]、 Jira および Jira [サブスクリプションの再利用] サブフローを使用して、ソフトウェアアプリケーションから Jira ユーザーデータを取得します。
    5. 製品にアクセスできる Jira グループを指定します。
      重要:
      この手順は、統合のバージョン 5.0.1 ソフトウェア資産管理SaaS ライセンス管理 以降およびスポークのバージョン Jira 3.0.4 以降にのみ適用されます。
      インスタンスで ServiceNow これらのグループを指定することで、これらのグループ内のユーザーのみのデータを取得し、ライセンスを管理できます。
      1. 新しいタブで、 Atlassian 管理ポータルを開きます。
      2. サイト管理者アカウントにログインします。
      3. 移動先 サイトの設定 > 製品アクセス.
      4. セクションで Jira 、ソフトウェアにアクセスできる Jira グループのリストを表示します。
        後で使用するために、この情報をメモします。
      5. インスタンスに戻り ServiceNow 、 Jira > Jira グループ.
      6. グループフォーム Jira で、[ グループを追加 ] 関連リンクをクリックします。
        [グループの追加 Jira ] ダイアログボックスが開きます。
      7. [利用可能] リストで、製品へのアクセス権 Jira を持つグループを選択します。
        ヒント:
        [利用可能] リストには、Atlassian アカウントに関連付けられているすべてのグループが含まれます。製品にアクセスできる Jira グループのみを選択します。
      8. 右矢印ボタンをクリックして、グループを [利用可能] リストから [選択済み] リストに移動します。
      9. [OK] をクリックします。
    6. 次に移動して統合プロファイルに戻ります SaaS ライセンス > 管理 > 直接統合プロファイル をクリックし、[統合プロファイル] リストからプロファイルを選択します。
    7. [公開] をクリックします。
      [公開の確認] ダイアログボックスが開きます。
    8. ダイアログボックスで、「 OK」をクリックします。

    次のタスク

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

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

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