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

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

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

    始める前に

    ServiceNow Store から Kong Konnect の 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. [接続を作成] ウィンドウで、Kong Konnect コネクタタイプを選択し、[接続を作成] を選択します。
    5. コネクタを使用して初めて接続を設定するための最初の前提条件を満たします。
      注:
      この手順は、初回セットアップ時にのみ必要です。「SGC セントラルで接続を作成するときの初期セットアップタスクの実行」を参照してください。
    6. 接続の詳細を入力し、Kong Konnect データをインポートするための API 接続をテストします。
      1. プレイブックの [セットアップ (Setup)] ステージで、[接続を作成してテスト (Create and test connection)] アクティビティを選択します。
      2. フォームのフィールドに入力します。
        表 : 2. [接続を作成してテスト (Create and test connection)] フォーム
        フィールド 説明
        接続名 Kong Konnect接続レコードを識別する名前です。

        たとえば、 Kong Konnect 接続などです。
        個人アクセストークン ID を安全に認証し、API を介して Kong Konnect アカウントへのアクセスを許可するために使用されるトークン
      3. [接続の作成とテスト (Create and test connection)] を選択します。
      4. 接続テストが完了したら、[続行] を選択します。
    7. 接続の構成プロパティを設定します。
      1. プレイブックの [セットアップ (Setup)] ステージで、[構成プロパティを設定 (Set configuration properties)] アクティビティを選択します。
      2. プロパティの詳細を入力します。
        表 : 3. Kong Konnectの構成プロパティ
        プロパティ 説明
        データ検索構成
        ゲートウェイグループ ID 自己管理コントロールプレーンで構成されるコントロールプレーングループを表す Kong Konnect ゲートウェイに関連付けられたグループID。
        ID が複数ある場合は、カンマで区切ります。
        注:
        ゲートウェイグループ ID プロパティは、指定されている場合に使用され、ゲートウェイ ID を上書きします。
        ゲートウェイ ID コントロールプレーンを表す個々の Kong Konnect ゲートウェイの ID。
        ID が複数ある場合は、カンマで区切ります。
        注:
        ゲートウェイグループ ID が指定されている場合、 ゲートウェイ ID プロパティ値は無視されます。
        地域 Kong Konnectゲートウェイが存在するカンマ区切りリージョンのリスト。
        HTTP メソッドタイプを展開 ルートについて考慮する GET、POST、PUT、PATCH、DELETE、OPTIONS、HEAD、CONNECT、TRACE などの HTTP メソッド。

        メソッドが複数ある場合は、カンマで区切ります。空白のままにすると、すべての標準 HTTP メソッドをサポートしていることを示す ALL メソッドで単一の API フロントエンドが作成されます。
        使用状況データを収集 (Collect usage data) 指定した期間の API 使用状況データを取得するには、使用状況データ収集を有効にします。
        収集期間の期間 API 使用状況データを収集する期間。

        有効な値は次のとおりです。

        • 15 分 (過去 15 分)
        • 1 時間 (過去 1 時間)
        • 6 時間 (過去 6 時間)
        • 12 時間 (過去 12 時間)
        • 24 時間 (過去 24 時間)
        • 7 日間 (過去 7 日間)
        • 30 日間 (過去 30 日間)
        • current_week (現在の週)
        • previous_week (前週)
        • current_month (現在の月)
        • previous_month (前月)
        パフォーマンス構成 (Performance configuration)
        ページサイズ ページあたりのレコード数。デフォルトは 100 です。
        パーティションサイズ (バイト単位) 並列ロードが有効になっている場合の Kong Konnect マネージド API のパーティションサイズ。

        0 より大きい数値を受け入れます。空のままにすると、値が自動的に計算されます。

        注:
        並列ロードは、次のデータソースでのみ使用できます。
        • ルーティング
        • ターゲット
        タグ設定
        タグのインポート Kong Konnectゲートウェイからタグを取り込むオプション。
        タグ値セパレーター タグのキーと値のセパレーター。
      3. [続行] を選択します。
    8. 定期的にデータをインポートするようにインポートスケジュールを構成します。
      1. プレイブックの [セットアップ] ステージで、[インポートスケジュールの構成] アクティビティを選択します。
      2. [スケジュール済みインポート] リスト内の [スケジュール設定済み親データインポート] を展開して、接続に関連付けられている Gateway インポートスケジュールを選択します。
        注:
        接続名には、スケジュール名のプリフィックスが付きます。
      3. [インポートスケジュールの構成] ダイアログボックスで、[アクティブ] チェックボックスをオンにして、実行スケジュールと時間の詳細を入力します。

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

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

    次のタスク

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

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