SGC セントラル を使用して Apigee X の API サービスグラフコネクタを構成する

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：7分

    • Apigee X データを CMDB にプルするようにスケジュール済みインポートジョブを設定します。

    始める前に

    ServiceNow Store から Apigee X の API サービスグラフコネクタ (バージョン 1.0.0 以降) をインストールします。 インストール手順 ServiceNow Store については、「 ServiceNow Store アプリケーションのインストール」を参照してください。
    必要なロール:次の表は、プレイブックの各ステージに必要なロールを示しています。
    表 : 1. 各プレイブックステージに必要なロール
    ステージ ロール
    必須条件 アドミン
    セットアップ SGC-Admin (sn_cmdb_int_util.sgc_admin) または admin
    注:
    バックグラウンドスクリプトを実行し、SGC-Admin ユーザーにグローバルテーブルへのアクセス権を付与するには、admin ユーザーロールが必要です。サービスグラフコネクタのユーザーロールの詳細については、「サービスグラフコネクタ ユーザーロール」を参照してください。

    このタスクについて

    オンボーディングコネクタのプレイブックエクスペリエンスは、CMDB ワークスペースのSGC セントラルでアクティブ化されます。SGC セントラルアプリケーションを構成するには、「SGC セントラル の構成」を参照してください。プレイブックの操作方法の詳細については、「プレイブックとやり取りする」を参照してください。

    注:
    または、 SGC セントラル のインストール済み接続またはドラフト接続から既に利用可能なデフォルトの接続を構成することもできます。検索項目 すべて > サービスグラフコネクタをクリックし、メニューからコネクタの [セットアップ ] を選択します。インストール済み接続とドラフト接続の詳細については、「 SGC セントラル で サービスグラフコネクタ用に追加された接続の管理」を参照してください。

    手順

    1. 移動先 ワークスペース > CMDB ワークスペース.
    2. CMDB ワークスペースで SGC セントラル を選択します。
    3. [概要] ページで、[接続を作成] を選択します。
      ヒント:
      または、 [すべての接続] ページで [接続を作成] を選択することもできます。
    4. [接続を作成] ウィンドウで、Apigee X コネクタタイプを選択し、[接続を作成] を選択します。
    5. コネクタを使用して初めて接続を設定するための最初の前提条件を満たします。
      注:
      この手順は、初回セットアップ時にのみ必要です。「SGC セントラルで接続を作成するときの初期セットアップタスクの実行」を参照してください。
    6. Apigee X 環境を設定するための前提条件を満たします。
      1. Apigee X 環境を設定し、Apigee X アプリケーションから取得したセキュリティ証明書を暗号化する Java KeyStore (JKS) 証明書を作成します。
        1. プレイブックの [前提条件] ステージで、[セットアップ手順をレビュー (Review setup instructions)] アクティビティを選択します。
        2. Now Support ナレッジベースの「API Service Graph connector for Apigee X - Setup Instructions (Apigee X の API サービスグラフコネクタ - セットアップ手順) [KBB0010364]」の記事にあるセットアップ手順を確認して完了します。

          サービスアカウントを作成し、ロールをアサインして、サービスアカウントにロールをバインドし、API を有効にし、P12 ファイルを作成して、ServiceNow インスタンスに登録する必要があります。

          宛先キーストアのパスワードをメモします。このパスワードは、JKS 証明書を Apigee X の API サービスグラフコネクタ アプリケーションにインポートするときに指定する必要があります。

        3. [セットアップの説明を読みました (I have read the setup instructions)] チェックボックスをオンにして、指示に従って Apigee X 環境をセットアップしたことを確認します。
        4. [続行] を選択します。
      2. X.509 証明書を作成して、コネクタで Apigee X アプリケーションの Java KeyStore (JKS) 証明書に関連付けます。
        注:
        以前に作成した証明書を再利用する場合は、この手順をスキップできます。
        1. プレイブックの [前提条件] ステージで、[X.509 証明書を作成] アクティビティを選択します。
        2. フォームのフィールドに入力します。
          表 : 2. [X.509 証明書] フォーム
          フィールド 説明
          名前 X.509 証明書の名前。例: ApigeeX-509Certificate。
          キーストアパスワード 前のステップでメモした JKS 証明書にアクセスするためのパスワード。
          簡単な説明 X.509 証明書の説明。
        3. [添付ファイル] セクションで、[ファイルを追加] を選択します。
        4. 前の手順で作成した JKS 証明書の P12 ファイルを参照して選択します。
        5. [ファイルをアップロード] ダイアログボックスで、[アップロード] を選択します。
        6. [続行] を選択します。
    7. 接続の詳細を入力し、Apigee X データをインポートするための API 接続をテストします。
      1. プレイブックの [セットアップ (Setup)] ステージで、[接続を作成してテスト (Create and test connection)] アクティビティを選択します。
      2. フォームのフィールドに入力します。
        表 : 3. [接続を構成してテスト (Configure and test connection)] フォーム
        フィールド 説明
        接続名 Apigee X接続レコードを識別する名前です。
        サービスアカウントメール 前の手順でメモした Apigee X による認証に使用される ServiceNow サービスアカウントに関連付けられているメールアドレス。
        X.509 証明書 前の手順でメモした X.509 証明書の名前。
        キーストアパスワード 前の手順でメモした、キーストアに関連付けられているパスワード。
      3. [接続の作成とテスト] を選択します。
      4. 接続テストが完了したら、[続行] を選択します。
    8. 接続の構成プロパティを設定します。
      1. プレイブックの [セットアップ (Setup)] ステージで、[構成プロパティを設定 (Set configuration properties)] アクティビティを選択します。
      2. プロパティを入力します。
        表 : 4. サービスグラフ接続のプロパティ
        プロパティ 説明
        Apigee ID
        Apigee 組織名/GCP プロジェクト ID Apigee X データのフェッチ元となる組織名または GCP プロジェクト ID。空白のままにすると、許可されたすべての Apigee X 組織からデータが取得されます。

        複数の値の場合は、カンマで区切ります。
        データ検索構成
        環境を含める Apigee X 接続に含める環境。

        環境が複数ある場合は、カンマで区切ります。Include environmentsプロパティにリストされている環境の API プロキシのみがインポートされます。

        このフィールドを空のままにすると、コネクタ内のデータソースはすべての環境から API プロキシをインポートします。
        収集期間 (日数) API 使用状況データを収集する期間 (日数)。
        使用状況データを収集 (Collect usage data) 使用状況データ収集を有効にして、指定した期間の API 使用状況データを取得するオプション。
        HTTP メソッドタイプを展開 ルートについて考慮する GET、POST、PUT、PATCH、DELETE、OPTIONS、HEAD、CONNECT、TRACE などの HTTP メソッド。

        メソッドが複数ある場合は、カンマで区切ります。空白のままにすると、すべての標準 HTTP メソッドをサポートしていることを示す ALL メソッドで単一の API フロントエンドが作成されます。
        GCP ID
        GCP 組織 ID GCP組織、GCPフォルダー、およびGCPプロジェクトのデータソースからデータを取得するための組織 IDGCP。
      3. [続行] を選択します。
    9. 定期的にデータをインポートするようにインポートスケジュールを構成します。
      1. プレイブックの [セットアップ] ステージで、[インポートスケジュールの構成] アクティビティを選択します。
      2. [スケジュール済みインポート] リスト内で [スケジュール設定済みの親データインポート] を展開して、接続に関連付けられている Apigee 組織 のインポートスケジュールを選択します。
        注:
        接続名には、スケジュール名のプリフィックスが付きます。
      3. [インポートスケジュールの構成] ダイアログボックスで、[アクティブ] チェックボックスをオンにして、実行スケジュールと時間の詳細を入力します。

        詳細については、「Schedule a data import」を参照してください。

      4. [保存] を選択します。
        あるいは、[今すぐ実行] を選択してインポートスケジュールをすぐに実行します。
      5. [続行] を選択します。
    10. プレイブックの セットアップ ステージで、[ 接続の作成の確認 (Confirm connection creation )] アクティビティを選択して、接続が作成されたかどうかを確認します。

    次のタスク

    [すべての接続を表示 (View all connections)] を選択して、接続の詳細を確認します。構成された接続が [インストール済み接続 (Installed connections)] リストに表示されます。

    その後、CMDB ワークスペースのSGC セントラルビューから接続を管理できます。詳細については、「SGC セントラル で サービスグラフコネクタ用に追加された接続の管理」を参照してください。