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

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：7分

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

    始める前に

    ServiceNow Store から Apigee X の API サービスグラフコネクタ (バージョン 1.0.0 以降) をインストールします。 インストール手順 ServiceNow Store については、「 ServiceNow Store アプリケーションのインストール」を参照してください。

    必要なロール：cmdb_inst_admin または admin

    このタスクについて

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

    手順

    1. 移動先 ワークスペース > CMDB ワークスペース.
    2. CMDB ワークスペースで SGC セントラル を選択します。
    3. [概要] ページで、[接続を作成] を選択します。
      ヒント:
      または、 [すべての接続] ページで [接続を作成] を選択することもできます。
    4. [接続を作成] ウィンドウで、Apigee X コネクタタイプを選択し、[接続を作成] を選択します。
    5. コネクタを使用して初めて接続を設定するときは、最初の前提条件を満たしてください。
      注:
      この手順は、初回セットアップ時にのみ必要です。「で接続を作成するときに初期セットアップタスクを実行する SGC セントラル」を参照してください。
    6. Apigee X 環境を設定するための前提条件を満たします。
      1. Apigee X環境を設定し、Java KeyStore (JKS) 証明書を作成して、Apigee X アプリケーションから取得したセキュリティ証明書を暗号化します。
        1. プレイブックの [前提条件 (Prerequisites)] ステージで、[セットアップの手順を確認 (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. [セットアップ手順を読みました] チェック ボックスをオンにして、指示に従ってApigee X環境を設定したことを確認します。
        4. [Continue (続行)] を選択します。
      2. X.509 証明書を作成して、 Apigee X アプリケーションの Java KeyStore (JKS) 証明書をコネクタに関連付けます。
        注:
        以前に作成した証明書を再利用する場合は、この手順をスキップできます。
        1. プレイブックの [前提条件 ] ステージで、[ X.509 証明書を作成 ] アクティビティを選択します。
        2. フォームで、フィールドに入力します。
          表 : 1. [X.509 証明書] フォーム
          フィールド 説明
          名前 X.509 証明書の名前。例:SGA-ApigeeX-509Certificate
          キーストアパスワード 前のステップでメモした JKS 証明書にアクセスするためのパスワード。
          簡単な説明 X.509 証明書の説明。
        3. [添付ファイル] セクションで、[ ファイルの追加] を選択します。
        4. 前のステップで作成した JKS 証明書の P12 ファイルを参照して選択します。
        5. [ファイルのアップロード] ダイアログ ボックスで、[ アップロード] を選択します。
        6. [Continue (続行)] を選択します。
    7. 接続の詳細を入力し、Apigee X データをインポートするための API 接続をテストします。
      1. プレイブックの [セットアップ (Setup)] ステージで、[接続を作成してテスト (Create and test connection)] アクティビティを選択します。
      2. フォームで、フィールドに入力します。
        表 : 2. [接続を構成してテスト (Configure and test connection)] フォーム
        フィールド 説明
        接続名 Apigee X接続レコードを識別する名前です。
        サービスアカウントメール 前の手順で説明したように、Apigee Xによる認証に使用されるServiceNowサービスアカウントに関連付けられたメールアドレス。
        X.509 証明書 前のステップで説明した X.509 証明書の名前。
        キーストアパスワード 前のステップで説明した、キーストアに関連付けられたパスワード。
      3. [接続の作成とテスト (Create and test connection)] を選択します。
      4. 接続テストが完了したら、[続行] を選択します。
    8. 接続の構成プロパティを設定します。
      1. プレイブックの [セットアップ (Setup)] ステージで、[構成プロパティを設定 (Set configuration properties)] アクティビティを選択します。
      2. プロパティを入力します。
        表 : 3. サービスグラフ接続のプロパティ
        プロパティ 説明
        Apigee 識別
        組織 ID プロジェクトが属する Apigee X システム内の組織。
        プロジェクト ID 接続がリンクされる Apigee X 環境内のプロジェクト識別子。

        プロジェクト ID が複数ある場合は、カンマで区切ります。
        データ検索構成
        ディスカバリースコープ Apigee X アプリケーションのディスカバリースコープ。使用可能なオプションは、次のとおりです。
        [組織]
        ServiceNow サービスアカウントが Apigee X 組織内のデータにアクセスできる場合は、[組織] を選択します。
        [プロジェクト]
        ServiceNow サービスアカウントが Apigee X プロジェクト内のデータにのみアクセスできる場合は、[プロジェクト] を選択します。
        環境を含める Apigee X 接続に含める環境。

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

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

        複数のメソッドを指定する場合は、カンマで区切ります。リストされているすべてのメソッドがルート処理で考慮されます。
        パフォーマンス構成
        ページサイズ ページあたりのレコードの数。デフォルトは 100、最小値は 2 です。
        パーティションサイズ (バイト単位) 並列ロードが有効になっている場合の Apigee X マネージド API のパーティションサイズ。

        0 より大きい数値を受け入れます。空のままにすると、値が自動的に計算されます。
      3. [Continue (続行)] を選択します。
    9. 定期的にデータをインポートするようにインポートスケジュールを構成します。
      1. プレイブックの [セットアップ (Setup)] ステージで、[インポートスケジュールの構成 (Configure import schedule)] アクティビティを選択します。
      2. [インポートスケジュールの構成 (Configure import schedule)] を選択します。
      3. [ インポートスケジュールの構成 (Configure import schedule )] ダイアログボックスの [ 名前 ] フィールドに、 組織の インポートスケジュールを入力します。
      4. [アクティブ] チェックボックスをオンにして、実行スケジュールと時間の詳細を入力します。

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

      5. [Save (保存)] を選択します。
      6. [ インポートスケジュールを構成 ] アクティビティで、[ 続行] を選択します。
    10. プレイブックの [セットアップ ] ステージで、[ 接続の作成を確認 ] アクティビティを選択して、接続が作成されたかどうかを確認します。

    次のタスク

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