Enterprise Server と GitHub の統合

インスタンスを GitHub Enterprise Server アプリケーションと統合ServiceNowして、ソフトウェアサブスクリプションを追跡し、未使用のライセンスを再利用できます。

Enterprise Server の API アクセストークンを生成するGitHub

Enterprise Server API へのアクセス GitHub に使用できるトークンを生成します。

始める前に

GitHub 必要なロール:サイト管理者

このタスクについて

GitHubリポジトリ ホスティング サービスは、個人用アクセス トークンを使用して、ユーザーに API へのアクセスを許可しますGitHub。個人用アクセストークンは、API 要求を承認することで OAuth アクセストークンと同様に機能します。Enterprise Server API 要求を承認する GitHub 個人用アクセストークンを生成することで、Enterprise Server API にアクセスできます GitHub

手順

  1. Web ブラウザから Enterprise Server インスタンスを開きます GitHub
  2. アカウントにサインインします GitHub
  3. GitHubページヘッダーで、プロフィール写真をクリックし、[設定]を選択します。
    プロファイル設定が開きます。
  4. 左側のナビゲーション ウィンドウで、[ 開発者設定] を選択します。
    開発者設定が開きます。
  5. 左側のナビゲーション ウィンドウで、 [ 個人用アクセス トークン] を選択します。
  6. [個人用アクセス トークン] ページで、[ 新しいトークンの生成] をクリックします。
  7. 続行する前にパスワードの確認を求められたら、パスワードを入力し GitHub 、[ パスワードの確認]をクリックします。
  8. [新しい個人アクセストークン] フォームの [メモ ] フィールドにトークンの目的を記述します。
  9. [スコープを選択] フォームセクションで、[ site_admin ] チェックボックスをオンにして site_admin OAuth スコープを有効にします。
    OAuth スコープは、保護されたリソースに対するアプリケーションのアクセスレベルを制限します。site_admin OAuth スコープを使用すると、エンタープライズユーザー、組織、およびリポジトリを管理できます。
  10. [ トークンの生成] をクリックします。
    個人アクセストークンが生成されます。
  11. アクセストークンをコピーし、後で使用できるように安全な場所に保存します。

GitHub Enterprise Server 接続を作成する

Enterprise Server アプリケーションとServiceNowインスタンス間のGitHub接続を作成します。

始める前に

インスタンスと GitHub Enterprise Server アプリケーション間のServiceNow通信に を使用する場合はMID サーバー、まずインスタンスで をMID サーバーセットアップする必要があります。詳細な手順については、「 MID Server 」を参照してください。

ServiceNow 必要なロール:admin

手順

  1. ServiceNowインスタンスから、 プロセス自動化 > Flow Designer.
    Flow Designer が新しいタブで起動します。
  2. [接続] タブを選択します。
  3. サーバー接続の GitHub [詳細の表示] をクリックします。
  4. 使用可能な接続の一覧から [サーバー] を見つけ GitHub 、[ 構成] をクリックします。
    [接続の設定] ダイアログボックスが開きます。
  5. ダイアログボックスで、フィールドに入力します。
    表 : 1. [接続の設定] ダイアログボックス
    フィールド 説明
    接続名 GitHubサーバー接続の名前。
    接続 URL GitHubインスタンスの URL です。
    MID サーバー の使用 インスタンスが ServiceNow Enterprise Server アプリケーションとのGitHub通信に を使用MID サーバーできるようにするオプション。インスタンスで必要な MID サーバー場合は、このフィールドを true に設定します。インスタンスに MID サーバーが必要ない場合は、このフィールドを空のままにします。
    重要:
    このオプションを有効にするには、インスタンスに既に MID サーバー セットアップが必要です。詳細な手順については、「 MID Server 」を参照してください。
    API キー Enterprise Server API へのアクセス GitHub を可能にする個人用アクセストークン。<api-key>」と入力します。ここで<api-key>は、でEnterprise Server の API アクセストークンを生成するGitHub生成した個人用アクセストークンです。
  6. [接続を設定] をクリックします。

GitHub Enterprise Server 統合プロファイルの作成

GitHub Enterprise Server 統合プロファイルを作成して、ソフトウェアサブスクリプションを追跡し、Enterprise Server アプリケーションのライセンスを最適化しますGitHub

始める前に

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

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

このタスクについて

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

手順

  1. 統合プロファイルに移動します。
    インターフェイスアクション
    コア UI
    1. 移動先 すべて > ソフトウェア資産 > SaaS ライセンス > 直接統合プロファイル.
    2. [New (新規)] を選択します。
    3. [GitHub Server サブスクリプション プロファイル] を選択します。
    Software Asset Workspace
    1. 移動先 ライセンス操作 > ユーザー登録 > 直接統合プロファイル.
    2. [New (新規)] を選択します。
    3. ドロップダウン リストから [GitHub Server ] を選択します。
    4. [続行] を選択します。
  2. フォームのフィールドに入力します。
    表 : 2. 統合プロファイルフォーム
    フィールド 説明
    表示名 データ連携プロファイルの名前たとえば、GitHub サーバー統合です。
    接続と資格情報 スポークの接続および資格情報エイリアス。GitHubこのフィールドは自動的に [sn_github_spoke] に設定されます。GitHub_Server
    ステータス 統合プロファイルのステータス。統合プロファイルを公開していない場合、このフィールドは自動的に [ドラフト] に設定されます。統合プロファイルを既に公開している場合、このフィールドは自動的に [公開済み] に設定されます。
    プロファイルタイプ 統合プロファイルのタイプ。このフィールドは自動的に [github_server_subscription] に設定されます。
  3. [ Download Subscription Subflow ] タブで、[ Subflow ] フィールドが [GitHub Server Download Subscriptions] に設定されていることを確認します
    現在の日付の 1 年前まで個々のユーザーによって実行されたイベントを表示できます。詳細については、「ソフトウェア再利用ルールのレビュー」を参照してください。
    注:
    ソフトウェア資産管理 は、プロファイル作成日に関係なく、ユーザーサブスクリプションのダウンロードを開始した時点からのイベントをプルします。
  4. [ サブスクリプションの再利用サブフロー ] タブで、 [ サブフロー ] フィールドが [GitHub Server Reclaim Subscription] に設定されていることを確認します。
  5. [保存] をクリックします。
    ServiceNowインスタンスによってドラフト統合プロファイルが作成されます。統合プロファイルは、 GitHub サーバーダウンロードサブスクリプションと GitHub サーバー再利用サブスクリプションサブフローを使用して、Enterprise Server アプリケーションから GitHub データを取得します。
  6. フォームを再ロードしたら、[ 公開] をクリックします。
    [公開の確認] ダイアログボックスが開きます。
  7. ダイアログボックスで、「 OK」をクリックします。

次のタスク

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

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

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