GitHub Enterprise Server との統合

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：8分

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

    重要:
    必要なユーザーまたは API 権限のみにアクセス権を付与することで、セキュリティリスクを最小限に抑え、情報を保護します。
    表 : 1. 最小限のユーザー権限
    プロセス GitHub Enterprise Server アプリケーションで必要なユーザーロール 認証スコープ
    サブスクリプションのダウンロード サイト管理者 site_admin
    サブスクリプションの再利用 サイト管理者 site_admin

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

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

    始める前に

    GitHub 必要なロール:サイトアドミニストレーター

    このタスクについて

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

    手順

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

    GitHub Enterprise Server 接続を作成する

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

    始める前に

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

    ServiceNow 必要なロール：admin

    手順

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

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

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

    始める前に

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

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

    このタスクについて

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

    手順

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

    次のタスク

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

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

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