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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：7分

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

    始める前に

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

    必要なロール：admin

    このタスクについて

    オンボーディングコネクタのプレイブックエクスペリエンスは、CMDB ワークスペースの 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 接続から除外する必要がある環境。

        複数の環境の場合は、カンマで区切ります。Exclude Environments プロパティにリストされているものを除くすべてのゲートウェイがフェッチされます。

        このフィールドを空のままにすると、コネクタ内のデータソースはすべての環境からデータをインポートします。
        収集期間 (日数) API 使用状況データを収集する期間 (日数)。
        使用状況データを収集 使用状況データ収集を有効にして、指定した期間の API 使用状況データを取得するオプション。
        パフォーマンス構成
        ページサイズ ページあたりのレコードの数。デフォルトは 100、最小値は 2 です。
        パーティションサイズ (バイト単位) 並列ロードが有効になっている場合の Apigee X マネージド API のパーティションサイズ。

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

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

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

    次のタスク

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